Configurez la collecte de débogage pour UnifiedBorder Element (CUBE) et des passerelles dumultiplexage temporel (TDM) Contenu

IntroductionConditions préalablesConditions requisesComposants utilisésPasserelles voix TDM contre le CUBECollecte de débogages de Voix IOS/IOS-XEComment accéder à un routeur IOS/IOS-XE par l'intermédiaire de l'interface de ligne decommande (CLI)Comment placer le terminal monitor pour collecter des commandes show ou des débogagesCollectez la sortie de commande show de base du CLICollectez la sortie de débogage du CLIContrôle de mémoireContrôle de l'unité centrale (CPU)Contrôle en cours d'appels actifsConfigurations de tampon de journalisationConfigurez les configurations de SyslogCollecte de débogageQueest-ce que je débogue devrais activer pour des Routeurs de Voix ?Débogage interne de l'API de contrôle d'appel (CCAPI)Écoulements d'appel de SIPDébogages de base de SIPDébogages avancés de SIPÉcoulements d'appel de Digital (PRI, BRI)Débogage de base de DigitalDébogage avancé de DigitalÉcoulements analogiques d'appelÉcoulements d'appel de h323Débogages de base de h323Débogages avancés de h323Ressources en medias de SCCPDébogages de base de SCCPDébogage avancé de SCCP

Introduction

Ce document décrit certaines des pratiques recommandées afin de collecter des débogages deVoix dans un routeur de Voix IOS/IOS-XE. Le processus de la collecte de débogage dans des ces

Plateformes a pu être embrouillant et a pu potentiellement affecter la représentation dupériphérique. Les défis et les risques augmentent quand il y a de plusieurs appels actifs établisdans un routeur de Voix. Dans quelques scénarios si les débogages ne sont pas collectéscorrectement, il pourrait mener à la CPU de haute qui pourrait détriment la capacité du routeur etmême entraîner un crash de logiciel. Ce document commencera par décrire la différence entre unLogiciel Cisco Unified Border Element (CUBE) et une passerelle TDM/Analog.

Conditions préalables

Les informations contenues dans ce document ont été créées à partir des périphériques d'unenvironnement de laboratoire spécifique. Tous les périphériques utilisés dans ce document ontdémarré avec une configuration effacée (par défaut). Si votre réseau est en ligne, assurez-vousde bien comprendre l’incidence possible des commandes.

Exigences

Connaissance de base dans IOS/IOS-XE à l'intérieur des Integrated Services Router (ISR).●

Priviliged Access afin d'exécuter des commandes dans les routeurs ISR.●

L'expérience préalable avec des protocoles de la voix sur IP (VoIP) est désirée.●

Composants utilisés

Afin de ce document les composants utilisés sont :

Cisco ISR 3925●

Cisco ISR 4451●

Mastic●

Passerelles voix TDM contre le CUBE

Les Passerelles voix TDM sont principalement utilisation d'interconnecter un systèmetéléphonique interne avec un autre autocommutateur privé (PBX) ou le réseau téléphoniquecommuté public (PSTN). Le type de connexions qui sont utilisées dans des passerelles TDM sontles contrôleurs T1/E1 (le RNIS ou CAS) et les circuits analogiques tels que des ports FXS et FXO.Un processeur de signaux numériques (DSP) convertira l'audio de sa forme crue en paquets deRTP. D'une manière semblable, les paquets de RTP obtiennent converti en audio brut après quele DSP ait traité les paquets de RTP et envoie l'audio sur le circuit spécifique. Ces passerellespeuvent interopérer avec le h323, le MGCP ou le SCCP du côté VoIP, et du côté TDM ses circuitsou analogue comme connexions les plus communes au PSTN ou points finaux de PRI RNIS.

Suivant les indications de l'image les passerelles TDM fournissent une passerelle entre votreinfrastructure VoIP interne et l'analogue ou les fournisseurs de services RNIS.

