Trace Logs verzamelen en beheren met Unified Logging Enhancement

Inleiding

Dit document beschrijft de nieuwe uniforme logboekverbetering voor een naadloze ervaring om tracelogs van het systeem te verzamelen en te beheren.

Overzicht

Praktische doeleinden:

• Problemen oplossen. Wanneer een chassis een probleem ondervindt, kunnen de gegevens in traceringsbestanden van onschatbare waarde zijn voor het identificeren en oplossen van het probleem.
• Foutopsporing. De uitgangen van traceringsbestanden kunnen gebruikers een meer gedetailleerd perspectief bieden op de acties en bewerkingen van het systeem.

Hoe ze werken

• De traceringsfunctie registreert de details van interne gebeurtenissen die zich in het chassis voordoen. Regelmatig worden traceringsbestanden met de volledige traceringsuitvoer voor een module gegenereerd en vernieuwd en deze bestanden worden in de directory van het tracelog bewaard.
• U kunt ruimte vrijmaken op het bestandssysteem. Trace-bestanden kunnen uit deze directory worden verwijderd zonder dat dit van invloed is op de prestaties van het apparaat.
• U kunt de traceringslogs naar alternatieve locaties overbrengen. U kunt FTP, TFTP, enzovoort gebruiken om de bestanden te kopiëren om ze te analyseren of om ze te uploaden naar een zaak die is geopend met het Technical Assistance Center (TAC).
• U kunt traceringslogs niet uitschakelen, maar u kunt het traceringsniveau wijzigen om te bepalen hoeveel informatie u voor elke module wilt verzamelen.

Trace-niveaus

De overtrekniveaus bepalen de hoeveelheid informatie die in de overtrekbuffer of het -bestand wordt bewaard. Alle beschikbare traceringsniveaus zijn de volgende en leggen de soorten berichten uit die op elk niveau worden geregistreerd.

Noodsituatie-> Systeem is onstabiel/onbruikbaar.

Fout--> Een gebeurtenis die resulteert in een klein verlies van functionaliteit zonder automatische oplossing, wat een onverwacht probleem vertegenwoordigt dat niet onmiddellijk van invloed kan zijn op bewerkingen, maar toekomstige gevolgen kan hebben.

Waarschuwing--> Een probleem dat mogelijk automatisch kan worden opgelost, of een aandoening die kan leiden tot een verlies van functionaliteit als het niet onmiddellijk wordt onderzocht en aangepakt.

Opmerking--> Het standaard logniveau voor modules. Dit niveau legt belangrijke gebeurtenissen vast die zich binnen het systeem voordoen.

Info-> Alleen informatieve berichten. Biedt aanvullende informatie over belangrijke gebeurtenissen die relevant zijn voor het systeem of de functies ervan.

Debug--> Biedt foutopsporingslogboeken.
Verbose--> Biedt tweede niveau van foutopsporingslogs.
Ruis-> Maximaal mogelijke berichten worden geregistreerd.

Huidige overtrekniveaus bekijken

U kunt het traceringsniveau van elke module zien en wijzigen met de opdracht om het traceringsniveau van de platformsoftware weer te geven.

Deze opdracht toont het traceringsniveau van de processen van de forwardingmanager op de actieve RP.

Router#show platform software trace level forwarding-manager rp actief

Dit is de output:

Module Name                     Trace Level      
-----------------------------------------------
acl                             Notice           
active-identity                 Notice           
alg                             Notice           
appnav-controller               Notice           
aps                             Notice           
bcrpgc                          Informational    
bfd                             Notice           
bier                            Notice           

Trace-niveau wijzigen

U kunt een traceringsniveau voor een specifieke module of alle modules in een proces wijzigen. Om dat te doen kunt u de opdracht set platform software trace gebruiken.

Met deze waarschuwing voor platformsoftware traceren chassisbeheer f0 cman_fp wordt het traceringsniveau voor cman_fp in de chassisbeheerder van de ESP in sleuf 0 gewijzigd in waarschuwingsniveau.

U kunt de wijziging valideren met deze opdracht toont platform software trace level chassis-manager f0

Dit is de output:

Module Name                     Trace Level      
-----------------------------------------------
bcrpgc                          Informational    
bipc                            Notice           
bsignal                         Notice           
btrace                          Notice           
btrace_ra                       Notice           
cdllib                          Notice           
chasfs                          Notice           
cman_fp                         Warning  

Nieuwe oversporingsopties

Vanaf 16,8 introduceert Cisco de Unified Logging-verbetering. Het doel is om een naadloze logging-ervaring voor de gebruiker te creëren tussen de IOS-logboekregistratie en andere proceslogsystemen. Logboeken van beide systemen kunnen worden samengevoegd en in tijdvolgorde worden weergegeven, waardoor u gemakkelijker problemen in het systeem kunt oplossen. 

De tracelogs voor verschillende processen weergeven 

Het logboekproces voor opdrachtweergave kan worden gebruikt om de inhoud weer te geven van de tracelogs die door de opgegeven processen zijn gegenereerd. Logs uit de map buffer en tracelogs kunnen in de uitvoer worden opgenomen.

Er is ook ondersteuning voor gedeeltelijke procesnaam de procesnaam wordt geaccepteerd als een woorddoor de parser.

