Debug Collection configureren voor CUBE- en TDM-gateways
Inhoud
Inleiding
In dit document worden enkele van de best practices beschreven voor het verzamelen van spraakfouten in Cisco IOS®/IOS XE® Voice Router.
Voorwaarden
Vereisten
- Bevoorrechte toegang om opdrachten uit te voeren in de ISR-routers.
- Ervaring met Voice-over-IP (VoIP) protocollen is gewenst.
- Voor VoIP Trace is een minimum van Cisco IOS XE 17.4.1 of 17.3.2 vereist.
- Basiskennis in Cisco IOS / IOS XE binnen Integrated Services Routers (ISR).
Gebruikte componenten
Voor de toepassing van dit document worden de volgende componenten gebruikt:
- PUTTY
- Cisco ISR 3925
- Cisco ISR 4451
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
Het proces van debug-verzameling op deze platforms heeft uitdagingen en kan mogelijk van invloed zijn op de prestaties van het apparaat. De uitdagingen en risico's nemen toe wanneer er meerdere actieve oproepen in een spraakrouter zijn ingesteld. In sommige scenario's, als de foutmeldingen niet correct worden verzameld, kan dit leiden tot een hoge CPU die schade aan de capaciteit van de router kan veroorzaken en zelfs een softwarecrash kan veroorzaken. Dit document bespreekt de verschillen tussen een Cisco Unified Border Element (CUBE) en een Time-Division Multiplexing (TDM) / Analoge Gateway.
TDM Voice Gateways versus CUBE
TDM voice gateways worden voornamelijk gebruikt om een intern telefoonsysteem te verbinden met een andere Private Branch Exchange (PBX) of het Public Switched Telephony Network (PSTN). Het type verbindingen dat wordt gebruikt in TDM-gateways zijn T1/E1-controllers (ISDN of CAS) en analoge circuits zoals FXS- en FXO-poorten. Een Digital Signal Processor (DSP) zet de audio van zijn ruwe vorm om in RTP-pakketten. Op een vergelijkbare manier worden RTP-pakketten omgezet in onbewerkte audio nadat DSP de RTP-pakketten heeft verwerkt en de audio naar het specifieke circuit heeft verzonden. Deze gateways werken samen met H323, MGCP of Skinny Call Control Protocol (SCCP) aan de VoIP-kant en aan de TDM-kant. De ISDN PRI-circuits of Analoge als de meest voorkomende verbindingen met de PSTN of eindpunten.
Zoals weergegeven in de afbeelding, bieden de TDM-gateways een brug tussen uw interne VoIP-infrastructuur en de analoge of ISDN-serviceproviders:
Met de introductie van VoIP veranderden klanten snel hun oude systemen in een moderne VoIP-infrastructuur. Hetzelfde gebeurde aan de kant van de serviceprovider, waar ze nu verbindingen gebruiken om on-premises telefoniediensten te verbinden met de VoIP-infrastructuur van de serviceprovider en hun mogelijkheden uitbreiden om betere services te bieden. Het meest gebruikte VoIP-protocol is het Session Initiation Protocol (SIP) en wordt momenteel wereldwijd veel gebruikt door klanten en Internet Telephony Service Providers (ITSP).
CUBE werd geïntroduceerd om een manier te bieden om die interne VoIP-systemen te verbinden met de externe wereld via de ITSP's met SIP als het primaire VoIP-protocol. CUBE is gewoon een IP-IP-gateway waar het niet langer een TDM-type verbinding vereist, zoals T1 / E1-controllers of analoge poorten. CUBE draait op dezelfde platformen als TDM Gateways.
Het meest gebruikte VoIP-protocol is SIP, voor het instellen en afbreken van oproepen, en RTP voor mediatransport. In CUBE is er geen DSP nodig, tenzij een transcoder vereist is. De RTP-verkeersstromen eindigen van het ITSP tot het eindpunt en CUBE fungeert als de tussenpersoon met adresverberging als een van de vele functies die het biedt.
Zoals getoond in de afbeelding, biedt CUBE een scheiding tussen uw interne VoIP-infrastructuur en de SIP ITSP:
Verzameling van Cisco IOS / IOS XE Voice Debugs
Spraakfuncties worden uitgevoerd op een verschillende lijst met platforms, zoals ISR, ASR's, CAT8K's, onder anderen; ze gebruiken echter een gemeenschappelijke software die Cisco IOS of Cisco IOS XE is (de verschillen tussen Cisco IOS en Cisco IOS XE worden niet behandeld in dit artikel). Dit zijn de basisprincipes voor toegang tot de Cisco IOS Router.
Toegang tot een Cisco IOS / IOS XE Router via Command Line Interface (CLI)
Routers hebben, net als alle andere op CLI gebaseerde apparaten, een terminalmonitor nodig om toegang te krijgen om de opdrachten via Secure Shell (SSH) of Telnet uit te voeren. SSH is tegenwoordig het meest gebruikte protocol om toegang te krijgen tot de apparaten die worden gegeven. Het biedt een veilige en gecodeerde verbinding met het apparaat. Enkele van de gebruikelijke terminalmonitoren die worden gebruikt om toegang te krijgen tot de CLI van de routers zijn:
Hoe de Terminal Monitor in te stellen om opdrachten of fouten te verzamelen
Er zijn verschillende manieren om de output van de CLI te verzamelen. De aanbeveling is om de informatie van de CLI van de router naar een afzonderlijk bestand te exporteren. Dit maakt het makkelijker om de informatie te delen met externe partijen.
Een paar manieren om de uitgangen van het apparaat te verzamelen zijn:
- Dump alle output in de terminal. U moet ervoor zorgen dat er voldoende scrollback-lijnen zijn, anders mist de scrollback de eerste secties van de uitvoer en kunnen de gegevens onvolledig zijn. Om de scrollback-lijnen in Putty te verhogen, navigeert u naar Putty Configuration > Window > Lines of Scrollback. Normaal gesproken is dit ingesteld op een zeer hoge waarde om voldoende scrollback-uitvoer te hebben:
Later kunt u de informatie van de terminalmonitor verzamelen met de optie Alles naar klembord kopiëren en de uitvoer in een tekstbestand plakken:
- Een andere optie is om de volledige sessie-uitvoer te loggen in een .txt-bestand. Met deze optie worden alle ingevoerde opdrachten en verzamelde uitgangen onmiddellijk aangemeld bij het tekstbestand. Dit is een gangbare praktijk om alle uitvoer in een sessie te loggen. Om alle sessieuitvoer naar een bestand in Putty te loggen, gaat u naar Putty Configuration > Session > Logging en selecteert u vervolgens All Session Output als volgt:
Basisopdrachten voor weergeven verzamelen vanuit de CLI
Opdrachten weergeven zijn vereist om basisinformatie van de router te verzamelen voordat er een foutopsporingsverzameling plaatsvindt. Toon opdrachten zijn snel te verzamelen, en voor het grootste deel, hebben geen invloed op de prestaties op de router. Isolatie van het probleem kan onmiddellijk beginnen door een show-opdracht uit te voeren.
Eenmaal aangesloten op de router, kan de terminallengte worden ingesteld op 0. Dit maakt het mogelijk om sneller te verzamelen om alle uitvoer in één keer weer te geven en het gebruik van de spatiebalk te vermijden. Een opdracht die gedetailleerde informatie over de router verzamelt, is show tech en als alternatief kunt u show tech voice verzamelen, die meer specifieke gegevens toont met spraakfuncties die op de router zijn ingeschakeld:
Router# terminal length 0
Router# show tech
!or
Router# show tech voice
Router# terminal default length !This cmd restores the terminal length to default
Debug-uitvoer van de CLI verzamelen
Debug-outputverzameling in Cisco IOS / IOS XE kan soms een uitdaging zijn, omdat er een risico is op een routercrash. Sommige best practices worden in de volgende secties uitgelegd om een aantal van deze problemen te voorkomen.
Geheugencontrole
Voordat u debugs inschakelt, moet u ervoor zorgen dat er voldoende geheugen is om de uitvoer in de buffer op te slaan.
Voer de opdracht procesgeheugen tonen uit om te bepalen hoeveel geheugen u kunt toewijzen om alle uitvoer in de buffer te loggen:
Tip: Gebruik de standaard lengte van de opdrachtterminal of de terminallengte om terug te gaan naar een beperkte hoeveelheid lijnen die in de terminal worden weergegeven.
Router# show process memory
Processor Pool Total: 8122836952 Used: 456568400 Free: 7666268552
lsmpi_io Pool Total: 6295128 Used: 6294296 Free: 832
In dit voorbeeld is er 7666268552 bytes (7,6 GB) beschikbaar voor gebruik door de router. Dit geheugen wordt door de router gedeeld tussen alle systeemprocessen. Dit betekent dat u niet al het beschikbare vrije geheugen kunt gebruiken om de uitvoer in de buffer te registreren, maar u kunt indien nodig een goede hoeveelheid systeemgeheugen gebruiken.
De meeste scenario's vereisen ten minste 10 MB om voldoende debug-uitvoer te verzamelen voordat de uitvoer verloren of overschreven is. In zeldzame gevallen is een grotere hoeveelheid gegevens vereist voor het verzamelen. In die scenario's kunt u voor 50 MB tot 100 MB aan uitvoer in de buffer ontvangen, of u kunt hoger gaan als er geheugen beschikbaar is.
Als het vrije geheugen laag is, is er mogelijk een geheugenlek. Als dit het geval is, schakelt u het Architecture TAC-team in om te herzien wat de oorzaak van het lage geheugen kan zijn.
Controle van de centrale verwerkingseenheid (CPU)
De CPU wordt beïnvloed door de hoeveelheid processen, functies en oproepen die actief zijn in het systeem. Hoe meer functies of oproepen actief zijn in het systeem, hoe drukker de CPU.
Een goede benchmark is om ervoor te zorgen dat de router de CPU op 30% of minder heeft, wat betekent dat u veilig debugs van basis tot geavanceerd kunt inschakelen (houd de CPU altijd in de gaten wanneer geavanceerde debugs worden gebruikt). Als de CPU van de router ongeveer 50% is, kunnen elementaire foutmeldingen worden uitgevoerd, maar controleer de CPU altijd. Als de CPU hoger is dan 80%, stop dan onmiddellijk debugs (zie verderop in dit artikel) en schakel TAC in voor hulp.
Voer het show process cpu sorted | exclude 0.00 commando uit om de laatste 5s, 60s en 5 min CPU waarden te bekijken samen met de top processen.
Router# show processes cpu sorted | exclude 0.00
CPU utilization for five seconds: 1%/0%; one minute: 0%; five minutes: 0%
PID Runtime(ms) Invoked uSecs 5Sec 1Min 5Min TTY Process
211 4852758 228862580 21 0.15% 0.06% 0.07% 0 IPAM Manager
84 3410372 32046994 106 0.07% 0.04% 0.05% 0 IOSD ipc task
202 3856334 114790390 33 0.07% 0.05% 0.05% 0 VRRS Main thread
In de uitvoer heeft de router niet veel activiteit, is de CPU laag en kunnen foutmeldingen veilig worden ingeschakeld.
Let op: let goed op de belangrijkste CPU-processen die actief zijn. Als de CPU 50% of hoger is en het bovenste proces alleen een spraakproces is, kunnen elementaire debugs worden ingeschakeld. Bewaak de CPU continu met de opdracht om ervoor te zorgen dat de algehele prestaties van de router niet worden beïnvloed.
Huidige actieve oproepen controleren
Elke router heeft verschillende capaciteitsdrempels. Het is belangrijk om te controleren hoeveel oproepen actief zijn in de router om ervoor te zorgen dat deze niet in de buurt van de maximale capaciteit komt. Het Cisco Unified Border Element Version 12 Data Sheet geeft informatie over de capaciteit van elk platform.
Voer het commando show call active total-calls uit om een idee te krijgen van het aantal oproepen dat actief is in het systeem:
Router# show call active total-calls
Total Number of Active Calls : 0
Voer de opdracht actieve spraakoverzicht weergeven uit om meer gedetailleerde informatie te ontvangen over de typen oproepen die actief zijn:
Router# show call active voice summary
Telephony call-legs: 0
SIP call-legs: 0
H323 call-legs: 0
Call agent controlled call-legs: 0
SCCP call-legs: 0
STCAPP call-legs: 0
Multicast call-legs: 0
Total call-legs: 0
Enkele gemeenschappelijke waarden zijn:
- Telefonie Call-Legs: TDM Gateway-oproepen, dit omvat analoge en PRI / ISDN-oproepen.
- SIP Call-Legs: Total SIP Calls; als dit een CUBE Router is, toont dit twee call-legs per oproep. Deel de totale oproepen door twee om een nauwkeurig nummer te ontvangen.
- H323 Call-Legs: Totaal H323-oproepen.
- SCCP Call-Legs: Cisco Unified Communications Manager (CUCM) Controlled Media Resources gebruikt in de router, zoals Transcoder en MTP's.
Instellingen logboekbuffer
Als u de router wilt configureren om de foutopsporingsuitvoer in de buffer op te slaan, wordt de terminalmodus configureren ingevoerd om de instellingen in de CLI handmatig aan te passen. Deze configuratie heeft geen invloed op de router, maar zoals in de vorige secties wordt getoond, toon de technologie of toon de opdrachten voor actieve configuratie van de router als de gebeurtenis in de configuratie moet worden teruggerold.
Dit is een configuratievoorbeeld, een algemene basislijn die wordt gebruikt door TAC Engineers. Hiermee wordt 10 MB buffergeheugen toegewezen, maar dit kan indien nodig worden verhoogd:
# configure terminal
service timestamps debug datetime msec localtime show-timezone year
service timestamps log datetime msec localtime show-timezone year
service sequence-numbers
logging buffered 10000000
no logging console
no logging monitor
logging queue-limit 10000
logging rate-limit 10000
voice iec syslog
Deze commando's vervullen dergelijke taken:
- service timestamps debug of log: Zorgt ervoor dat lokale routertijden met milliseconde nauwkeurigheid op elk gelogd bericht worden geschreven. Dit is handig om oproepen te vinden op basis van tijd. milliseconde tijdstempels, waarmee u foutopsporingslijnen kunt groeperen in logische gerelateerde gebeurtenissen wanneer twee lijnen binnen dezelfde milliseconde voorkomen.
- servicereeksnummers: Schrijft het volgnummer van de foutopsporing in de regel. Dit is handig (vereist) wanneer logs worden doorgestuurd naar een syslog-server. Dit is erg handig om te bepalen of een foutopsporingsbericht naar de syslog-server in het netwerk is gevallen. Het volgnummer is het eerste item in de foutopsporing vóór het tijdstempel- en logbericht. Dit is anders dan de tijdstempel / sequentienummer die syslog-servers lokaal in hun bestanden kunnen schrijven.
- logboekbuffer: hiermee wordt de router verteld om foutmeldingen naar het lokale buffergeheugen te verzenden. De buffergrootte wordt ingesteld in bytes. In de configuratie is de buffergrootte ingesteld op 10 MB.
- geen logboekconsole en geen logboekmonitor: er worden geen logboekberichten afgedrukt in de console of terminalmonitor. Als deze opdrachten niet zijn geconfigureerd, kunnen ze schadelijk zijn voor de prestaties van de router en de nauwkeurigheid van de debug-uitvoer.
- voice iec syslog: Stelt interne foutcodeberichten voor spraak in om de redenen voor het verbreken van de verbinding te bepalen.
Syslog-instellingen configureren
Soms kunnen problemen willekeurig zijn en vereisen een manier om voortdurend debugs te verzamelen totdat de gebeurtenis plaatsvindt. Wanneer u foutmeldingen in de buffer opslaat, worden deze continu verzameld. Het is beperkt tot de hoeveelheid geheugen die u kunt toewijzen en zodra het die hoeveelheid geheugen bereikt, cirkelt de buffer en laat de oudste berichten vallen, wat leidt tot onvolledige waardevolle informatie die nodig is om het probleem te isoleren.
Met syslog kan de router alle foutopsporingsberichten verzenden naar een externe server waar de syslog-serversoftware deze opslaat in tekstbestanden. Hoewel dit een goede manier is om de debug-uitvoer te verzamelen, is het niet de voorkeursmethode voor het verzamelen van logboeken. Syslog-servers hebben de neiging om lijnen van de ontvangen uitvoer over te slaan of te laten vallen vanwege congestie in de server. Aangezien debug-uitgangen de server kunnen overweldigen of pakketten kunnen dalen als gevolg van netwerkomstandigheden. In sommige scenario's zijn syslogs echter de enige manier om vooruitgang te boeken in een kwestie.
Gebruik indien mogelijk een betrouwbare transportmethode zoals TCP om verlies van informatie te voorkomen en sluit de syslog-server aan op dezelfde switch waar de router is aangesloten, of zo dicht mogelijk bij de router. Dit garandeert niet dat alle gegevens in de bestanden worden opgeslagen, maar vermindert de kans op gegevensverlies.
Standaard gebruiken syslog-servers UDP als het transportprotocol op poort 514:
#configure terminal
service timestamps debug datetime msec localtime show-timezone year
service timestamps log datetime msec localtime show-timezone year
service sequence-numbers
!Optional in case you still want to store debug output in the buffer.
logging buffered 10000000
no logging console
no logging monitor
logging trap debugging
!Replace the 192.168.1.2 with the actual Syslog Server IP Address
logging host 192.168.1.2 transport [tcp|udp] port <port>
Zodra de opdrachten zijn geconfigureerd, stuurt de router onmiddellijk berichten naar het IP-adres van de syslog-server.
Debug-verzameling
Zodra debugs zijn ingeschakeld, moet de buffer worden gewist voordat het probleem wordt gereproduceerd. Dit wordt gedaan om ervoor te zorgen dat de output zo schoon mogelijk is en om extra gegevens te vermijden die niet nodig zijn voor analyse. Voer de opdracht Logboek wissen uit, zodat de buffer wordt gewist. Als er andere aanroepen actief zijn in de router en de foutmeldingen zijn ingeschakeld, wordt de uitvoer onmiddellijk afgedrukt in de buffer:
Router# clear log
Clear logging buffer [confirm]
Router#
Nadat het probleem is gereproduceerd, schakelt u de foutmeldingen onmiddellijk uit om extra uitvoer in de buffer te stoppen en verzamelt u vervolgens de logs. U kunt alle uitvoer in de terminal dumpen met deze opdrachten:
Router# undebug all
Router# terminal length 0
Router# show log
Soms sluit PuTTY omdat het niet alle uitgangen in één keer verwerkt. Dit is normaal en betekent niet dat er een storing is opgetreden. Als dit gebeurt, opent u de sessie opnieuw en gaat u normaal verder. In scenario's waarin de logboekbuffer te groot is of de terminalmonitor crasht vanwege de hoeveelheid gegevens die moet worden afgedrukt, kopieert u de bufferuitvoer rechtstreeks naar een extern apparaat met de opdracht show log | redirect:
Router# show log | redirect ftp://username:password@192.168.1.2/debugs.txt
Deze opdracht kopieert de volledige bufferuitvoer naar een FTP IP-adres van: 192.168.1.2 met de bestandsnaam debug.txt. De bestandsnaam moet altijd worden opgegeven. Andere bestemmingen die beschikbaar zijn om gegevens te exporteren zijn:
Router# sh log | redirect ?
bootflash: Uniform Resource Locator
flash: Uniform Resource Locator
ftp: Uniform Resource Locator
harddisk: Uniform Resource Locator
http: Uniform Resource Locator
https: Uniform Resource Locator
nvram: Uniform Resource Locator
tftp: Uniform Resource Locator
Welke Debugs kunnen worden ingeschakeld in Voice Routers
Elke oproepstroom en het type functies (TDM, CUBE of SCCP Media Resources) zijn verschillend en er zijn specifieke foutmeldingen om in te schakelen. Alle vereiste debugs moeten tegelijkertijd worden ingeschakeld. Wanneer slechts één debug tegelijkertijd wordt vastgelegd, is deze ineffectief en biedt meer verwarring wanneer de gegevens worden geanalyseerd.
Fouten zijn ingeschakeld in het CLI executive prompt level Router#, waarvoor u geprivilegieerde uitvoeringstoestemmingen moet hebben.
Er zijn basis- en geavanceerde debugs en elementaire debugs worden gebruikt om signaleringsinformatie te verzamelen in SIP, H323 of MGCP. Dit toont de gesprekken die de router heeft met zijn peer-apparaten.
Geavanceerde foutmeldingen zijn vrij gedetailleerd en worden gebruikt om aanvullende informatie te verzamelen als de interne stapelfouten geen basisfoutmeldingen kunnen weergeven. Deze debugs zijn normaal gesproken CPU-intensief.
Interne Call Control API (CCAPI)-foutopsporing
In elke Cisco IOS / IOS XE Router bevindt zich een API voor oproepbesturing die verantwoordelijk is voor de communicatie tussen verschillende VoIP-toepassingen of -protocollen. De Data Plane-componenten zoals RTP, DSP, Voice Cards, leggen onder andere gegevens vast uit deze laag. Er is een specifieke debug die kan worden gebruikt:
debug voip ccapi inout
Er zijn andere opties voor deze debug; echter, het uitvoeren van de debug voip ccapi inout commando dekt alle elementaire dial-plan en call establishment informatie die normaal meer dan genoeg om te begrijpen wat zijn de staten van deze laag.
Tip: debug voip ccapi inout heeft meestal een minimale impact op de CPU van de router en het wordt aanbevolen om samen met eventuele signaleringsfouten in te schakelen om een volledige set logs te bieden met informatie over de oproep (en) en de verschillende toestanden.
SIP-oproepstromen
Deze foutmeldingen worden vaak gebruikt voor SIP-aanroepstromen en kunnen worden ingeschakeld in CUBE- en TDM-gateways met een SIP-been tussen de router en CUCM of een andere SIP-server of proxy.
Basisfouten SIP
debug ccsip messages
debug ccsip error
debug ccsip non-call !Optional, applies for SIP OPTIONS and SIP REGISTER Messages.
Geavanceerde SIP-fouten
debug ccsip all
debug ccsip verbose
debug voice ccapi inout
Digitale (PRI, BRI) gespreksstromen
Deze foutopsporing is van toepassing op de primaire-renteinterfaces (PRI) T1/E1 of de basisrenteinterfaces (BRI):
Basic Digital Debug
debug isdn q931
Geavanceerde digitale foutopsporing
debug isdn q921
analoge gespreksstromen
Deze foutopsporing wordt gebruikt wanneer analoge circuits Foreign Exchange Subscriber (FXS)- of Foreign Exchange Office (FXO)-poorten bevatten:
debug vpm signal
debug voip vtsp all
MGCP-oproepstromen
Deze debugs worden gebruikt wanneer MGCP wordt gebruikt als het spraakprotocol tussen een spraakgateway en CUCM.
Basisfouten
debug mgcp packets
debug mgcp errors
CCM-beheerfouten
De ccm-manager debugs worden gebruikt om de configuratie te downloaden, en MoH en PRI / BRI backhaul berichten tussen CUCM en de Voice Gateway te volgen. Deze debugs worden gebruikt op basis van wat nodig is en zijn afhankelijk van het faalscenario:
debug ccm-manager backhaul !For PRI and BRI Deployments
debug ccm-manager errors
debug ccm-manager events
debug ccm-manager config-download !Troubleshoot Configuration download issues from CUCM TFTP
debug ccm-mananger music-on-hold !Troubleshoot internal MoH Process
Geavanceerde MGCP-fouten
debug mgcp all
H323 Oproepstromen
Hoewel H323 niet op grote schaal wordt gebruikt, zijn er nog steeds enkele implementaties met H323 geconfigureerd:
Standaard H323-debugs
debug h225 asn1
debug h245 asn1
debug h225 events
debug h245 events
Geavanceerde H323-debugs
debug cch323 h225
debug cch323 h245
debug cch323 all
SCCP-mediabronnen
Deze foutmeldingen worden gebruikt om problemen met SCCP-mediabronnen op te lossen waarbij Media Termination Point (MTP) of Transcoders die op een CUCM-server zijn geregistreerd, betrokken zijn:
Basisfouten SCCP
debug sccp messages
debug sccp events
debug sccp errors
Geavanceerde SCCP-foutopsporing
debug sccp all
VoIP Trace
Met de introductie van Cisco IOS XE 17.4.1 en 17.3.2 is er een nieuwe optie om spraaklogboeken vast te leggen in het Cisco Unified Border Element (CUBE). Deze nieuwe functie heet VoIP Trace. Dit is een nieuw serviceability-framework dat is gemaakt om SIP-signalering en -gebeurtenissen te registreren zonder dat er fouten hoeven te worden geactiveerd.
VoIP Trace is standaard ingeschakeld en kan op elk gewenst moment worden uitgeschakeld. VoIP Trace legt alleen specifieke informatie vast voor SIP-oproepen:
- SIP-fouten
- Kiezen Peer overeenkomend
- RTP-poorten toegewezen
- IEC-fouten correlatie met SIP-signalering
- SIP-berichten voor SIP Trunk naar Trunk-oproepen
- Finite State Machines (FSM) -staten en -gebeurtenissen
- Gebeurtenissen en API-oproepen van SIP Layer naar andere lagen in CUBE
- Oproepbesturing (Unified Communication call flows verwerkt door CUBE)
Beperkingen
VoIP Trace registreert geen informatie met betrekking tot SIP-berichten die buiten het dialoogvenster worden verzonden:
- REGISTREREN
- OPTIES
- ABONNEREN/MELDEN
- INFO
VoIP Trace in HA wordt ondersteund, maar deze kanttekeningen zijn van toepassing:
- De standby-router heeft standaard VoIP Trace ingeschakeld. Er worden alleen toepasselijke sporen voor het stand-byproces weergegeven totdat het actief wordt.
- Zodra Standby actief is, bevat het GEEN volledige sporen van checkpointoproepen en alleen nieuwe oproepen.
- show voip trace <key> werkt nog steeds op de Standby Router en geeft cover buffer en media stream data weer voor oproepen.
Hoe VoIP Trace in te schakelen
Zoals gezegd is deze functie standaard ingeschakeld. Voer de volgende opdrachten uit om deze functie in te schakelen:
Router# configuration terminal
Router(config)# voice service voip
Router(conf-voi-serv)# trace
Router(conf-serv-trace)#
Hoe VoIP Trace uit te schakelen
Voer de volgende opdrachten uit om deze functie uit te schakelen:
Router(conf-serv-trace)# no trace
!or
Router(conf-serv-trace)# shutdown
Let op: Nadat VoIP Trace is uitgeschakeld, wordt al het geheugen gewist en gaat informatie verloren.
De beschikbare opdrachten in de traceringsconfiguratiemodus zijn:
Router(conf-serv-trace)# ?
default Set a command to its defaults
exit Exit from voice service voip trace mode
memory-limit Set limit based on memory used
no Negate a command or set its defaults
shutdown Shut Voip Trace debugging
Geheugenlimiet configureren
De geheugenlimiet bepaalt hoeveel geheugen door VoIP Trace wordt gebruikt om gegevens op te slaan. Standaard is het 10% van het beschikbare geheugen in het platform, maar dit kan worden aangepast tot een max van 1 GB en een min van 10 MB. Het geheugen wordt dynamisch toegewezen, omdat de functie alleen het geheugen gebruikt als dat nodig is en afhankelijk is van het oproepvolume. Zodra het het maximaal beschikbare geheugen heeft bereikt, cirkelt het rond en verwijdert het oudere items.
Wanneer de geheugenlimiet wordt gewijzigd om groter te zijn dan de 10% beschikbare geheugen, wordt een bericht weergegeven op de CLI:
Router(conf-serv-trace)# memory-limit 1000
Warning: Setting memory limit more than 10% of available platform memory (166 MB) will affect system performance.
Voer de opdracht Memory-Limit Platform uit om het standaardgeheugen in te stellen op 10% geheugengebruik:
Router(conf-serv-trace)# memory-limit platform
Reducing the memory-limit clears all VoIP Trace statistics and data.
If you wish to copy this data first, enter 'no' to cancel,
otherwise enter 'yes' to proceed. Continue? [no]:
Hoe VoIP Trace Data weergeven
Als u de gegevens van VoIP Trace wilt weergeven, moet u specifieke opdrachten voor weergeven gebruiken. De gegevens kunnen in dezelfde terminalsessie worden weergegeven of via syslog naar een off-box syslog-server worden verzonden.
Opmerking: sporen worden gedumpt na 32 seconden vanaf het moment dat een BYE wordt ontvangen voor een oproep.
De SIP-signalering wordt per leg weergegeven en wordt niet gecombineerd zoals reguliere debugs. Regelmatige debugs zoals debug CCSIP-berichten, geven de SIP-signalering van een oproep weer in de exacte volgorde waarin de gebeurtenissen plaatsvonden. In VoIP Trace is elk been apart, om de juiste volgorde te bepalen, worden de tijdstempels gebruikt.
Voer de volgende opdrachten uit om de beschikbare gegevens te bekijken:
Router# show voip trace ?
all Display all VoIP Traces
call-id Filter traces based on Internal Call Id
correlator Filter traces based on FPI Correlator
cover-buffers Display the summary of all cover buffers
session-id Filter traces based on SIP Session ID
sip-call-id Filter traces based on SIP Call Id
statistics Display statistics for VoIP Trace
VoIP-overtrek Alles weergeven
Deze opdracht geeft alle VoIP Trace-gegevens weer die beschikbaar zijn in de buffer. Door deze opdracht te gebruiken, heeft dit invloed op de prestaties van de router. Zodra de opdracht is ingevoerd, verschijnt een waarschuwingsbericht om te waarschuwen voor risico's als u doorgaat:
Router# show voip trace all
Displaying 11858 cover buffers
This may severely impact system performance.
Continue? [yes/no] no
VoIP Trace Cover-buffers weergeven
Deze opdracht geeft een overzicht weer van de oproepgegevens voor alle oproepen die worden gemeld onder VoIP Trace. Elke call leg heeft een cover buffer gemaakt die een samenvatting van de gesprekken gelogd bevat:
Router# show voip trace cover-buffers
------------------ Cover Buffer ---------------
Search-key = 8845:3002:659
Timestamp = *Sep 30 01:17:33.615
Buffer-Id = 1
CallID = 659
Peer-CallID = 661
Correlator = 4
Called-Number = 3002
Calling-Number = 8845
SIP CallID = 20857880-1ec12085-13b930-411b300a@10.48.27.65
SIP Session ID = 2b1289c400105000a0002c3ecf872659
GUID = 208578800000
-----------------------------------------------
------------------ Cover Buffer ---------------
Search-key = 8845:3002:661
Timestamp = *Sep 30 01:17:33.634
Buffer-Id = 2
CallID = 661
Peer-CallID = 659
Correlator = 4
Called-Number = 3002
Calling-Number = 8845
SIP CallID = 8D6DEC28-1F111EB-829FD797-1B22F6DB@10.48.55.11
SIP Session ID = 0927767800105000a0005006ab805584
GUID = 208578800000
-----------------------------------------------
Zie de volgende tabel voor meer informatie over elk veld:
| Veld |
Beschrijving |
| zoeksleutel |
Bevat een combinatie van bellen, genaamd nummer en call-id |
| tijdstempel |
Creatietijd van de cover buffer |
| Buffer-ID |
Buffer-ID van de afdekbuffer |
| Call-ID |
Call-ID van de betreffende call leg naar de cover buffer |
| peer-call-id |
Call-ID van het peer-been |
| correlator |
FPI-correlator van de oproep |
| opgeroepen nummer |
Het opgeroepen nummer van de respectieve call-leg van de coverbuffer |
| oproepnummer |
Oproepnummer van het betreffende oproepgedeelte van de afdekbuffer |
| SIP Call-ID |
SIP-call-ID van de respectieve call leg van de cover buffer |
| SIP-sessie-ID |
SIP-sessie-ID van het betreffende oproepgedeelte van de coverbuffer |
| GIDS |
GUID van de betreffende oproep van de afdekbuffer |
| ankerbeen |
Het ankerbeen is ingesteld op 'Ja' als het betreffende oproepbeen een ankerbeen is in de oproepvorkstroom of media-proxy-implementatie |
| Gevurkt been |
Forked leg is ingesteld op 'Yes' als de betreffende call-leg een ankerleg is in de call forking flow of media proxy deployment |
| Geassocieerde CalI-ID's |
Call-ID van de bijbehorende gevorkte benen |
Als u de afdekbuffers wilt filteren, voert u de opdrachten Inclusief en Sectie uit:
Router# show voip trace cover-buffers | include Search-key | 8845 | 3002
Search-key = 8845:3002:661
!or
Router# show voip trace cover-buffers | section Search-key | 8845 | 3002
Search-key = 8845:3002:661
VoIP-tracerings-oproep-ID tonen
In combinatie met de vorige opdracht kan show voip trace call-id worden gebruikt om oproepen te vinden. Zodra de call-id is geïdentificeerd, kan de volgende opdracht worden uitgevoerd om alle informatie op de specifieke call-leg weer te geven:
Router# show voip trace cover-buffers | include Search-key | 8845 | 3002
Search-key = 8845:3002:661
Router# show voip trace call-id 661
VoIP-traceringsstatistieken weergeven
Deze opdracht toont gedetailleerde uitvoergegevens over status, geheugenverbruik, fouten/mislukkingen, succesvolle oproepen, tijdstempels van nieuwste en oudste items en meer:
Router# show voip trace statistics
VoIP Trace Statistics
Tracing status : ENABLED at *Sep 12 06:44:02.349
Memory limit configured : 803209216 bytes
Memory consumed : 254550928 bytes (31%)
Total call legs dumped : 2
Oldest trace dumped : *Sep 12 07:29:21.077 Search-key: 9898:30000:64
Latest trace dumped : *Sep 12 07:29:21.010 Search-key: 9898:30000:63
Total call legs captured : 11858
Total call legs available : 11858
Oldest trace available : *Sep 12 06:57:23.923, Search-key: 5250001:4720001:11
Latest trace available : *Sep 13 05:08:25.353, Search-key: 19074502232:30000:13177
Total traces missed : 0
Raadpleeg de volgende tabel voor meer informatie over elk veld:
| Veld |
Beschrijving |
| Traceringsstatus |
Geeft de overtrekstatus weer, inclusief de tijd en datum waarop VoIP-overtrekken is ingeschakeld. |
| Geheugenlimiet ingesteld |
Geeft de geconfigureerde geheugenlimiet weer. Dit is 10% van de grootte van het processorpoolgeheugen. |
| Geheugen verbruikt |
Geeft de hoeveelheid geheugen weer die dynamisch wordt verbruikt voor VoIP Trace. |
| Totaal aantal oproepen gedumpt |
Geeft het aantal mislukte oproeppoten weer die in de logbuffer zijn gedumpt. Dumped calls verwijst naar call legs geassocieerd met IEC-fouten. |
| Oudste spoor gedumpt |
Geeft tijdstempels en zoeksleutel weer van de oudste mislukte oproep sinds VoIP Trace was ingeschakeld. |
| Laatste spoor gedumpt |
Geeft tijdstempels en zoeksleutel weer van de laatste mislukte oproep sinds VoIP Trace was ingeschakeld. |
| Totaal aantal opgeroepen benen vastgelegd |
Geeft de totale benen weer die zijn vastgelegd nadat VoIP Trace is ingeschakeld. |
| Totaal aantal beschikbare gesprekspunten |
Geeft de totale oproepbenen weer die beschikbaar zijn in de geschiedenis. Dit kan hetzelfde of anders zijn in vergelijking met de totale vastgelegde oproepbenen, dit is afhankelijk van de geheugenlimiet. |
| Oudste spoor beschikbaar |
Geeft tijdstempel en zoeksleutel weer van de oudste buffer die beschikbaar is in het geheugen. |
| Laatste beschikbare trace |
Geeft tijdstempel en zoeksleutel weer van de nieuwste cover buffer die beschikbaar is in het geheugen. |
| Totaal aantal gemiste sporen |
Geeft het aantal gemiste oproepbenen weer vanwege de geheugenlimiet. |
Extra opdrachten weergeven
| Veld |
gebruik |
Beschrijving |
| VoIP-traceringscorrelator tonen <correlator> |
VoIP Trace Correlator 4 weergeven |
Filtert en toont VOIP Trace voor een specifieke call-id vanaf de cover buffer. |
| VoIP-trace sessie-id <sessie-id> weergeven |
VoIP-trace sessie-id weergeven 87003120822B5DBD8FD80F62D8E57C48 |
Filtert en toont VOIP Trace voor een gesprek op basis van de SIP Session-ID. Lokale of externe UUID van de sessie-ID-header van het SIP-bericht kan worden gebruikt om beide benen van het gesprek weer te geven. |
| VoIP-trace SIP-call-id <call-id> weergeven |
VoIP Trace SIP-Call-ID tonen 01E60DFA9D8442848336D79E3155A8A1 |
Filtert en toont VOIP Trace op basis van de SIP Call-ID. |
Revisiegeschiedenis
| Revisie | Publicatiedatum | Opmerkingen |
|---|---|---|
4.0 |
17-Aug-2026
|
Bijgewerkte inleiding, spelling, grammatica, ingevoegde horizontale lijnen om secties te scheiden voor leesbaarheid, vaste CCW-fouten. |
3.0 |
13-Feb-2025
|
Bijgewerkte merkvereisten, stijlvereisten, opmaak en grammatica. |
2.0 |
13-Apr-2023
|
Alt-tekst toegevoegd.
Bijgewerkte titel, introductie, merkvereisten, stijlvereisten, gronden, opmaak en grammatica. |
1.0 |
13-Aug-2021
|
Eerste vrijgave |
FeedbackContact Cisco
- Een ondersteuningscase openen
- (Vereist een Cisco-servicecontract)