Diagnostic d'appel : le flux SIP d'un appel donné

À quoi cela sert

Le diagnostic d'appel répond à la question : que s'est-il passé pour un appel précis au niveau de la signalisation ? Vous choisissez l'appel dans la liste des appels (CDR) ou dans le journal CURRI. EasyUC charge ensuite, pour cette période exacte, les traces SDL du service Cisco CallManager de tous les nœuds CallManager du cluster, extrait les messages SIP de cet appel et les affiche sous forme de diagramme en échelle.

Cela remplace la collecte et la recherche manuelles de fichiers de trace avec RTMT. La fonction lit uniquement des fichiers de trace existants, via l'interface de collecte de journaux du CUCM. Elle ne modifie aucune configuration du CUCM et n'active aucune trace.

Si l'appel est passé par un CUBE dont la capture de débogage est activée, EasyUC fusionne ses messages SIP dans le même flux. Cela ne se produit que pour les utilisateurs disposant d'un accès en lecture aux CUBE.

Prérequis

Module de licence cucm et connexion CUCM fonctionnelle.
Rôle ROLE_APP_CALL_DIAGNOSTICS (« Analyze CUCM Calls » dans l'éditeur de rôles). Il permet de lancer, de consulter et d'exporter, et inclut le rôle de page ROLE_APP_VIEW_CALL_DIAGNOSTICS_PAGE ainsi que l'accès en lecture à la liste des appels.
L'utilisateur AXL de la connexion CUCM possède les rôles CUCM Standard CCM Admin Users et Standard RealtimeAndTraceCollection. Sans eux, le nœud signale un rôle manquant.
Sur le CUCM, le service Cisco CallManager utilise le niveau de trace Detailed avec Enable SIP Call Processing Trace. Sans ce réglage, les traces ne contiennent aucun message SIP.
EasyUC joint chaque nœud CallManager par son nom depuis le CUCM, en HTTPS (port 8443).
Si vous partez de la liste des appels : l'import CDR de la connexion est actif. Si vous partez de CURRI : l'appel figure dans le journal CURRI.
Les identifiants SSH (administrateur plateforme/OS) ne sont pas nécessaires pour le diagnostic d'appel. Ils servent uniquement à « Details (SSH) » des nœuds CUCM.
Le service d'arrière-plan chargé de la collecte des traces fonctionne. Il ne traite qu'une collecte à la fois.
Pour les messages CUBE dans le flux : accès en lecture aux CUBE (ROLE_APP_GATEWAYS avec ROLE_APP_GATEWAYS_CUBE). Les administrateurs en disposent toujours.

Pas à pas : lancer un diagnostic depuis la liste des appels

Sélectionnez dans l'en-tête la connexion CUCM par laquelle l'appel est passé.
Ouvrez Logs → Call Diagnostics et cliquez sur Select a call. Vous accédez à la liste des appels sous Reporting → Nutzung & Erreichbarkeit → Calls.
Retrouvez l'appel par période et par numéro.
Dans la ligne de l'appel, cliquez sur Analyze dans la colonne Call diagnostics.
Dans la boîte de dialogue Analyze this call, vérifiez le Timezone et la fenêtre de temps préremplie. Elle couvre 60 secondes avant et après l'appel.
Si nécessaire, réduisez la fenêtre avec Start Time et End Time.
Cliquez sur Start call analysis. EasyUC ouvre la page de détail du diagnostic.
Attendez la fin de l'affichage de progression. Il présente successivement « Determining CallManager nodes », « Listing trace files », « Downloading trace files », « Correlating SIP messages » et « Saving the call flow », avec le nœud et le compteur de fichiers.
Lisez le résultat dans l'onglet Call flow.

Pas à pas : lancer un diagnostic depuis le journal CURRI

Ouvrez CURRI → Curri Logs.
Retrouvez la ligne de l'appel.
Dans la colonne Call flow, cliquez sur l'icône de diagramme (Show SIP flow).
EasyUC lance le diagnostic sans autre boîte de dialogue et ouvre la page de détail. La fenêtre de temps s'étend de 60 secondes avant l'entrée CURRI à 10 minutes après.
Si la même ligne a été analysée au cours des 15 dernières minutes, EasyUC ouvre le diagnostic existant au lieu d'en lancer un nouveau.

Pas à pas : exporter un résultat et le retrouver

Ouvrez Logs → Call Diagnostics. Sous Recent diagnoses, une carte par diagnostic indique l'état, la source (CDR ou CURRI), le numéro de diagnostic, l'appelant, la destination, l'heure et le terminal.
Cliquez sur une carte pour rouvrir le diagnostic.
Cliquez en haut à droite sur SIP messages (text), Filtered logs ou Analysis (JSON) pour télécharger le résultat.
Dans l'onglet Call flow, cliquez sur Download SVG pour enregistrer le diagramme sous forme d'image.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Timezone	Fuseau horaire dans lequel vous indiquez la fenêtre de temps. Prérempli avec le fuseau horaire de votre navigateur.
Date range, Start Time, End Time	Fenêtre de temps de la collecte des traces. Préremplie avec le début de l'appel moins 60 secondes jusqu'à la fin de l'appel plus 60 secondes. Une durée de 1 seconde à 30 minutes est autorisée.
Start call analysis	Crée le diagnostic. Le travail s'exécute en arrière-plan.
Hide 100 Trying	Masque dans le diagramme les réponses provisoires `100 Trying`.
Hide NOTIFY, INFO and OPTIONS	Masque les messages qui n'ont généralement pas d'importance pour l'établissement de l'appel.
Search in messages	Affiche uniquement les messages dont le texte contient le terme recherché, par exemple un Call-ID ou `488`.
Dialog buttons above the diagram	Chaque dialogue SIP a sa propre couleur. Un clic affiche ou masque le dialogue. L'icône d'ancre repère le dialogue grâce auquel l'appel a été trouvé.
Call flow tab	Diagramme en échelle SIP, tableau Other matching calls et tableau CUCM nodes.
Events tab	Participants, terminaux et adresses, identifiants trouvés et liste Trace events avec filtre par catégorie. Show the filtered raw line déploie la ligne de trace d'un événement.
SIP messages (text)	Export de tous les messages SIP de l'appel, dans l'ordre chronologique, sous forme de fichier texte.
Filtered logs	Export des lignes de trace qui appartiennent à cet appel, sous leur forme CUCM d'origine.
Analysis (JSON)	Export du résultat complet sous une forme lisible par machine : participants, dialogues, messages, nœuds et avis.
Download SVG	Enregistre le diagramme en échelle avec les filtres actuellement définis sous forme de graphique vectoriel.
Avis "… messages hidden by the filters"	Indique combien de messages les filtres masquent actuellement. En l'absence de correspondance, il affiche "No messages for these filters."
Voie Expressway	Les messages en provenance et à destination d'un Expressway reçoivent une voie à part portant ce libellé.

Comment lire le diagramme en échelle

Comment lire le diagramme en échelle
Champ / action	Signification et utilisation
Colonnes (voies)	Chaque voie correspond à un pair : nœud CUCM, téléphone IP, Jabber ou Webex App, passerelle / CUBE, trunk SIP, autre cluster CUCM, voicemail ou terminal inconnu. Une voie est créée par adresse IP. Les terminaux derrière la même adresse partagent une voie.
Heure	Heure du message, avec l'écart par rapport au message précédent en dessous.
Flèches	Une flèche représente un message SIP de l'émetteur vers le destinataire. L'étiquette indique la méthode (par exemple `INVITE`, `BYE`) ou le code de réponse.
Couleurs des flèches	Bleu : requête. Gris : réponse provisoire 1xx. Vert : succès 2xx. Orange : redirection 3xx. Rouge : erreur 4xx, 5xx ou 6xx.
Badge SDP	Le message contient une description de média. La vue du message liste les lignes de codec et d'adresse ; SRTP signale un média chiffré.
Barre colorée à côté de l'heure	Indique à quel dialogue appartient le message.
Clic sur un message	Ouvre la vue du message avec l'heure, l'heure sur le nœud, le transport, CSeq, Call-ID, Matched by, le fichier de trace et le texte du message. Copy place le texte dans le presse-papiers. Les identifiants et les clés SRTP sont supprimés ; les messages longs sont tronqués à 8 Ko.
Matched by	Indique comment EasyUC a reconnu l'appel : SIP Call-ID issu du CDR, numéro appelant et numéro appelé, Diversion (renvoi), numéro appelé, numéro appelant seul, ou Call-ID ou Cisco-Guid issu de la capture de débogage du CUBE.
Tuiles SIP messages, Dialogs, CUCM nodes	Nombre de messages de cet appel, nombre de dialogues et de participants, nombre de nœuds et de fichiers de trace lus.
Tuile Status	Completed : tous les nœuds lus, appel trouvé. Partial : résultat exploitable, mais une limite a été atteinte ou un nœud manque. No matches : traces lues, mais aucun dialogue SIP correspondant.
Tableau CUCM nodes	Par nœud : hôte, nombre de fichiers de trace et de messages SIP, fuseau horaire et état. En cas d'erreur, la cause est indiquée en dessous, par exemple un rôle manquant, « TLS error (certificate changed?) », « Not reachable » ou « No trace files ».
Other matching calls	Autres appels qui correspondent également aux numéros à la même période. Le diagramme affiche le plus proche.
État des cartes dans l'aperçu	Analysis running, Completed, Partial, No trace files ou Error.

Contrôler le résultat et circonscrire les erreurs

Vous reconnaissez le succès à l'état Completed et à un diagramme qui commence par INVITE et se termine par BYE ou par une réponse d'erreur.
« The traces contain no SIP messages. Set the trace level of the Cisco CallManager service to "Detailed" and enable "Enable SIP Call Processing Trace". » : corrigez le réglage de trace sur tous les nœuds CallManager du CUCM, puis répétez l'appel.
« The call is older than two hours; its traces may have been rotated on the CUCM. » : le CUCM fait tourner ses fichiers de trace. Lancez le diagnostic le plus tôt possible après l'appel.
« Role missing: the AXL user needs "Standard CCM Admin Users" and "Standard RealtimeAndTraceCollection" » : ajoutez les rôles à l'utilisateur AXL dans le CUCM.
« Only the calling number matched; the call flow may belong to another call of this caller. » : comparez l'heure et la destination, et consultez le tableau Other matching calls.
« The call was still in progress when the traces were read; the call flow ends there. » : relancez le diagnostic une fois l'appel terminé.
« Another call diagnosis is running on this CUCM connection » : un seul diagnostic s'exécute à la fois par connexion CUCM. EasyUC ouvre celui qui est en cours. Les diagnostics suivants attendent dans l'ordre de leur lancement.
« The analysis did not finish: the background worker has not reported for 10 minutes. » ou l'avis indiquant que le worker ne l'a pas pris en charge depuis une heure : le worker d'arrière-plan chargé de la collecte des traces ne fonctionne pas. Relancez le diagnostic et, si le cas se répète, vérifiez les workers.
« Das Zeitfenster der Anrufdiagnose muss zwischen einer Sekunde und 30 Minuten liegen. » (le serveur renvoie ce message en allemand) : réduisez la fenêtre avec Start Time et End Time.
Limites par diagnostic : 8 nœuds CallManager au plus, 12 fichiers de trace par nœud, 64 MiB par fichier et 800 messages dans le diagramme. Lorsqu'une limite est atteinte, le résultat reste visible et reçoit l'état Partial avec un avis.
Si le diagramme n'affiche pas le CUBE alors que l'appel y est passé, les avis en indiquent la raison, par exemple que sa capture de débogage est désactivée ou que la capture est conservée moins de jours que l'âge de l'appel.
"The CUCM node list was not available; only the AXL host was searched." : EasyUC n'a pas pu déterminer les nœuds du cluster. Si l'appel est passé par un autre nœud, il manque. Vérifiez l'accès AXL.
"The time zone of … is unknown; UTC is assumed." : les heures de ce nœud peuvent être décalées. Comparez-les avec les heures des autres nœuds.
"The traces on … start after the call began; the beginning may be missing." et "The CUCM did not provide SDL trace files for the time of the call." : les traces ont déjà été écrasées.
"More trace files cover the call on … than the limit of …; the end of the call may be missing." et "The trace analysis stopped after … MiB of trace data." : réduisez la fenêtre de temps.
"More than … SIP messages in the call window; later messages were ignored." et "The call flow was limited to … messages." : la fenêtre de temps est trop grande pour le trafic du cluster. Réduisez-la.
"The traces contain SIP messages, but none at the time of the call (rotated traces or a time zone offset)." : vérifiez le fuseau horaire dans la boîte de dialogue et l'horloge du CUCM.
"No SIP dialog in the traces matches the numbers and the time of the call." : l'appel n'a pas utilisé SIP, ou les numéros ont été réécrits avant le nœud. Élargissez la fenêtre de temps.
Avis concernant le CUBE : "The debug capture of the CUBE … holds no SIP messages of this call.", "The CUBE debug capture could not be read; the call flow shows the CUCM traces only." et "… could only be read in part". Le flux issu des traces du CUCM reste valable dans tous les cas.
Les identifiants de connexion et les clés SRTP sont supprimés avant l'affichage et dans tous les exports. La fonction se limite à lire et ne modifie rien sur le CUCM.