Avec l'introduction du VoIP, clients commencés pour changer rapidement leurs systèmes existantsà une infrastructure VoIP moderne. Les mêmes se sont produits du côté de fournisseur deservices, où elles emploient maintenant des connexions pour interconnecter des servicestéléphoniques de Sur-sites avec l'infrastructure VoIP de fournisseur de services et pourdévelopper leurs capacités afin de fournir de meilleurs services. Le protocole VoIP le pluscommun utilisé aujourd'hui est le Protocole SIP (Session Initiation Protocol) et est actuellementtrès utilisé par les clients et les fournisseurs de services de téléphonie Internet (ITSP) à travers lemonde.

Le CUBE a été introduit pour fournir une manière à l'internconnect ces systèmes VoIP internes enmonde externe par l'ITSPs en SIP comme VoIP primaire Protocol. Le CUBE est simplement unepasserelle IP-IP où il n'a besoin plus de n'importe quel type TDM de connexion comme lescontrôleurs T1/E1 ou les ports analogiques. Le CUBE fonctionne sur les mêmes Plateformes quedes passerelles TDM.

La plupart de VoIP commun Protocol utilisé est SIP, pour l'establishement d'appel et ladésinstallation des appels, et RTP pour le transport de medias. En CUBE il n'y a aucun besoind'un DSP à moins qu'un transcodeur soit exigé. La circulation de RTP de bout en bout de l'ITSPau point final, et le CUBE agit en tant qu'intermédiaire avec l'adresse masquant comme une desnombreuses caractéristiques qu'elle offre.

Suivant les indications de l'image, le CUBE fournit une division entre votre infrastructure VoIPinterne et le SIP ITSP :

Collecte de débogages de Voix IOS/IOS-XE

Le passage de caractéristiques de Voix sur une liste différente de Plateformes, comme desRouteurs ISR ou ASR, etc., toutefois ils utilisent un logiciel commun qui est IOS ou IOS-XE (lesdifférences entre l'IOS et l'IOS-XE ne sont pas couverts en cet article). Permet le début avec lesfondements sur la façon dont accéder au routeur IOS.

Comment accéder à un routeur IOS/IOS-XE par l'intermédiaire de l'interface deligne de commande (CLI)

Les Routeurs, comme tous les autres périphériques basés par CLI, exigent d'un terminal monitord'accéder pour exécuter les commandes par le Protocole Secure Shell (SSH) ou le telnet. Le SSHest le protocole le plus commun utilisé de nos jours pour accéder aux périphériques donnés lefournit un sécurisé et une connexion cryptée au périphérique. Certains des terminaux monitorcommuns utilisés pour accéder au CLI des Routeurs sont :

Comment placer le terminal monitor pour collecter des commandes show ou desdébogages

Il y a différentes manières de collecter la sortie du CLI. La recommandation est d'exporter lesinformations du CLI outre du routeur à un fichier séparé. Ceci le facilite afin de partager lesinformations aux interlocuteurs externes.

Quelques manières de collecter les sorties du périphérique sont :

Videz toute la sortie dans le terminal, parce que ceci que vous devez s'assurer qu'il y a assezde lignes de scrollback, autrement le scrollback manque les premières sections de la sortie etles données pourraient être inachevées. Afin d'augmenter les lignes de scrollback en mastic,naviguez vers la configuration de mastic > la fenêtre > les lignes de Scrollback. Normalementceci est placé très à une valeur élevée afin d'avoir assez de scrollback sorti :

●

Plus tard vous pouvez collecter toutes les informations du terminal monitor avec la copie à l'optionde presse-papier et coller la sortie dans un fichier texte :

Une autre option est de se connecter la sortie entière de session à un fichier de .txt. Cetteoption toutes les commandes sélectionnées, et les sorties étant collecté, sont immédiatementconnectées au fichier texte. C'est une pratique commune afin de se connecter toute la sortieen session. Afin de se connecter toute la sortie de session à un fichier en mastic naviguezvers la configuration > la session de mastic > en se connectant et puis sélectionnez toute lasession sortie comme suit :

●

