Belangrijke informatie over debug commando's begrijpen

Inleiding

Dit document beschrijft algemene richtlijnen voor het gebruik van debug opdrachten, inclusief de debug ip packet opdracht die op Cisco IOS®-platforms beschikbaar is.

Voorwaarden

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

• Aansluiten op de router met behulp van de console, aux en vty poorten

• Algemene problemen met Cisco IOS®-configuratie

• Cisco IOS® debug-uitgangen interpreteren

Gebruikte componenten

Dit document is niet beperkt tot specifieke software- en hardware-versies.

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Achtergrondinformatie

Deze pagina biedt een aantal algemene richtlijnen voor het gebruik van de debugs die beschikbaar zijn op Cisco IOS-platforms, evenals voorbeelden voor het correct gebruik van debug ip packet de opdracht en voorwaardelijke debugging.

De output debug van bevoorrechte EXEC bevelen verstrekt kenmerkende informatie die een verscheidenheid van onderlinge verbindings van netwerkengebeurtenissen met betrekking tot protocolstatus en netwerkactiviteit in het algemeen omvat.

Waarschuwingen

debug Opdrachten met voorzichtigheid. In het algemeen wordt aanbevolen deze opdrachten alleen te gebruiken onder leiding van uw technische routerondersteuningsvertegenwoordiger bij het oplossen van specifieke problemen.

Het inschakelen van debugging kan de werking van de router onderbreken wanneer internetwerken te maken hebben met hoge lastomstandigheden. Dus, als het registreren is ingeschakeld, kan de toegangsserver met tussenpozen bevriezen zodra de consolepoort overbelast wordt met logberichten.

Alvorens u debug bevel begint, overweeg altijd de output die dit bevel kan produceren en de hoeveelheid tijd dit kan nemen.

Bijvoorbeeld, als u een router met één basis snelheidsinterface (BRI) hebt, debug isdn q931 schaadt waarschijnlijk niet het systeem.

Wanneer, het doen van het zelfde zuiveren op een AS5800 met volledige E1 configuratie kan waarschijnlijk zo veel input produceren dat het kan hangen en ophouden antwoordend.

Bekijk voordat u debuggen gaat, uw CPU-belasting met show processes cpu de opdracht. Controleer of er voldoende CPU beschikbaar is voordat u met de debugs begint.

Raadpleeg Hoog CPU-gebruik voor probleemoplossing op Cisco-routers voor meer informatie over de manier waarop u hoge CPU-ladingen kunt verwerken.

Als u bijvoorbeeld een Cisco 7200-router hebt met een ATM-interface die overbrugging uitvoert, kan de router bij het opnieuw opstarten veel van zijn CPU gebruiken, afhankelijk van de hoeveelheid geconfigureerde subinterfaces.

De reden hiervoor is dat voor elk virtueel circuit (VC) een Bridge Protocol Data Unit (BPDU)-pakket moet worden gegenereerd. Wanneer debugs tijdens zo'n kritieke periode wordt gestart, kan het CPU-gebruik dramatisch stijgen, wat kan leiden tot een verlies aan hang- of netwerkconnectiviteit.

Voordat u debuggen

Naast de hierboven genoemde punten, zorg ervoor dat u begrijpt het effect van de debugs op de stabiliteit van het platform. U moet ook overwegen welke interface op de router u moet verbinden met.

Dit hoofdstuk bevat een aantal richtsnoeren.

Het verkrijgen van debug-uitgangen

Routers kunnen debug-uitgangen weergeven voor verschillende interfaces, waaronder de console, aux en vty-poorten. Routers kunnen ook berichten vastleggen aan een interne buffer op een externe unix-syslog server.

De instructies en de voorbehouden voor elke methode worden hieronder besproken:

Console-poort

Als u bent aangesloten op de console, onder normale configuraties, hoeft er geen extra werk te worden gedaan. De debug-uitvoer moet automatisch worden weergegeven.

Zorg er echter voor dat logging console level deze is ingesteld op de gewenste waarde en dat de logboekregistratie niet is uitgeschakeld bij no logging console de opdracht.

Aux-poort

Als u via een hulppoort bent verbonden, typt u terminal monitor de opdracht. Controleer ook of no logging on de opdracht niet op de router is geactiveerd.

VTY-poorten

Als u via een hulppoort of via telnet bent verbonden, typt u terminal monitor de opdracht. Controleer ook of no logging on de opdracht niet is gebruikt.

Berichten vastleggen naar een interne buffer

Het standaardlogapparaat is de console; alle berichten worden weergegeven op de console, tenzij anders aangegeven.

