Analyse d'appels : lire la liste des appels, les détails et le flux d'appel

À quoi cela sert

Après une exécution de l'analyse d'appels, la liste des appels de la période est disponible. Ce chapitre décrit comment y retrouver l'appel suspect et ce que montre la page de détail d'un appel : aperçu avec causes expliquées, flux d'appel, média et qualité, terminaux concernés et données brutes.

Si un appel dispose à la fois d'un CDR et de SIP, le CDR fait foi pour le résultat, les numéros, les heures et la durée. Les messages SIP fournissent le flux d'appel, l'état SIP, les valeurs de qualité, les nœuds et les noms de terminaux. La page de détail indique toujours comment le CDR et le SIP ont été rapprochés.

Prérequis

Une exécution terminée de l'analyse d'appels avec l'état Completed ou Partial.
Rôle ROLE_APP_CALL_DIAGNOSTICS. La consultation et l'export fonctionnent aussi avec un compte en lecture seule.
Pour les messages CUBE dans le flux d'appel : accès en lecture aux CUBE. Ces données ne sont pas enregistrées dans l'exécution ; elles sont ajoutées à nouveau depuis la capture du CUBE à l'ouverture du flux d'appel.
La description reflète le système de laboratoire.

Pas à pas : retrouver un appel dans la liste

Ouvrez Logs → Call Analysis et cliquez sur l'exécution sous Stored runs.
Saisissez une valeur connue dans le champ de recherche Search number, device, user or Call-ID.
Affinez avec les boutons sous Result, par exemple Failed, Busy ou No answer.
Si nécessaire, utilisez Features (par exemple Forwarded, Trunk / gateway), Source, Quality et Call flow (With call flow / Without call flow).
Triez en cliquant sur les en-têtes de colonne Start, Caller, Reached, Duration ou Result.
Cliquez sur la ligne de l'appel pour ouvrir la page de détail.
Reset filters supprime à nouveau tous les filtres.

Pas à pas : évaluer un appel

Dans l'onglet Overview, lisez le résultat, les causes, les heures et la chaîne de redirection.
Passez à l'onglet Call flow. Le diagramme est le même que dans le diagnostic d'appel : une voie par pair, une flèche par message SIP ; cliquez sur une flèche pour afficher le message.
Si le flux d'appel manque, lisez la raison indiquée. Cliquez sur Start a single diagnosis pour créer un diagnostic d'appel pour cet appel précis.
Dans l'onglet Media / quality, vérifiez le codec, l'adresse média, le chiffrement et les statistiques RTP des terminaux.
Dans l'onglet Devices, utilisez Open device ou Open user pour ouvrir dans EasyUC le téléphone ou l'utilisateur concerné.
L'onglet Raw data contient les champs CDR et les messages SIP sous leur forme d'origine. Utilisez Filter field or value pour rechercher un champ CDR précis.
Cliquez sur Export et choisissez Everything (JSON), SIP messages (text), Call flow (JSON) ou CDR (CSV).
Back to the call list ramène à l'exécution. Exportez-y la liste entière avec List as CSV.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Start	Heure à laquelle l'appel a commencé. Un appel appartient à l'exécution s'il a commencé dans la période.
Caller	Numéro appelant.
Dialled / Reached	Numéro composé à l'origine et numéro auquel l'appel est finalement arrivé. S'ils diffèrent, l'appel a été redirigé.
Duration	Durée de conversation.
Result	Answered, Abandoned by caller, Busy, No answer, Rejected, Unreachable, Failed, In progress (uniquement à partir du SIP) ou Unknown.
Devices / trunks	Téléphones, softphones, trunks et passerelles concernés.
Nodes	Nœuds CallManager par lesquels l'appel est passé.
Features	Forwarded, Transfer, Conference, Hunt group, Queue, Trunk / gateway, Encrypted, Video.
Quality	Good, Fair, Poor ou No data. Fondé sur les pires statistiques de réception : MOS à partir de 4,0 bon, à partir de 3,6 moyen ; sans MOS, perte de paquets inférieure à 1 % et gigue inférieure à 30 ms bon, inférieure à 3 % et inférieure à 60 ms moyen.
Call flow	Call flow available, Call flow incomplete ou No call flow.
Source	CDR and SIP, CDR only ou SIP only.
Per page	25, 50 ou 100 appels.
Result : origine	Avec un CDR, le CDR décide : une heure de connexion signifie Answered, sinon la cause fait foi. Sans CDR, la dernière réponse SIP décide. La correspondance exacte figure dans le chapitre sur les codes de cause.
Features : origine	À partir des motifs de redirection et d'autres champs des CDR, ainsi que des messages SIP : l'en-tête `Diversion` pour le renvoi, `REFER` et `Replaces` pour le transfert, le SDP pour la vidéo et le chiffrement.
List as CSV	Exporte la liste avec les filtres définis. Les heures sont en UTC.

Comment lire la page de détail