Remarque: Le nom du fichier par défaut de log est utilisé si aucun autre nom n'est spécifié,cliquent sur le bouton Parcourir afin de savoir exactement où le fichier est enregistré afin dele trouver plus tard. Assurez également que vous ne remplacez pas un autre fichier deputty.log du fait le même chemin de fichier.

Collectez la sortie de commande show de base du CLI

Les commandes show sont nécessaires pour collecter les informations de base du routeur avantque n'importe quelle collecte de débogage ait lieu. Les commandes show sont rapides pourcollecter, et pour la plupart, n'ayez aucune incidence dans la représentation sur le routeur.L'isolation du problème a pu commencer immédiatement par juste une sortie de commande show.

Une fois connecté au routeur, le terminal length peut être placé à 0. Ceci peut rendre la collectionplus rapide afin d'afficher toute la sortie immédiatement, et évite l'utilisation de la barred'espacement. L'une commande qui collecte les informations détaillées au sujet du routeur est« tech d'exposition », et alternativement vous peut collecter la Voix de tech d'exposition qui affichedes données plus spécifiques aux caractéristiques de Voix activées dans le routeur :

Router# terminal length 0

Router# show tech

!or

Router# show tech voice

Router# terminal default length !This cmd restores the terminal length to default

Collectez la sortie de débogage du CLI

La collecte de sortie de débogage dans IOS/IOS-XE peut parfois être un défi puisqu'il y a risqued'un crash de routeur. Certaines des pratiques recommandées sont expliquées dans les sectionssuivantes pour éviter toutes les questions cependant.

Contrôle de mémoire

Avant que vous activiez tous les débogages, vous devez s'assurer qu'il y a assez de mémoire afind'enregistrer la sortie dans la mémoire tampon.

Exécutez la mémoire de processus d'exposition de commande pour découvrir combien de

mémoire vous pouvez allouer afin de se connecter toute la sortie dans la mémoire tampon :

Conseil : Employez le <num_lines> de par défaut ou de terminal length de lengh de terminalde commande pour retourner à un amout limité des lignes affichées dans le terminal.

Router# show process memory

Processor Pool Total: 8122836952 Used: 456568400 Free: 7666268552

lsmpi_io Pool Total: 6295128 Used: 6294296 Free: 832

Dans l'exemple, il y a de 7666268552 octets (7.6GB) de libre d'être utilisé par le routeur. Cettemémoire est partagée par le routeur parmi tous les processus de système, ceci signifie que vousne pouvez pas employer la mémoire disponible entière pour se connecter la sortie dans lamémoire tampon, mais vous pouvez utiliser une bonne quantité de mémoire système commenécessaire.

La plupart des scénarios exigent au moins de 10MB de collecter assez de sortie de débogageavant que la sortie soit perdue ou remplacée. Dans rare occasionne plus de données est priéd'être collecté, dans ces scénarios spécifiques vous pouvez obtenir 50MB à la valeur 100MB de lasortie dans la mémoire tampon ou vous pouvez passer à 1 tant que il y a mémoire disponible.

Si la mémoire disponible est basse, alors il y a potentiellement un problème de fuite de mémoire,si c'est le cas, engagent s'il vous plaît l'équipe de l'architecture TAC mettre à jour ce qui pourraitêtre la cause d'une telle mémoire basse.

Contrôle de l'unité centrale (CPU)

La CPU est affectée par la quantité de processus, de caractéristiques et d'appels actifs dans lesystème. Plus de caractéristiques ou d'appels actifs dans le système, plus la CPU est occupée.

Un bon benchmark est de s'assurer que le routeur a la CPU à 30% ou moins, qui vous signifiepeut sans risque activer des débogages de base à avancé (gardez toujours un oeil sur la CPUquand des débogages avancés sont utilisés). Si la CPU de routeur est à environ 50% alors desdébogages que de base peuvent être exécutés et surveillent soigneusement la CPU. Si la CPUatteint l'arrêt du supérieur à 80% immédiatement les débogages (affichés plus tard en cet article)et engagez le TAC pour l'assistance.

