Consola del Mac: reduzca el registro a un solo intento de VPN

La VPN falla, alguien dice que revises la Consola y abres una ventana que vierte miles de líneas por segundo. La mayor parte no tiene nada que ver con el túnel. La habilidad útil es reducir la vista a un solo intento y un solo proceso antes de leer nada.

Tres pasos bastan para la mayoría de las investigaciones de VPN en Mac.

Haga un intento que pueda reconocer

Anote la hora local y la zona horaria, y luego conéctese una vez. Anote el texto exacto del error que mostró el cliente, porque suele ser más específico que cualquier línea del registro. Ahora tiene una ventana de unos segundos y un término de búsqueda. Todo lo anterior a esa ventana es historia que no necesita.

Un intento que no puede fechar es un intento que no puede filtrar.

Filtre por proceso antes de filtrar por texto

El campo de búsqueda de la Consola acepta predicados de proceso y de mensaje, y el equivalente en línea de comandos es más reproducible. log show --last 5m --predicate 'process == "NEIKEv2Provider"' lo reduce a un solo proveedor. El nombre exacto del proceso varía según el tipo de conexión, así que encuéntrelo durante el primer intento sin filtrar.

Filtrar primero por texto devuelve todos los subsistemas que registraron la palabra VPN por casualidad.

Un predicado también puede filtrar por subsistema y categoría, lo que a menudo es más preciso que un nombre de proceso. El registro unificado permite que una biblioteca declare un subsistema, y los componentes de red de Apple usan varios. Empiece por el proceso y luego añada --info si el nivel predeterminado oculta el evento que espera. Los mensajes de nivel de depuración suelen necesitar un perfil de configuración, que no vale la pena instalar solo para leer un registro.

Lea la secuencia, no la última línea

El mensaje final de desconexión es la línea menos informativa del archivo. Busque antes el primer error de adaptador, el fallo de verificación o el rechazo de configuración. Esos nombran la etapa que falló, mientras que la desconexión solo dice que la etapa no se recuperó. Conserve el orden de los eventos cuando los copie, porque la secuencia es el diagnóstico.

Que un servicio local arranque no es un handshake remoto correcto, y el registro no pretenderá lo contrario.

Qué oculta la redacción y por qué

El registro unificado oculta algunos valores tras un marcador privado de forma predeterminada, y por eso un campo útil puede parecer vacío. Es una decisión de diseño sobre qué se puede recopilar, no un error. No cambie ajustes amplios de privacidad solo para obtener más texto.

Si el valor que necesita está redactado, búsquelo en el registro o la configuración de la propia aplicación.

Exporte un fragmento revisado

Exporte solo la ventana que revisó. Las rutas, los nombres de usuario, los nombres de host internos y las direcciones de extremo aparecen en líneas normales del registro, y una exportación de todo el sistema los lleva todos a quien la reciba.

Guarde la captura intacta y también el fragmento. Si alguien discute la cronología más adelante, solo el original lo zanja. El fragmento es para el tique, y el original para la discusión.

Nombre la etapa explícitamente en el tique: adaptador, verificación o enrutamiento. Eso mantiene interpretables las pruebas en lugar de convertirlas en un paquete que nadie puede leer. La guía de usuario de la Consola de Apple cubre los controles de recopilación y búsqueda mencionados aquí.