Om berichten aan een interne buffer te registreren, gebruik het bevel van logging buffered de routerconfiguratie. Dit is de volledige syntaxis van deze opdracht:

logging buffered no logging buffered 

logging buffered De opdracht kopieert logberichten naar een interne buffer in plaats van ze te schrijven naar de console. De buffer is circulair van aard, dus nieuwere berichten overschrijven oudere berichten.

Om de berichten weer te geven die zijn ingelogd in de buffer, gebruikt u de geprivilegieerde EXEC-opdracht show logging . Het eerste bericht dat wordt weergegeven is het oudste bericht in de buffer.

U kunt de grootte van de buffer en het prioriteitsniveau van de te registreren berichten instellen.

no logging buffered De opdracht annuleert het gebruik van de buffer en schrijft berichten naar de console (de standaard).

Berichten vastleggen naar een UNIX Syslog Server

Om berichten aan de syslogservergastheer te registreren, gebruik het bevel van de het registreren routerconfiguratie. De volledige syntaxis van deze opdracht volgt:

 logging <ip-address> no logging <ip-address>  

loggingDe opdracht identificeert een syslog server host om logboekberichten te ontvangen. Het < ip-adres > argument is het IP-adres van de host.

Door dit bevel meer dan eens uit te geven, bouwt u een lijst van syslog servers die registrerenberichten ontvangen.

no logging De opdracht verwijdert de syslog server met het opgegeven adres uit de lijst met syslogs.

Andere pre-debug taken

1. Stel uw terminal emulator software (bijvoorbeeld HyperTerminal) zo in dat het de debug uitvoer naar een bestand kan opnemen. Bijvoorbeeld, in HyperTerminal, klikTransfer, dan klik Capture Text , en kies de aangewezen opties. Raadpleeg voor meer informatie Opname van tekstuitvoer van hyperterminal. Raadpleeg voor andere terminal-emulatorsoftware de documentatie bij de software.

2. Schakel tijdstempels voor milliseconden (msec) in met service timestamps de opdracht:

    router(config)#service timestamps debug datetime msec 
         router(config)#service timestamps log datetime msec
   

Deze opdrachten voegen tijdstempels toe om te debuggen in de indeling MMM DD HH:MM:SS, die de datum en tijd volgens de systeemklok aangeeft. Als de systeemklok niet is ingesteld, worden de datum en de tijd voorafgegaan door een asterisk (*) om aan te geven dat de datum en de tijd waarschijnlijk niet correct zijn.

Het is over het algemeen aan te raden om milliseconden timestamps te configureren, omdat dit een hoog niveau van helderheid biedt wanneer wordt gekeken naar debug-uitgangen. Milliseconde tijdstempels geven een betere indicatie van de timing van de verschillende debugs gebeurtenissen ten opzichte van elkaar.

Houd er echter rekening mee dat wanneer de consolepoort veel berichten uitzendt, deze niet kunnen correleren met de werkelijke timing van de gebeurtenis.