Utilisez la CPU de processus d'exposition triée | excluez 0.00 commande de vérifier dernière desvaleurs CPU 5s, 60s et 5mins avec le dessus traite utiliser activement la CPU.

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

Dans la sortie, le routeur n'a pas beaucoup d'activité, la CPU est basse, et des débogagespeuvent sans risque être activés.

Attention : Prêtez une attention supplémentaire à l'active de processus CPU de dessus, si laCPU est à 50% ou plus élevé et le processus supérieur est un processus de Voix seulementdes débogages que fondamentaux peuvent être activés. Surveillez continuellement la CPU

avec la commande de s'assurer que la performance globale du routeur n'est pas affectée.

Contrôle en cours d'appels actifs

Chaque routeur a différents seuils de capacité. Son important pour le vérifier combien d'appelssont en activité dans le routeur pour s'assurer n'est pas étroitement à la capacité maximum. Lafiche technique de version 12 de Logiciel Cisco Unified Border Element fournit des informations ausujet de chaque capacité de plate-forme pour la référence.

Utilisez les totaux des appels d'appel est actif d'exposition commandent d'avoir une idée àcombien d'appels sont en activité dans le système :

Router# show call active total-calls

Total Number of Active Calls : 0

Utilisez la commande récapitulative de show call active voice d'obtenir plus d'informationsdétaillées des types d'appel spécifiques qui sont en activité :

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

Certaines des valeurs communes sont :

Appel-tronçons de téléphonie : La passerelle TDM appelle, ceci inclut l'analogue et les appelsPRI/ISDN.

●

Appel-tronçons de SIP : Appels totaux de SIP. Si c'est un routeur de CUBE, alors ceci affiche2 tronçons d'appel par appel. Divisez les totaux des appels affichés ici par 2 pour obtenir unnombre précis.

●

Appel-tronçons de h323 : Appels totaux de h323.●

Appel-tronçons de SCCP : Ressources en medias commandés CUCM utilisées dans lerouteur tel que le transcodeur et le MTPs.

●

Configurations de tampon de journalisation

Pour configurer le routeur pour enregistrer la sortie de débogage dans la mémoire tampon, lemode de configure terminal est entré pour tordre manuellement les configurations dans le CLI.Cette configuration n'a aucune incidence au routeur, toutefois suivant les indications des sectionsprécédentes, le tech d'exposition ou la commande show running-config du routeur est nécessaireen cas la configuration doit être roulé de retour.

Un exemple de configuration peut être vu ensuite, qui est une spécification de base communeutilisée par des ingénieurs TAC. L'exemple alloue un 10MB de mémoire tampon mais il peut êtreaugmenté comme nécessaire : 

# 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

Les commandes accomplissent ces tâches :

débogage ou log d'horodateurs de service : S'assure que le temps de routeur local est écritsur chaque message loggé, avec la précision de milliseconde. C'est utile afin de trouver desappels basés sur le temps. Les horodatages en millisecondes tiennent compte pour que vousgroupiez des lignes de débogage dans des événements associés logiques quand deux lignesse produisent dans la même milliseconde.

●

service sequence-numbers : Écrit le numéro de séquence du débogage dans la ligne. C'estutile (essentiellement requis) quand des logs sont expédiés à un serveur de Syslog. Cet trèsutile afin d'identifier si des messages de débogage au serveur de Syslog ont été abandonnésdans le réseau. Le numéro de séquence est le premier élément dans le débogage, avantl'horodateur et le message de log d'effectif. Notez que c'est différent de l'horodateur/denuméro de séquence de serveurs de Syslog peut écrire localement dans leurs fichiers.

●

tampon de journalisation : Dit le routeur d'envoyer des débogages à sa mémoire tamponlocale. La taille de mémoire tampon est fixée dans les octets. Dans la configuration la taille demémoire tampon a été fixée à 10MB.

●

