Inleiding
Dit document beschrijft de nieuwe Unified logging enhancement voor een naadloze ervaring om Tracelogs van het systeem te verzamelen en te beheren.
Overzicht
Praktische doeleinden:
- Probleemoplossing. Wanneer een chassis een probleem tegenkomt, kunnen de gegevens binnen sporenbestanden van onschatbare waarde zijn voor het identificeren en oplossen van het probleem.
- Debuggen. De uitgangen van sporenbestanden kunnen gebruikers een meer granulair perspectief bieden op de acties en bewerkingen van het systeem.
Hoe ze werken
- De traceerfunctie registreert de details van interne gebeurtenissen die binnen het chassis plaatsvinden. Periodiek, vinden de dossiers die de volledige spooroutput voor een module bevatten worden geproduceerd en verfrist, en deze dossiers worden gehouden in de tracelog folder.
- U kunt ruimte vrijmaken op het bestandssysteem. Trace-bestanden kunnen uit deze map worden verwijderd zonder de prestaties van het apparaat te beïnvloeden.
- U kunt de overtrek logboeken naar alternatieve plaatsen overbrengen. U kunt FTP, TFTP, enzovoort gebruiken om de bestanden te kopiëren om ze te analyseren of om ze te uploaden naar een case die geopend is met Technical Assistance Center (TAC).
- U kunt overtrek logboeken niet onbruikbaar maken maar u kunt het spoorniveau veranderen om te bepalen hoeveel informatie u voor elke module wilt verzamelen.
Niveaus overtrekken
De niveaus van het spoor dicteren het volume van informatie die in de spoorbuffer of het dossier wordt behouden. Alle beschikbare overtrekniveaus zijn de volgende en verklaren de soorten berichten die op elk niveau worden vastgelegd.
Noodgeval—> Systeem is instabiel/onbruikbaar.
Fout—> Een gebeurtenis die leidt tot een klein verlies van functionaliteit zonder automatische resolutie, wat een onverwacht probleem vertegenwoordigt dat geen gevolgen kan hebben voor de bedrijfsvoering direct, maar wel voor de toekomst.
Waarschuwing—> Een probleem dat mogelijk automatisch kan worden opgelost, of een aandoening die kan leiden tot een verlies van functionaliteit als niet direct wordt onderzocht en aangepakt.
Opmerking—> Het standaard logniveau voor modules. Dit niveau geeft belangrijke gebeurtenissen weer die binnen het systeem plaatsvinden.
Info—> Alleen informatieve berichten. Biedt aanvullende informatie over belangrijke gebeurtenissen die relevant zijn voor het systeem of de functies ervan.
Debug—> Biedt debuggging logs.
Veelzijdig—> Biedt tweede niveau van debugging logboeken.
Ruis—> Er worden maximaal mogelijke berichten vastgelegd.
Huidige overtrek-niveaus bekijken
U kunt het spoorniveau van om het even welke module met het bevel zien en veranderen toont het niveau van het platformsoftwarespoor.
Deze opdracht toont het Overtrekniveau van het doorsturen van beheerprocessen op de actieve RP.
Router#show platform softwarerelease voor doorsturen-manager rp actief
Dit is de uitvoer:
Module Name Trace Level -----------------------------------------------acl Notice active-identity Notice alg Notice appnav-controller Notice aps Notice bcrpgc Informational bfd Notice bier Notice <SNIP>
Overtrek wijzigen
U kunt een spoorniveau voor een specifieke module of alle modules in een proces wijzigen. Om dat te doen kunt u het bevel vastgestelde spoor van de platformsoftware gebruiken.
Deze opdracht set platform software trace chassis-manager f0 cman_fp waarschuwing verandert het traceerniveau voor cman_fp in de chassisbeheerder van de ESP in sleuf 0 naar het waarschuwingsniveau.
U kunt de verandering met deze opdracht valideren toont platform software spoor niveau chassis-manager f0
Dit is de uitvoer:
Module Name Trace Level -----------------------------------------------bcrpgc Informational bipc Notice bsignal Notice btrace Notice btrace_ra Notice cdllib Notice chasfs Notice cman_fp Warning
Nieuwe overtrek-opties
Met ingang van 16.8 introduceert Cisco de verbetering in Unified Logging. Het doel is om een naadloze logboekervaring voor de gebruiker tussen de IOS logboeksystemen en andere systemen van procesvastlegging te creëren. Logbestanden van beide systemen kunnen worden samengevoegd en op tijd worden weergegeven, dit maakt het makkelijker voor u om problemen in het systeem op te lossen.
De tracelogen voor verschillende processen weergeven
Het bevel toont het registrerenproces kan worden gebruikt om de inhoud van de tracelogs te tonen die door de gespecificeerde processen worden geproduceerd. Logbestanden uit de buffers- en tracelogs-directory kunnen worden opgenomen in de output.
Er is ook ondersteuning voor gedeeltelijke procesnaam de procesnaam wordt geaccepteerd als een woord door de parser.
Opmerking: De procesnaam moet (gedeeltelijk of volledig) overeenkomen met de naam van het tracelog, anders kan een mismatch optreden waardoor er geen sporen worden weergegeven.
De opdracht toont registratieproces fman kan de fman-rp en fman-fp logboeken combineren.
Router#show logging process fman Displaying logs from the last 0 days, 0 hours, 10 minutes, 0 secondsexecuting cmd on chassis local ...Unified Decoder Library Init .. DONEFound 1 UTF Streams<snip>2024/05/22 19:01:01.347466887 {fman_rp_R0-0}{255}: [source] [11941]: (ERR): ipc(mqipc/iosd/iosd-fman):Unable to open config channel to source2024/05/22 19:00:50.246774567 {fman_fp_image_F0-0}{255}: [btrace] [13616]: (note): Btrace started for process fman_fp_image_pman ID 13616 with 512 modules2024/05/22 19:00:50.246777079 {fman_fp_image_F0-0}{255}: [btrace] [13616]: (note): File size max used for rotation of tracelogs: 8192
Ondersteuning van meerdere processen uitvoeren
Met de CLI-opdracht "show logging process" kunt u nu meerdere procesnamen opgeven, gescheiden door komma's, met behulp van het sleutelwoord 'process'. Samengevoegd tracelog tonen logboeken alleen van de gespecificeerde processen, zoals sman en ios processen.
Router#show logging process sman,iosexecuting cmd on chassis 1 ...Collecting files on current[1] chassis.
Tijdvensteropties
Alle sporen kunnen tijdstempels in een lokale tijdzone hebben als er een tijdzone is geconfigureerd. Zo niet, wordt timestamps gebruikt in "Coordinated Universal Time" (UTC), maar u kunt een switch maken van de tijdzone voor de logbestanden tussen Local en UTC met de opdrachtset logtijdzone <local | UTC>.
De opdracht toont vastlegging CLI toont alleen de laatste 10 minuten van logbestanden van de huidige tijd standaard.
Het laatste trefwoord start kan worden gebruikt om het tijdvenster uit te vouwen op basis van individuele behoeften.
Router#show logging process btman start last ? <0-4294967295> interval (default seconds) boot system boot time clear display all logs since last "clear logging" marker selects latest matching marker from list to start displaying logs from
Opmerking: als u een numerieke waarde kiest uit de vorige opdracht, kunt u als volgende optie dagen, uren, minuten of seconden opgeven.
De opties voor het laatste trefwoord zijn toegevoegd en moeten worden gebruikt in combinatie met de optie Laatst starten om het einde van het tijdvenster te specificeren. Wanneer zowel de laatste start als de laatste opties worden gebruikt, worden alleen logs binnen het venster verzameld. Zonder de laatste optie van het eind, blijft de logboekinzameling aan de huidige tijd als eindtijd in gebreke.
In dit voorbeeld wordt een venster ingesteld tussen de laatste twee uur en het laatste uur:
Router#show logging process btman start last 2 hours end last 1 hoursDisplaying logs from the last 0 days, 2 hours, 0 minutes, 0 secondsEnd time set to show logs before last 0 days, 1 hours, 0 minutes, 0 secondsexecuting cmd on chassis 1 ...Collecting files on current[1] chassis.
Logbestanden onder specifiek logniveau weergeven
U kunt logbestanden alleen tonen voor een bepaald niveau:
Router#show logging process wncd level ? debug Debug messages error Error messages info Informational messages notice Notice messages verbose Verbose debug messages warning Warning messages
Dit is een voorbeeld van de logbestanden btman onder foutniveau notice:
Router#show logging process btman level notice Logging display requested on 2024/07/24 06:20:23 (UTC) for Hostname: [Router], Model: [ASR1002-HX ], Version: [17.12.03a], SN: [JAD22460SN9], MD_SN: [FXS2223Q74M]Displaying logs from the last 0 days, 0 hours, 10 minutes, 0 secondsexecuting cmd on chassis local ...Unified Decoder Library Init .. DONEFound 1 UTF Streams2024/07/24 06:10:59.533374335 {btman_R0-0}{255}: [utm_main] [5809]: (note): Inserted UTF(2) HT(old):droputil_R0-0[13] lnode /tmp/rp/trace/droputil_R0-0.6823_63.20240724061059.bin PID:68232024/07/24 06:10:59.695395289 {btman_R0-0}{255}: [utm_wq] [5809:15578]: (note): Inline sync, enqueue BTF message flags:0x1, PID:15578 BTF:/tmp/rp/trace/droputil_R0-0.6823_62.20240724060959.bin
Logbestanden weergeven vanaf tijdstempel
U kunt logboeken van specifieke tijdstempel in UTC zoals dit "2017/02/10 14:41:50.849425" tonen Dit is een voorbeeld:
Router#show logging process wncd start timestamp "2024/07/24 05:36:45.849425"Logging display requested on 2024/07/24 06:39:15 (UTC) for Hostname: [Router], Model: [ASR1002-HX ], Version: [17.12.03a], SN: [JAD22460SN9], MD_SN: [FXS2223Q74M]executing cmd on chassis local ...Unified Decoder Library Init .. DONEFound 1 UTF StreamsFilter policy: Done with UTM processing
Logbestanden tussen twee tijdstempels weergeven
U kunt overtrekken tussen een tijdvenster weergeven door tijdstempel en tijdstempel voor het begin toe te voegen. Dit is een voorbeeld met een onderhoudsvenster van 1 uur:
Router#show logging process wncd start timestamp "2024/07/24 05:36:45.849425" end timestamp "2024/07/24 06:36:45.849425"Logging display requested on 2024/07/24 06:39:15 (UTC) for Hostname: [Router], Model: [ASR1002-HX ], Version: [17.12.03a], SN: [JAD22460SN9], MD_SN: [FXS2223Q74M]executing cmd on chassis local ...Unified Decoder Library Init .. DONEFound 1 UTF StreamsFilter policy: Done with UTM processing
Live-vastlegging uitvoeren
U kunt de logbestanden die in real-time worden gegenereerd voor een proces of profiel controleren. Logbestanden worden weergegeven terwijl ze worden gegenereerd.
Router#monitor logging process cman ? <0-25> instance number filter specify filter for logs internal select all logs. (Without the internal keyword only customer curated logs are displayed) level select logs above specific level metadata CLI to display metadata for every log message module select logs for specific modules <cr> <cr>
Tip: om te ontsnappen aan, of uit te gaan, geeft de live logging mode een CTRL-C uit.
Vooraf gedefinieerde logprofielen gebruiken
Live logging biedt ingebouwde profielen die eenvoudig kunnen worden toegepast. Dit elimineert de noodzaak voor de gebruiker om bekend te zijn met de onderliggende proceslogbestanden die de functie vormen. De ondersteunde profielen zijn alle, bestand, draadloos, sdwan, netconf-yang, restconf, install, hardware-diagnostics.
Het profiel kan worden gebruikt om met show logging of de monitor logging opdracht.
Opmerking: de optie logbestanden met logboekregistratie tonen alleen logbestanden uit de buffer en bevat geen logbestanden uit de map tracelogs.
SCP_Test#show logging profile ? all all processes file show logs for specific profile file hardware-diagnostics hardware diagnostics specific processes install Install specific processes netconf-yang netconf-yang specific processes restconf restconf specific processes sdwan SDWAN specific processes wireless Wireless specific processes
Router#monitor logging profile ? all all processes file show logs for specific profile file hardware-diagnostics hardware diagnostics specific processes install Install specific processes netconf-yang netconf-yang specific processes restconf restconf specific processes sdwan SDWAN specific processes wireless Wireless specific processes
In 17.12+ zijn de stats standaard opgenomen aan het einde van "show logging <proces/profile/file> ..". Stats toont het aantal gedecodeerde oversporingsberichten op elk ernstniveau werden toegevoegd aan de bestaande decoderstatus. De niveautellingen zijn voor slechts teruggegeven sporen.
2024/07/24 04:26:41.710239127 {btman_R0-0}{255}: [utm_wq] [5806:15568]: (note): Inline sync, enqueue BTF message flags:0x1, PID:15568 BTF:/tmp/rp/trace/IOSRP_R0-0.3437_2.20240724042222.bin2024/07/24 04:26:41.759114843 {btman_R0-0}{255}: [utm_wq] [5806]: (note): utm delete /tmp/rp/trace/IOSRP_R0-0.3437_2.20240724042222.bin================================================================== Unified Trace Decoder Information/Statistics =================================================================----------------- Decoder Input Information ---------------=========================================================== Num of Unique Streams .. 1 Total UTF To Process ... 1 Total UTM To Process ... 89177 UTM Process Filter ..... btman MRST Filter Rules ...... 1===========================================================----------------- Decoder Output Information --------------=========================================================== First UTM TimeStamp ............... 2024/07/24 02:51:45.623542304 Last UTM TimeStamp ................ 2024/07/24 04:26:48.710794233 UTM [Skipped / Rendered / Total] .. 89047 / 130 / 89177 UTM [ENCODED] ..................... 130 UTM [PLAIN TEXT] .................. 0 UTM [DYN LIB] ..................... 0 UTM [MODULE ID] ................... 0 UTM [TDL TAN] ..................... 0 UTM [APP CONTEXT] ................. 0 UTM [MARKER] ...................... 0 UTM [PCAP] ........................ 0 UTM [LUID NOT FOUND] .............. 0 UTM Level [EMERGENCY / ALERT / CRITICAL / ERROR] .. 0 / 0 / 0 / 0 UTM Level [WARNING / NOTICE / INFO / DEBUG] ....... 0 / 130 / 0 / 0 UTM Level [VERBOSE / NOISE / INVALID] ............. 0 / 0 / 0===========================================================
Loguitgangen naar een bestand verzenden
U kunt tofile sleutelwoord gebruiken om een bestand te maken met de uitgangen van de opdracht tonen vastlegging. Dit voorbeeld laat zien hoe u de overtrek logs van het proces btman naar een bestand met de naam btman_log.txt in het bootflash bestandssysteem kunt verzenden:
Router#show logging process btman to-file bootflash:btman_log.txtLogging display requested on 2024/07/25 03:49:41 (UTC) for Hostname: [Router], Model: [ASR1006-X ], Version: [17.09.05a], SN: [FXS221200GH], MD_SN: [FXS2221Q0EL]Displaying logs from the last 0 days, 0 hours, 10 minutes, 0 secondsexecuting cmd on chassis local ...Files being merged in the background, please check [/bootflash/btman_log.txt] output fileUnified Decoder Library Init .. DONEunified trace decoder estimates: [1] number of files, [139913] number of messages that may be processed. Use CTRL+SHIFT+6 to break.Found 1 UTF Streams 2024-07-25 03:49:41.694987 - unified trace decoder estimate: processed 5% 2024-07-25 03:49:41.701433 - unified trace decoder estimate: processed 10% 2024-07-25 03:49:41.707803 - unified trace decoder estimate: processed 15% 2024-07-25 03:49:41.714185 - unified trace decoder estimate: processed 20% 2024-07-25 03:49:41.720592 - unified trace decoder estimate: processed 25% 2024-07-25 03:49:41.726951 - unified trace decoder estimate: processed 30% 2024-07-25 03:49:41.733306 - unified trace decoder estimate: processed 35% 2024-07-25 03:49:41.739734 - unified trace decoder estimate: processed 40% 2024-07-25 03:49:41.746114 - unified trace decoder estimate: processed 45% 2024-07-25 03:49:41.752462 - unified trace decoder estimate: processed 50% 2024-07-25 03:49:41.758864 - unified trace decoder estimate: processed 55% 2024-07-25 03:49:41.765225 - unified trace decoder estimate: processed 60% 2024-07-25 03:49:41.771582 - unified trace decoder estimate: processed 65% 2024-07-25 03:49:41.777968 - unified trace decoder estimate: processed 70% 2024-07-25 03:49:41.784330 - unified trace decoder estimate: processed 75% 2024-07-25 03:49:41.790693 - unified trace decoder estimate: processed 80% 2024-07-25 03:49:41.797099 - unified trace decoder estimate: processed 85% 2024-07-25 03:49:41.803462 - unified trace decoder estimate: processed 90% 2024-07-25 03:49:41.811411 - unified trace decoder estimate: processed 95% 2024-07-25 03:49:41.822322 - unified trace decoder estimate: processed 100% 2024-07-25 03:49:41.822335 - unified trace decoder : processing complete Result:[Success]
U kunt bevestigen dat het bestand is gemaakt met de opdracht dir bootflash en het filteren van de naam van het bestand als dit:
Router#dir bootflash: | include btman_log.txt17 -rw- 26939 Jul 25 2024 03:49:41 +00:00 btman_log.txt