Mac-Konsole: das Protokoll auf einen VPN-Versuch eingrenzen

Das VPN scheitert, jemand sagt, du sollst die Konsole prüfen, und man öffnet ein Fenster, das Tausende Zeilen pro Sekunde ausspuckt. Das meiste davon hat nichts mit dem Tunnel zu tun. Die nützliche Fertigkeit besteht darin, die Ansicht auf einen Versuch und einen Prozess zu verengen, bevor man irgendetwas liest.

Drei Schritte reichen für die meisten VPN-Untersuchungen auf dem Mac.

Machen Sie einen Versuch, den Sie wiedererkennen

Notieren Sie die lokale Uhrzeit und Zeitzone und verbinden Sie sich dann einmal. Notieren Sie den genauen Text des Fehlers, den der Client angezeigt hat, denn er ist meist konkreter als jede Protokollzeile. Jetzt haben Sie ein Fenster von wenigen Sekunden und einen Suchbegriff. Alles vor diesem Fenster ist Geschichte, die Sie nicht brauchen.

Ein Versuch ohne Zeitstempel ist ein Versuch, den man nicht filtern kann.

Erst nach Prozess filtern, dann nach Text

Das Suchfeld der Konsole akzeptiert Prozess- und Nachrichtenprädikate, und das Kommandozeilenäquivalent ist reproduzierbarer. log show --last 5m --predicate 'process == "NEIKEv2Provider"' grenzt auf einen Anbieter ein. Der genaue Prozessname hängt vom Verbindungstyp ab, also finden Sie ihn beim ersten ungefilterten Versuch.

Wer zuerst nach Text filtert, bekommt jedes Subsystem, das zufällig das Wort VPN protokolliert hat.

Ein Prädikat kann auch nach Subsystem und Kategorie filtern, was oft enger ist als ein Prozessname. Einheitliche Protokollierung erlaubt einer Bibliothek, ein Subsystem zu deklarieren, und Apples Netzwerkkomponenten nutzen mehrere davon. Beginnen Sie mit dem Prozess und fügen Sie dann --info hinzu, wenn die Standardstufe das erwartete Ereignis verbirgt. Meldungen der Debug-Stufe brauchen meist ein Konfigurationsprofil, das man nicht nur zum Lesen eines Protokolls installieren sollte.

Lesen Sie die Abfolge, nicht die letzte Zeile

Die abschließende Trennungsmeldung ist die am wenigsten informative Zeile der Datei. Suchen Sie früher nach dem ersten Adapterfehler, dem Verifizierungsfehler oder der Konfigurationsablehnung. Diese benennen die Stufe, die fehlgeschlagen ist, während die Trennung nur sagt, dass die Stufe nicht wiederhergestellt wurde. Bewahren Sie die Reihenfolge der Ereignisse beim Kopieren, denn die Abfolge ist die Diagnose.

Ein startender lokaler Dienst ist kein erfolgreicher entfernter Handshake, und das Protokoll wird nichts anderes behaupten.

Was die Schwärzung verbirgt und warum

Einheitliche Protokollierung verbirgt manche Werte standardmäßig hinter einer privaten Markierung, weshalb ein hilfreiches Feld leer aussehen kann. Das ist eine Designentscheidung darüber, was erfasst werden darf, kein Fehler. Schalten Sie keine umfassenden Datenschutzeinstellungen um, nur um mehr Text zu bekommen.

Wenn der benötigte Wert geschwärzt ist, suchen Sie ihn stattdessen im eigenen Protokoll oder in der Konfiguration der Anwendung.

Exportieren Sie einen geprüften Auszug

Exportieren Sie nur das Fenster, das Sie geprüft haben. Pfade, Benutzernamen, interne Hostnamen und Endpunktadressen erscheinen in gewöhnlichen Protokollzeilen, und ein Export des gesamten Systems trägt sie alle zu dem, der ihn erhält.

Bewahren Sie sowohl die unberührte Aufzeichnung als auch den Auszug auf. Wenn jemand später die Zeitachse bestreitet, ist das Original das Einzige, was das klärt. Der Auszug ist fürs Ticket, das Original für die Diskussion.

Benennen Sie die Stufe im Ticket ausdrücklich: Adapter, Verifizierung oder Routing. Das hält die Belege interpretierbar, statt sie zu einem Bündel zu machen, das niemand lesen kann. Apples Benutzerhandbuch zur Konsole behandelt die hier erwähnten Erfassungs- und Suchsteuerungen.