no logging console et aucun moniteur se connectant : Aucun message de log n'est imprimédans la console ou le terminal monitor. Si ces commandes ne sont pas configurées, ellespourraient porter préjudice à la précision de la représentation et de la sortie de débogage durouteur.

●

voice iec syslog : Messages de codes d'erreur interne de Voix d'enables pour déterminer desraisons de débranchement.

●

Configurez les configurations de Syslog

Parfois les questions peuvent être aléatoires et exiger une manière de collecter continuellementdes débogages jusqu'à ce que l'événement se produise. Quand vous enregistrez les débogagesdans la mémoire tampon, elle les collecte continuellement. Notez qu'il est limité à la quantité demémoire que vous pouvez allouer et une fois elle atteint cette quantité de mémoire, les cercles demémoire tampon autour et relâche les messages les plus anciens, qui mène aux données devaleur inachevées exige d'isoler la question.

Avec le Syslog le routeur peut envoyer tous les messages de débogage à un serveur externe, oùle logiciel de serveur de Syslog l'enregistre dans des fichiers texte. Bien que son une bonnemanière de collecter la sortie de débogage, ne soit pas la méthode préférée pour la collecte delog. Les serveurs de Syslog tendent à ignorer ou les lignes de baisse de la sortie reçue due àl'encombrement en serveur, puisque la sortie de débogage peut accabler le serveur, ou paquetspourraient obtenir en raison abandonné des états de réseau. Cependant dans quelques scénariosle Syslog est la seule manière d'accomplir la progression sur une question.

Si possible employez une méthode de transport fiable telle que le TCP pour éviter n'importe quelleperte des informations et comme une suggestion connectent le serveur de Syslog au même

commutateur où le routeur est connecté ou aussi étroitement comme possible au routeur. Il negarantit toujours pas que toutes les données sont enregistrées dans les fichiers, mais réduisentles possibilités de la perte de données.

Par Syslog par défaut les serveurs utilisent l'UDP comme protocole de transport relatif au port514.

#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 1.1.1.1 with the actual Syslog Server IP Address

logging host 1.1.1.1 transport [tcp|udp] port <port>

Dès que les commandes seront configurées, le routeur immédiatement en avant les messages àl'adresse IP du serveur de Syslog.

Collecte de débogage

Une fois les débogages ont été activés, la mémoire tampon doit être effacés avant que la questionsoit reproduite. Ceci est fait pour s'assurer que la sortie est aussi propre comme possible et évitern'importe quelles données supplémentaires qui ne sont pas nécessaires pour l'analyse. Exécutezle clear log de commande, ceci s'assure que la mémoire tampon obtient effacé. S'il y a d'autresappels actifs dans le routeur et les débogages sont activés, de sortie des copies immédiatementdans la mémoire tampon.

Router# clear log

Clear logging buffer [confirm]

Router#

Après que la question soit reproduite, désactivez les débogages immédiatement pour arrêter plusde sortie de l'impression dans la mémoire tampon. Collectez alors les logs. Vous pouvez vidertoute la sortie dans le terminal avec les commandes :

Router# undebug all

Router# terminal length 0

Router# show log

Parfois le mastic se ferme et ne pourra pas manipuler toute la sortie immédiatement, c'est normalet il ne signifie pas quelque chose faux arrivé au routeur, si ceci se produit rouvrent la session denouveau et continuent normalement. Dans les scénarios où le tampon de journalisation est tropgrand ou les crash de terminal monitor dus la quantité de données qui doivent obtenir imprimé,copiez la sortie de mémoire tampon sur un périphérique externe directement avec le show log decommande | réorientez :

Router# show log | redirect ftp://username:password@1.1.1.1/debugs.txt

Les commandes copy la sortie de mémoire tampon entière à un FTP avec l'adresse IP 1.1.1.1avec le nom du fichier debug.txt. Le nom du fichier doit toujours être spécifié. D'autres destinationsdisponibles pour exporter que les données sont :

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

Queest-ce que je débogue devrais activer pour des Routeurs deVoix ?

