Mac-console: beperk het logboek tot één VPN-poging

De VPN faalt, iemand zegt: kijk in Console, en je opent een venster dat duizenden regels per seconde uitstroomt. Het meeste heeft niets met de tunnel te maken. De nuttige vaardigheid is de weergave beperken tot één poging en één proces voordat je iets leest.

Drie stappen zijn genoeg voor de meeste VPN-onderzoeken op de Mac.

Doe één poging die je kunt herkennen

Noteer de lokale tijd en tijdzone en maak dan één keer verbinding. Noteer de exacte tekst van de fout die de client toonde, want die is meestal specifieker dan welke logregel ook. Nu heb je een venster van een paar seconden en een zoekterm. Alles vóór dat venster is geschiedenis die je niet nodig hebt.

Een poging die je niet kunt tijdstempelen, is een poging die je niet kunt filteren.

Filter op proces voordat je op tekst filtert

Het zoekveld van Console accepteert proces- en berichtpredicaten, en het equivalent op de opdrachtregel is reproduceerbaarder. log show --last 5m --predicate 'process == "NEIKEv2Provider"' beperkt tot één provider. De exacte procesnaam verschilt per verbindingstype, dus vind die tijdens de eerste ongefilterde poging.

Eerst op tekst filteren geeft elk subsysteem terug dat toevallig het woord VPN logde.

Een predicaat kan ook op subsysteem en categorie filteren, wat vaak strakker is dan een procesnaam. Uniforme logging laat een bibliotheek een subsysteem declareren, en Apples netwerkcomponenten gebruiken er verschillende van. Begin met het proces en voeg dan --info toe als het standaardniveau de gebeurtenis verbergt die je verwacht. Berichten op debug-niveau vereisen meestal een configuratieprofiel, dat het niet waard is om te installeren om één logboek te lezen.

Lees de volgorde, niet de laatste regel

Het laatste verbrekingsbericht is de minst informatieve regel in het bestand. Zoek eerder naar de eerste adapterfout, verificatiefout of configuratieweigering. Die noemen de fase die faalde, terwijl de verbreking alleen zegt dat de fase niet is hersteld. Bewaar de volgorde van gebeurtenissen wanneer je ze kopieert, want de volgorde is de diagnose.

Dat een lokale dienst start, is geen geslaagde externe handshake, en het logboek zal niet doen alsof.

Wat redactie verbergt en waarom

Uniforme logging verbergt standaard sommige waarden achter een privémarkering, waardoor een nuttig veld leeg kan lijken. Dat is een ontwerpkeuze over wat verzameld mag worden, geen bug. Zet geen brede privacyinstellingen om alleen om meer tekst te krijgen.

Als de waarde die je nodig hebt geredigeerd is, zoek die dan in het eigen logboek of de configuratie van de toepassing.

Exporteer een nagekeken fragment

Exporteer alleen het venster dat je hebt nagekeken. Paden, gebruikersnamen, interne hostnamen en eindpuntadressen staan in gewone logregels, en een export van het hele systeem draagt ze allemaal naar wie hem ontvangt.

Bewaar zowel de onaangeroerde opname als het fragment. Als iemand later de tijdlijn betwist, is het origineel het enige dat het beslecht. Het fragment is voor de ticket, en het origineel voor de discussie.

Noem de fase expliciet in de ticket: adapter, verificatie of routering. Dat houdt het bewijs interpreteerbaar in plaats van er een bundel van te maken die niemand kan lezen. Apples gebruikershandleiding voor Console behandelt de hier genoemde verzamel- en zoekbediening.