Opmerking: de naam van het proces moet (gedeeltelijk of volledig) overeenkomen met de naam van het tracelog, anders kan er een mismatch optreden waardoor er geen sporen worden weergegeven.

Het logboekproces van de opdrachtshow fman kan de logs fman-rp en fman-fp combineren.

Router#show logging process fman 
Displaying logs from the last 0 days, 0 hours, 10 minutes, 0 seconds
executing cmd on chassis local ...
Unified Decoder Library Init .. DONE
Found 1 UTF Streams

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 source
2024/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 modules
2024/05/22 19:00:50.246777079 {fman_fp_image_F0-0}{255}: [btrace] [13616]: (note): File size max used for rotation of tracelogs: 8192

Meervoudige procesondersteuning uitvoeren

Met de CLI-opdracht "show logging process" kunt u nu meerdere procesnamen opgeven, gescheiden door komma's met het trefwoord 'process'. Samengevoegd tracelog dat alleen logs weergeeft van de opgegeven processen, zoals sman- en ios-processen.

Router#show logging process sman,ios
executing cmd on chassis 1 ...
Collecting files on current[1] chassis.

Opties tijdvenster

Alle sporen kunnen tijdstempels in een lokale tijdzone hebben als er een is geconfigureerd. Zo niet, dan wordt tijdstempels gebruikt in "Coordinated Universal Time" (UTC), maar u kunt de tijdzone voor de logs tussen Local en UTC switches met de opdracht Logging timezone <local | UTC> instellen.

De CLI voor logboekregistratie toont standaard alleen de laatste 10 minuten van de logs van de huidige tijd.

Het laatste trefwoord start kan worden gebruikt om het tijdvenster uit te breiden volgens 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 dagen, uren, minuten of seconden opgeven als volgende optie.

De opties Laatste trefwoord zijn toegevoegd om samen met Laatste start te worden gebruikt om het einde van het tijdvenster op te geven. Wanneer zowel laatste als laatste start worden gebruikt, worden alleen logs binnen het venster verzameld. Zonder de optie Einde laatste wordt de standaardtijd voor het verzamelen van logbestanden ingesteld op de huidige tijd als eindtijd.

Dit is een voorbeeld van het instellen van een venster tussen de laatste twee uur en het laatste uur:

Router#show logging process btman start last 2 hours end last 1 hours
Displaying logs from the last 0 days, 2 hours, 0 minutes, 0 seconds
End time set to show logs before last 0 days, 1 hours, 0 minutes, 0 seconds
executing cmd on chassis 1 ...
Collecting files on current[1] chassis.

Logs weergeven onder specifiek logniveau

U kunt alleen logs weergeven voor een specifiek 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 melding logs butman under error level:

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 seconds
executing cmd on chassis local ...
Unified Decoder Library Init .. DONE
Found 1 UTF Streams

2024/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:6823
2024/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 van tijdstempel weergeven

U kunt logs van specifieke tijdstempel in UTC tonen zoals dit "2017/02/10 14:41:50.849425" 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 .. DONE
Found 1 UTF Streams

Filter policy: Done with UTM processing

Logbestanden tussen twee tijdstempels weergeven

U kunt tracelogs weergeven tussen een tijdvenster door starttijdstempel en eindtijdstempel 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 .. DONE
Found 1 UTF Streams

Filter policy: Done with UTM processing

Live logboekregistratie uitvoeren

U kunt de logs die in realtime worden gegenereerd, controleren voor een proces of profiel. Logs 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
        

Tip: Als u wilt ontsnappen aan de modus voor live logging of deze wilt afsluiten, geeft u een CTRL-C op.

Vooraf gedefinieerde logboekprofielen 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 omvatten alle profielen, bestand, draadloos, sdwan, netconf-yang, restconf, install, hardware-diagnostics.

U kunt het profiel gebruiken om logboekregistratie of de opdracht logboekregistratie van monitor te tonen.

Opmerking: met de optie Logboekprofiel weergeven worden alleen logs uit de buffer weergegeven en worden geen logs uit de directory met tracelogs weergegeven.

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 10 .12+ worden de statistieken standaard opgenomen aan het einde van "Toon logboekregistratie <proces/profiel/bestand> ..". Statistieken tonen het aantal traceringsberichten dat op elk prioriteitsniveau is gedecodeerd en aan de bestaande decoderstatistieken is toegevoegd. De niveautellingen zijn alleen voor weergegeven 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.bin
2024/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
===========================================================

Loguitvoer naar een bestand verzenden

U kunt het trefwoord to-file gebruiken om een bestand te maken met de uitvoer van de logboekweergave van de opdracht. In dit voorbeeld ziet u hoe u de tracelogs van het proces btman verzendt naar een bestand met de naam btman_log.txt in het bootflash-bestandssysteem:

Router#show logging process btman to-file bootflash:btman_log.txt
Logging 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 seconds
executing cmd on chassis local ...
Files being merged in the background, please check [/bootflash/btman_log.txt] output file
Unified Decoder Library Init .. DONE

unified 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 de naam van het bestand als volgt filteren:

Router#dir bootflash: | include btman_log.txt
17      -rw-            26939  Jul 25 2024 03:49:41 +00:00  btman_log.txt