Comment lire la page de détail
Champ / action	Signification et utilisation
Overview: Start, Answered, End	Heures de l'appel, ainsi que Ring time et Talk time.
Result et Ended by	Issue de l'appel et côté qui a raccroché.
Causes	Valeurs de cause du côté appelant et du côté appelé sous forme de texte. Le texte nomme la cause Q.850, l'état SIP le cas échéant et toujours la valeur brute. Les valeurs inconnues restent visibles sous la forme « Code n ».
Redirect chain	Étapes de Dialled à Reached, en passant par Intermediate et Last redirected by. Le CDR n'enregistre que la première et la dernière redirection.
Hunt pilot / Time in queue	Hunt pilot et temps d'attente si l'appel est passé par un hunt group avec file d'attente.
Matched by	Session-ID, CUCM leg identifier, Cisco-Guid ou Time and numbers. Ce dernier est le moins fiable ; la page le signale séparément.
Legs (CDR rows)	Les lignes CDR individuelles de l'appel, par exemple en cas de transfert ou de conférence.
Media / quality: Media streams	Par côté : codec, bande passante, adresse média, méthode DTMF, vidéo et chiffrement d'après les CDR.
RTP statistics of the endpoints	Par terminal déclarant et par direction (Receive, Send) : paquets, perte, gigue et MOS. Les valeurs proviennent des messages SIP que les terminaux envoient à la fin de l'appel. Le MOS n'est affiché que si le terminal l'envoie.
Devices: Role	Caller, Called ou In the call flow, ainsi que nom, type, adresse IP, modèle, description et utilisateur.
Raw data	Les identifiants, les clés et les saisies au clavier sont masqués.
Overview: Users, Identifiers, Partitions	Utilisateurs des terminaux concernés, identifiants de l'appel (Call-ID, Session-ID, identifiants de segment) et partitions des numéros.
Call flow: With messages of the CUBE debug capture	Nomme les CUBE dont les messages sont fusionnés dans le flux. Ils sont relus à chaque ouverture du flux d'appel et ne sont pas enregistrés dans l'exécution.
Media: DTMF	No preference (any matched method), Out of band, RFC 2833, Out of band and RFC 2833 ou Unknown. "No preference" est le cas normal entre téléphones et ne signifie pas qu'aucune saisie au clavier n'a été transmise.
Media: Encryption	Not secured, Authenticated ou Encrypted.
Media: Rating	Évaluation globale de l'appel, fondée sur la pire direction de réception signalée.
Devices: Type	IP phone, Jabber / Webex, Webex App, Analog port, Trunk, Gateway / CUBE, Expressway, Other CUCM cluster, Voicemail, Media resource, CUCM node ou Unknown.
Export: Everything (JSON)	Toutes les données de l'appel : aperçu, causes, média, terminaux, champs CDR et messages SIP.
Export: SIP messages (text) / Call flow (JSON) / CDR (CSV)	Les messages SIP sous forme de texte, le modèle du diagramme avec voies et flèches, ou les lignes CDR de l'appel.
Contenu masqué	Supprimés avant l'enregistrement : les en-têtes `Authorization` et `Proxy-Authorization`, les clés SRTP dans le SDP, les saisies au clavier envoyées par KPML ou `INFO`, le mot de passe dans une adresse SIP et le code d'autorisation dans les CDR.

Contrôler le résultat et circonscrire les erreurs

Un appel est évalué de manière concluante lorsque le résultat, la cause et le dernier code de réponse du flux d'appel concordent, par exemple Busy et 486 Busy Here.
« There is no CDR for this call: not completed, still active, not imported yet or CDR import off. » : l'appel provient uniquement des traces. Extrayez de nouveau la période plus tard, une fois les CDR arrivés.
« No SIP was found in the traces for this call (no SIP device, trace level or traces overwritten). » : les terminaux SCCP ou analogiques n'ont pas de flux d'appel. Sinon, vérifiez le niveau de trace.
« The call lies outside the trace range that was read. » : l'exécution n'a pas lu les traces pour toute la période. Extrayez une période plus courte.
« The call flow is incomplete: the call was still running at the end of the range read, or a node is missing. » : répétez l'exécution une fois l'appel terminé ou vérifiez le tableau Nodes read.
« CDR and SIP were matched by time and numbers only. » : en cas de plusieurs appels simultanés entre les mêmes numéros, recoupez le rapprochement à l'aide des heures.
« The endpoints reported no RTP statistics. » : la qualité est alors No data. Ce n'est pas une erreur de l'appel.
L'avis relatif aux données CMR dans l'onglet Media / quality signifie qu'aucun CMR du CUCM n'est évalué. Les valeurs de qualité proviennent exclusivement des messages SIP des terminaux.
« This call no longer exists. » ou « This run no longer exists (deleted or expired). » : l'exécution a plus de 7 jours ou a été supprimée. Extrayez de nouveau la période tant que les traces existent encore sur le CUCM.
"The run did not read traces." : l'exécution a été lancée avec la seule source CDR. Extrayez de nouveau la période avec la source des traces ou cliquez sur Start a single diagnosis.
"The call flow was limited to … messages." : l'appel compte plus de 800 messages SIP. Le début est complet.
"The stored raw data of this call cannot be read." : les colonnes de la liste restent visibles, le flux d'appel et les données brutes manquent. Extrayez de nouveau la période.
"There is no call flow for this call." ou "The call flow could not be loaded." : dans le premier cas il n'y a pas de SIP, dans le second le serveur est injoignable. Rechargez la page.
"You do not have permission for this." : le compte ne dispose pas de ROLE_APP_CALL_DIAGNOSTICS, ou il s'agit d'un compte en lecture seule et l'action modifierait quelque chose.