Bijvoorbeeld, als u allen op een doos debug x25 toelaat die 200 VCs heeft, en de output aan de buffer (het gebruiken van no logging console logging buffered de andcommando's) wordt geregistreerd, kan timestamp getoond in debug output (binnen de buffer) niet de nauwkeurige tijd zijn wanneer het pakket door de interface overgaat. Gebruik daarom geen msec tijdstempels om prestatiekwesties te bewijzen, maar om relatieve informatie te verkrijgen over wanneer gebeurtenissen plaatsvinden.

Stoppen met debuggen

Als u een debug wilt stoppen, gebruikt u no debug allundebug alltheoretische opdrachten. Controleer dat de debugs uitgeschakeld zijn met de opdrachtshow debug.

Vergeet niet dat de no logging console terminal no monitor commando's alleen voorkomen dat de output wordt uitgevoerd op de console, Aux of vty respectievelijk. Het stopt niet het zuiveren en gebruikt daarom routermiddelen op.

Opdracht debug ip-pakket gebruiken

debug ip packet Het bevel produceert informatie over pakketten die niet snel door de router worden geschakeld. Omdat er echter een uitvoer voor elk pakket wordt gegenereerd, kan de uitvoer uitgebreid zijn en zo de router doen hangen. Daarom mag deze stof alleen worden debug ip packet gebruikt onder de strengste controles zoals beschreven in dit punt.

De beste manier om de output debug ip packet van te beperken is een toegang-lijst te creëren die met debug verbonden was. Alleen pakketten die voldoen aan de toegangscriteria kunnen worden onderworpen debug ip packet aan. Deze toegang-lijst te hoeven niet op om het even welke interface worden toegepast, maar wordt eerder toegepast op zuiveren verrichting.

Alvorens te gebruiken debugging ip packet , merk op dat de router snel-omschakeling door gebrek doet, of CEF omschakeling kan doen indien gevormd om dit te doen. Dit betekent dat, zodra die technieken zijn ingevoerd, het pakket niet wordt verstrekt aan de processor, vandaar toont het debuggen niets. Om dit te laten werken, moet u snel-switching op de router met no ip route-cache (voor unicastpakketten) of no ip mroute-cache (voor multicast pakketten) uitschakelen. Dit moet worden toegepast op de interfaces waar het verkeer zou moeten stromen. Controleer dit bij show ip route de opdracht.

Waarschuwingen

• Het uitschakelen van het snel inschakelen van een router die een groot aantal pakketten verwerkt, kan ervoor zorgen dat de CPU-benutting pieken zodat de doos aan zijn peers hangt of zijn verbinding verliest.

• Schakel de snelle switching op een router met Multi Protocol Label Switching (MPLS) niet uit. MPLS wordt gebruikt in combinatie met CEF. Daarom kan het uitschakelen van het snel inschakelen van de interface rampzalige gevolgen hebben.

Neem dit voorbeeldscenario:

De toegang-lijst die op router_122 wordt gevormd is:

access-list 105 permit icmp host 10.10.10.2 host 10.1.1.1 access-list 105 permit icmp host 10.1.1.1 host 10.10.10.2  

Deze toegangslijst maakt het mogelijk om een Internet Control Message Protocol (ICMP) pakket te verzenden van host router_121 (met IP-adres 10.10.10.2) naar host router_123 (met IP-adres 10.1.1.1) en in de andere richting.

Het is belangrijk dat u de pakketten in één van beide richting toestaat, anders kan de router het terugkerende pakket laten vallen ICMP.

Verwijder snel-inschakelt slechts één interface op router_122. Dit betekent dat u alleen de debugs kunt zien voor de pakketten die bestemd zijn voor die interface, zoals gezien vanuit het perspectief van Cisco IOS dat het pakket onderschept.

Van debugs, verschijnen dergelijke pakketten met "d=". Omdat u het snel inschakelen van de andere interface nog niet hebt uitgeschakeld, is het retourpakket niet onderhevig aan debug ip packet . Deze output toont hoe u snelle omschakeling kunt onbruikbaar maken:

router_122(config)#interface virtual-template 1 router_122(config-if)#no ip route-cache router_122(config-if)#end 

U moet nu de toegangslijst debug ip packet activeren die eerder is gedefinieerd (toegangslijst 105).

router_122# debug ip packet  detail 105 IP packet debugging is on (detailed) for access list 105 router_122# 00:10:01: IP: s=10.1.1.1 (Serial3/0), d=10.10.10.2 (Virtual-Access1), g=10.10.10.2, len 100, forward 00:10:01: ICMP type=0, code=0  ! -- ICMP packet from 10.1.1.1 to 10.10.10.2. ! -- This packet is displayed because it matches the ! -- source and destination requirements in access list 105  00:10:01: IP: s=10.1.1.1 (Serial3/0), d=10.10.10.2 (Virtual-Access1), g=10.10.10.2, len 100, forward 00:10:01: ICMP type=0, code=0 00:10:01: IP: s=10.1.1.1 (Serial3/0), d=10.10.10.2 (Virtual-Access1), g=10.10.10.2, len 100, forward 00:10:01: ICMP type=0, code=0

Verwijder nu snel-inschakelt de andere interface (op router_122). Dit betekent dat alle pakketten over deze twee interfaces nu pakketgeschakeld zijn (wat een vereiste is voor debug ip packet )

router_122(config)#interface serial 3/0 router_122(config-if)#no ip route-cache router_122(config-if)#end router_122# 00:11:57: IP: s=10.10.10.2 (Virtual-Access1), d=10.1.1.1 (Serial3/0), g=172.16.1.6, len 100, forward 00:11:57: ICMP type=8, code=0  ! -- ICMP packet (echo) from 10.10.10.2 to 10.1.1.1  00:11:57: IP: s=10.1.1.1 (Serial3/0), d=10.10.10.2 (Virtual-Access1), g=10.10.10.2, len 100, forward 00:11:57: ICMP type=0, code=0  ! -- ICMP return packet (echo-reply) from 10.1.1.1 to 10.10.10.2  00:11:57: IP: s=10.10.10.2 (Virtual-Access1), d=10.1.1.1 (Serial3/0), g=172.16.1.6, len 100, forward 00:11:57: ICMP type=8, code=0 00:11:57: IP: s=10.1.1.1 (Serial3/0), d=10.10.10.2 (Virtual-Access1), g=10.10.10.2, len 100, forward 00:11:57: ICMP type=0, code=0

Merk op dat de debug IP-pakketuitvoer geen pakketten toont die niet voldoen aan de criteria van de toegangslijst.

Zie Inzicht in de opdrachten Ping en Traceroute voor meer informatie over deze procedure.

Raadpleeg Vastlegging standaard IP-toegangslijst voor meer informatie over het maken van toegangslijsten.

Voorwaardelijk getriggerde debugs

Wanneer de voorwaardelijk getriggerde het Zuiveren eigenschap wordt toegelaten, produceert de router het zuiveren berichten voor pakketten die of de router op een gespecificeerde interface ingaan verlaten; de router genereert het zuiveren geen output voor pakketten die of door een verschillende interface ingaan verlaten.

Bekijk een eenvoudige implementatie van voorwaardelijke debugs. Overweeg dit scenario: de getoonde router volgende (trabol) heeft twee interfaces (serie 0 en serie 3) zowel lopende HDLC inkapseling.

U kunt de debug serial interface normale opdracht gebruiken om de HDLC-keepalives op alle interfaces te observeren. U kunt de keepalives op beide interfaces waarnemen.

traxbol#debug serial interface Serial network interface debugging is on traxbol# *Mar 8 09:42:34.851: Serial0: HDLC myseq 28, mineseen 28*, yourseen 41, line up  ! -- HDLC keeplaive on interface Serial 0  *Mar 8 09:42:34.855: Serial3: HDLC myseq 26, mineseen 26*, yourseen 27, line up  ! -- HDLC keeplaive on interface Serial 3  *Mar 8 09:42:44.851: Serial0: HDLC myseq 29, mineseen 29*, yourseen 42, line up *Mar 8 09:42:44.855: Serial3: HDLC myseq 27, mineseen 27*, yourseen 28, line up

Laat voorwaardelijke debugs voor interfaceserie 3 toe. Dit betekent dat alleen debugs voor interface seriële 3 worden weergegeven. Gebruik debug interface <interface_type interface_number >de opdracht.

traxbol#debug interface serial 3 Condition 1 set

Gebruik show debug condition de opdracht om te verifiëren dat de voorwaardelijke debug actief is. Merk op dat een voorwaarde voor interfaceserie 3 actief is.

traxbol#show debug condition Condition 1: interface Se3 (1 flags triggered) Flags: Se3 traxbol#

Merk op dat nu alleen de debugs voor interface seriële 3 worden weergegeven

*Mar 8 09:43:04.855: Serial3: HDLC myseq 29, mineseen 29*, yourseen 30, line up *Mar 8 09:43:14.855: Serial3: HDLC myseq 30, mineseen 30*, yourseen 31, line up

Gebruik undebug interface <interface_type interface_number> de opdracht om de voorwaardelijke debug te verwijderen. Het wordt aanbevolen om de debugs uit te schakelen (bijvoorbeeld met behulp van undebug alles) voordat u de voorwaardelijke trigger verwijdert.

Dit is om een stortvloed van debug uitgangen te vermijden wanneer de voorwaarde wordt verwijderd.

traxbol#undebug interface serial 3  This condition is the last interface condition set. Removing all conditions can cause a flood of debugging messages to result, unless specific debugging flags are first removed. Proceed with removal? [yes/no]: y Condition 1 has been removed traxbol

U kunt nu waarnemen dat debug voor zowel interfaceserie 0 als serie 3 wordt weergegeven.

*Mar 8 09:43:34.927: Serial3: HDLC myseq 32, mineseen 32*, yourseen 33, line up *Mar 8 09:43:44.923: Serial0: HDLC myseq 35, mineseen 35*, yourseen 48, line up

Deze sectie toont de juiste manier om ATM-pakketdebugging te beperken tot één subinterface:

arielle-nrp2#debug atm packet interface atm 0/0/0.1  !--- Note that you explicitly specify the sub-interface to be used for debugging  ATM packets debugging is on Displaying packets on interface ATM0/0/0.1 only arielle-nrp2# *Dec 21 10:16:51.891: ATM0/0/0.1(O): VCD:0x1 VPI:0x1 VCI:0x21 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2 TYPE:0007 Length:0x278 *Dec 21 10:16:51.891: 0000 FFFF FFFF FFFF 0010 7BB9 BDC4 0800 4500 025C 01FE 0000 FF11 61C8 0A30 *Dec 21 10:16:51.891: 4B9B FFFF FFFF 0044 0043 0248 0000 0101 0600 0015 23B7 0000 8000 0000 0000 *Dec 21 10:16:51.891: 0000 0000 0000 0000 0000 0000 0010 7BB9 BDC3 0000 0000 0000 0000 0000 0000 *Dec 21 10:16:51.891: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 *Dec 21 10:16:51.891: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 *Dec 21 10:16:51.891: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 *Dec 21 10:16:51.891: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 *Dec 21 10:16:51.895: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 *Dec 21 10:16:51.895: arielle-nrp2#

Als u probeert om alle interfaces (met een toegepaste voorwaarde) in te atm debugging schakelen, kan de router hangen als het een groot aantal ATM subinterfaces heeft. Er wordt een voorbeeld weergegeven van de onjuiste methode voor ATM-debugging.

In dit geval zie je dat een voorwaarde wordt toegepast, maar je ziet ook dat dit geen effect heeft. U kunt het pakket van de andere interface nog zien. In dit laboratoriumscenario hebt u slechts twee interfaces en zeer weinig verkeer.

Als het aantal interfaces hoog is, dan zuiver output voor alle interfaces is uiterst hoog en het kan de router veroorzaken om te hangen.

arielle-nrp2#show debugging condition Condition 1: interface AT0/0/0.1 (1 flags triggered) Flags: AT0/0/0.1  ! -- A condition for a specific interface.  arielle-nrp2#debug atm packet ATM packets debugging is on Displaying all ATM packets arielle-nrp2# *Dec 21 10:22:06.727: ATM0/0/0.2(O):  ! -- You see debugs from interface ATM0/0/0/.2, even though the condition ! -- specified ONLY AT0/0/0.1  VCD:0x2 VPI:0x5 VCI:0x37 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2 TYPE:000E Length:0x2F *Dec 21 10:22:06.727: 0000 0000 0180 0000 107B B9BD C400 0000 0080 0000 107B B9BD C480 0800 0014 *Dec 21 10:22:06.727: 0002 000F 0000 *Dec 21 10:22:06.727: un a *Dec 21 10:22:08.727: ATM0/0/0.2(O): VCD:0x2 VPI:0x5 VCI:0x37 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2 TYPE:000E Length:0x2F *Dec 21 10:22:08.727: 0000 0000 0180 0000 107B B9BD C400 0000 0080 0000 107B B9BD C480 0800 0014 *Dec 21 10:22:08.727: 0002 000F 0000 *Dec 21 10:22:08.727: ll *Dec 21 10:22:10.727: ATM0/0/0.2(O): VCD:0x2 VPI:0x5 VCI:0x37 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2 TYPE:000E Length:0x2F *Dec 21 10:22:10.727: 0000 0000 0080 0000 107B B9BD C400 0000 0080 0000 107B B9BD C480 0800 0014 *Dec 21 10:22:10.727: 0002 000F 0000 *Dec 21 10:22:10.727: *Dec 21 10:22:12.727: ATM0/0/0.2(O): VCD:0x2 VPI:0x5 VCI:0x37 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2 TYPE:000E Length:0x2F *Dec 21 10:22:12.727: 0000 0000 0080 0000 107B B9BD C400 0000 0080 0000 107B B9BD C480 0800 0014 *Dec 21 10:22:12.727: 0002 000F 0000 *Dec 21 10:22:12.727: *Dec 21 10:22:13.931: ATM0/0/0.1(O):  !--- You also see debugs for interface ATM0/0/0.1 as you wanted.  VCD:0x1 VPI:0x1 VCI:0x21 DM:0x100 SAP:AAAA CTL:03 OUI:0080C2 TYPE:0007 Length:0x278 *Dec 21 10:22:13.931: 0000 FFFF FFFF FFFF 0010 7BB9 BDC4 0800 4500 025C 027F 0000 FF11 6147 0A30 *Dec 21 10:22:13.931: 4B9B FFFF FFFF 0044 0043 0248 0000 0101 0600 001A 4481 0000 8000 0000 0000 *Dec 21 10:22:13.931: 0000 0000 0000 0000 0000 0000 0010 7BB9 BDC3 0000 0000 0000 0000 0000 0000 *Dec 21 10:22:13.931: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 *Dec 21 10:22:13.931: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 *Dec 21 10:22:13.931: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 *Dec 21 10:22:13.931: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 *Dec 21 10:22:13.935: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000

Gerelateerde informatie

• Technologische ondersteuning voor inbellen en toegang
• Cisco Technical Support en downloads