Chaque écoulement d'appel et type de caractéristiques (TDM, CUBE ou SCCP (ressources enmedias)) soyez différent et il y a spécifique vous débogue peut activer. Tous les débogagesexigés doivent être activés en même temps. Capturer un débogage à la fois n'est pas efficace etfournit plus de confusion quand les données sont analysées.

Des débogages sont activés à l'intérieur du niveau Router# de demande d'exécutif CLI qui exigede vous d'avoir des autorisations favorisées de mode d'exécution.

Il y a des débogages de base et avancés. Des débogages de base sont utilisés pour recueillir lesinformations de signalisation ou dans le SIP, h323, ou le MGCP, qui affiche aux conversations lerouteur a avec ses périphériques de pair.

Les débogages avancés sont très détaillés et sont normalement utilisés pour recueillir plusd'informations en cas des erreurs de pile internes que les débogages de base ne peuvent pasafficher. Ces débogages sont normalement CPU intensive.

Conseil : Après que les débogages soient activés, souvenez-vous pour exécuter le clearlogging de commande. Cette commande s'assure que la mémoire tampon est effacée pourune capture plus propre des débogages.

Débogage interne de l'API de contrôle d'appel (CCAPI)

Àl'intérieur de chaque routeur IOS/IOS-XE il y a un API de contrôle d'appel qui est responsable dela transmission entre différentes applications VoIP, ou des protocoles, et les composants de plande données, tels que le RTP, le DSP, les cartes de Voix, etc. afin de capturer des données decette couche là est un débogage spécifique qui peut être utilisé :

debug voip ccapi inout

Il y a d'autres options pour ce débogage, toutefois le debug voip ccapi inout couvre toutes lesinformations de base d'établissement de Plan de composition et d'appel qui sont normalementplus qu'assez pour comprendre ce qui sont les états de cette couche.

Conseil : le debug voip ccapi inout habituellement a l'incidence minimale à la CPU du routeur

et est recommandé d'être activé avec tous les débogages de signalisation afin de fournir àun ensemble complet de logs les informations des appels et de ses différents états.

Écoulements d'appel de SIP

Ces débogages sont les plus utilisés généralement pour des écoulements d'appel de SIP et ilspeuvent être activés à l'intérieur des passerelles de CUBE et TDM avec un tronçon de SIP entre lerouteur et le CUCM ou n'importe quels autres serveur SIP/proxy.

Débogages de base de SIP

debug ccsip messages

debug ccsip error

debug ccsip non-call !Optional, applies for SIP OPTIONS and SIP REGISTER Messages.

Débogages avancés de SIP

debug ccsip all

debug ccsip verbose

debug voice ccapi inout

Écoulements d'appel de Digital (PRI, BRI)

Ces débogages s'appliquent pour le débit primaire Interfances (PRI) T1/E1 ou accès de base(BRI) :

Débogage de base de Digital

debug isdn q931

Débogage avancé de Digital

debug isdn q921

Écoulements analogiques d'appel

Ces débogages sont utilisés quand il y a les circuits analogiques impliqués comme l'abonnéExchange de Foreigh (FXS) ou les ports de devises étrangères du bureau (FXO) :

debug vpm signal

debug voip vtsp all

Écoulements d'appel de h323

Bien que le h323 ne soit pas très utilisé, il restent quelques déploiements avec le h323 configuré :

Débogages de base de h323

debug h225 asn1

debug h245 asn1

debug h225 events

debug h245 events

Débogages avancés de h323

debug cch323 h225

debug cch323 h245

debug cch323 all

Ressources en medias de SCCP

Ces débogages sont utilisés pour dépanner les questions de ressources en medias de ProtocoleSCCP (Skinny Call Control Protocol) qui impliquent le Media Termination Point (MTP) ou lestranscodeurs enregistrés à un serveur de Cisco Unified Communications Manager (CUCM) :

Débogages de base de SCCP

debug sccp messages

debug sccp events

debug sccp errors

Débogage avancé de SCCP

debug sccp all