Console do Mac: reduzir o registo a uma só tentativa de VPN

A VPN falha, alguém diz para ver a Console, e abre-se uma janela que despeja milhares de linhas por segundo. A maior parte não tem nada a ver com o túnel. A competência útil é restringir a vista a uma tentativa e a um processo antes de ler o que quer que seja.

Três passos bastam para a maioria das investigações de VPN no Mac.

Faça uma tentativa que consiga reconhecer

Anote a hora local e o fuso horário e depois ligue-se uma vez. Anote o texto exato do erro que o cliente mostrou, porque costuma ser mais específico do que qualquer linha do registo. Agora tem uma janela de alguns segundos e um termo de pesquisa. Tudo o que é anterior a essa janela é história de que não precisa.

Uma tentativa que não consegue datar é uma tentativa que não consegue filtrar.

Filtre por processo antes de filtrar por texto

O campo de pesquisa da Console aceita predicados de processo e de mensagem, e o equivalente em linha de comandos é mais reproduzível. log show --last 5m --predicate 'process == "NEIKEv2Provider"' restringe a um só fornecedor. O nome exato do processo varia conforme o tipo de ligação, por isso encontre-o durante a primeira tentativa sem filtro.

Filtrar primeiro por texto devolve todos os subsistemas que registaram a palavra VPN por acaso.

Um predicado também pode filtrar por subsistema e categoria, o que muitas vezes é mais preciso do que um nome de processo. O registo unificado permite que uma biblioteca declare um subsistema, e os componentes de rede da Apple usam vários. Comece pelo processo e depois acrescente --info se o nível predefinido esconder o evento que espera. As mensagens de nível de depuração exigem normalmente um perfil de configuração, que não vale a pena instalar só para ler um registo.

Leia a sequência, não a última linha

A mensagem final de desligação é a linha menos informativa do ficheiro. Procure mais atrás o primeiro erro de adaptador, a falha de verificação ou a rejeição de configuração. Esses nomeiam a etapa que falhou, enquanto a desligação só diz que a etapa não foi recuperada. Preserve a ordem dos eventos quando os copia, porque a sequência é o diagnóstico.

O arranque de um serviço local não é um handshake remoto bem-sucedido, e o registo não vai fingir o contrário.

O que a redação esconde e porquê

O registo unificado esconde alguns valores atrás de um marcador privado por predefinição, e é por isso que um campo útil pode parecer vazio. É uma decisão de conceção sobre o que pode ser recolhido, não um erro. Não altere definições de privacidade abrangentes só para obter mais texto.

Se o valor de que precisa estiver redigido, procure-o no registo ou na configuração da própria aplicação.

Exporte um excerto revisto

Exporte apenas a janela que reviu. Caminhos, nomes de utilizador, nomes de anfitrião internos e endereços de ponto final aparecem em linhas normais do registo, e uma exportação de todo o sistema leva-os todos a quem a receber.

Guarde a captura intacta e também o excerto. Se alguém contestar a cronologia mais tarde, só o original o resolve. O excerto é para o ticket, e o original para a discussão.

Nomeie a etapa explicitamente no ticket: adaptador, verificação ou encaminhamento. Isso mantém as provas interpretáveis em vez de as transformar num pacote que ninguém consegue ler. O manual do utilizador da Console da Apple abrange os controlos de recolha e pesquisa aqui referidos.