Console del Mac: ridurre il log a un solo tentativo VPN

La VPN fallisce, qualcuno dice di controllare la Console e si apre una finestra che riversa migliaia di righe al secondo. La maggior parte non ha niente a che vedere con il tunnel. L’abilità utile è restringere la vista a un solo tentativo e a un solo processo prima di leggere qualsiasi cosa.

Tre passaggi bastano per la maggior parte delle indagini VPN sul Mac.

Fai un tentativo che puoi riconoscere

Annota l’ora locale e il fuso orario, poi connettiti una volta. Annota il testo esatto dell’errore mostrato dal client, perché di solito è più specifico di qualsiasi riga del log. Ora hai una finestra di pochi secondi e un termine di ricerca. Tutto ciò che precede quella finestra è storia di cui non hai bisogno.

Un tentativo che non puoi datare è un tentativo che non puoi filtrare.

Filtra per processo prima di filtrare per testo

Il campo di ricerca della Console accetta predicati di processo e di messaggio, e l’equivalente da riga di comando è più riproducibile. log show --last 5m --predicate 'process == "NEIKEv2Provider"' restringe a un solo fornitore. Il nome esatto del processo varia in base al tipo di connessione, quindi trovalo durante il primo tentativo senza filtri.

Filtrare prima per testo restituisce ogni sottosistema che ha registrato per caso la parola VPN.

Un predicato può filtrare anche per sottosistema e categoria, cosa spesso più precisa di un nome di processo. Il logging unificato consente a una libreria di dichiarare un sottosistema, e i componenti di rete di Apple ne usano diversi. Parti dal processo, poi aggiungi --info se il livello predefinito nasconde l’evento che ti aspetti. I messaggi di livello debug richiedono di solito un profilo di configurazione, che non vale la pena installare solo per leggere un log.

Leggi la sequenza, non l’ultima riga

Il messaggio finale di disconnessione è la riga meno informativa del file. Cerca prima il primo errore di adattatore, il fallimento di verifica o il rifiuto della configurazione. Quelli nominano la fase che ha fallito, mentre la disconnessione dice solo che la fase non è stata ripristinata. Conserva l’ordine degli eventi quando li copi, perché la sequenza è la diagnosi.

L’avvio di un servizio locale non è una stretta di mano remota riuscita, e il log non fingerà il contrario.

Che cosa nasconde la redazione e perché

Il logging unificato nasconde alcuni valori dietro un marcatore privato per impostazione predefinita, ed è per questo che un campo utile può sembrare vuoto. È una scelta di progettazione su ciò che può essere raccolto, non un bug. Non cambiare impostazioni ampie sulla privacy solo per ottenere più testo.

Se il valore che ti serve è redatto, cercalo nel log o nella configurazione dell’applicazione stessa.

Esporta un estratto esaminato

Esporta solo la finestra che hai esaminato. Percorsi, nomi utente, nomi host interni e indirizzi di endpoint compaiono in normali righe di log, e un’esportazione dell’intero sistema li porta tutti a chi la riceve.

Conserva la cattura intatta e anche l’estratto. Se qualcuno contesta la cronologia più tardi, solo l’originale lo risolve. L’estratto è per il ticket, e l’originale per la discussione.

Nomina la fase esplicitamente nel ticket: adattatore, verifica o routing. Così le prove restano interpretabili invece di diventare un pacchetto che nessuno può leggere. La guida utente della Console di Apple copre i controlli di raccolta e ricerca citati qui.