Consola do Mac: reduza o rexistro a un só intento de VPN

A VPN falla, alguén di que comprobes a Consola e abres unha ventá que verte mille liñas por segundo. A maior parte non ten nada que ver co túnel. A habilidade útil é reducir a vista a un só intento e un só proceso antes de ler nada.

Tres pasos abondan para a maioría das investigacións de VPN no Mac.

Fai un intento que poidas recoñecer

Anota a hora local e a zona horaria e logo conéctate unha vez. Anota o texto exacto do erro que mostrou o cliente, porque adoita ser máis específico que calquera liña do rexistro. Agora tes unha ventá de poucos segundos e un termo de busca. Todo o anterior a esa ventá é historia que non necesitas.

Un intento que non podes datar é un intento que non podes filtrar.

Filtra por proceso antes de filtrar por texto

O campo de busca da Consola acepta predicados de proceso e de mensaxe, e o equivalente en liña de ordes é máis reproducible. log show --last 5m --predicate 'process == "NEIKEv2Provider"' redúceo a un só provedor. O nome exacto do proceso varía segundo o tipo de conexión, así que atopao durante o primeiro intento sen filtrar.

Filtrar primeiro por texto devolve todos os subsistemas que rexistraron a palabra VPN por casualidade.

Un predicado tamén pode filtrar por subsistema e categoría, o que a miúdo é máis preciso que un nome de proceso. O rexistro unificado permite que unha biblioteca declare un subsistema, e os compoñentes de rede de Apple usan varios. Comeza polo proceso e logo engade --info se o nivel predeterminado agocha o evento que esperas. As mensaxes de nivel de depuración adoitan necesitar un perfil de configuración, que non paga a pena instalar só para ler un rexistro.

Le a secuencia, non a última liña

A mensaxe final de desconexión é a liña menos informativa do ficheiro. Busca antes o primeiro erro de adaptador, o fallo de verificación ou o rexeitamento de configuración. Eses nomean a etapa que fallou, mentres que a desconexión só di que a etapa non se recuperou. Conserva a orde dos eventos cando os copies, porque a secuencia é o diagnóstico.

Que un servizo local arrinque non é un apretón de mans remoto correcto, e o rexistro non pretenderá o contrario.

Que agocha a redacción e por que

O rexistro unificado agocha algúns valores tras un marcador privado de forma predeterminada, e por iso un campo útil pode parecer baleiro. É unha decisión de deseño sobre que se pode recoller, non un erro. Non cambies axustes amplos de privacidade só para obter máis texto.

Se o valor que necesitas está redactado, búscao no rexistro ou na configuración da propia aplicación.

Exporta un fragmento revisado

Exporta só a ventá que revisaches. As rutas, os nomes de usuario, os nomes de host internos e os enderezos de punto final aparecen en liñas normais do rexistro, e unha exportación de todo o sistema lévaos todos a quen a reciba.

Garda a captura intacta e tamén o fragmento. Se alguén discute a cronoloxía máis adiante, só o orixinal o resolve. O fragmento é para o tícket, e o orixinal para a discusión.

Nomea a etapa explicitamente no tícket: adaptador, verificación ou encamiñamento. Iso mantén as probas interpretables en lugar de convertelas nun paquete que ninguén pode ler. A guía de usuario da Consola de Apple cobre os controis de recollida e busca mencionados aquí.