Analyse d'appels : extraire tous les appels d'une période

À quoi cela sert

L'analyse d'appels extrait tous les appels d'une période pour une connexion CUCM et les présente sous forme de liste. Vous en avez besoin lorsque l'appel concerné n'est pas encore connu : « des appels n'ont pas abouti entre 10h00 et 10h30 ». Le diagnostic d'appel, à l'inverse, examine un seul appel déjà identifié.

Une telle extraction s'appelle une exécution (run). Elle combine deux sources. Les CDR fournissent la liste complète des appels terminés avec heures, numéros, terminaux et causes. Les traces SDL des nœuds CallManager fournissent les messages SIP et donc le flux d'appel, y compris pour les appels non aboutis ou encore en cours. Si une source manque, la liste est construite à partir de l'autre, avec un avis sur l'exécution.

L'exécution travaille en arrière-plan, puis elle est conservée 7 jours. Pendant ce temps, vous pouvez ouvrir le résultat aussi souvent que vous le souhaitez sans interroger à nouveau le CUCM. Sans la source des traces, le CUCM n'est pas sollicité du tout.

Prérequis

• Module de licence cucm. La fonction est décrite telle qu'elle fonctionne sur le système de laboratoire (entrée de menu Logs → Call Analysis).
• Rôle ROLE_APP_CALL_DIAGNOSTICS avec le rôle de page ROLE_APP_VIEW_CALL_DIAGNOSTICS_PAGE. Les comptes en lecture seule peuvent consulter et exporter les exécutions enregistrées, mais pas lancer, annuler ni supprimer d'exécutions.
• Le compte n'est pas limité à des sites. L'analyse affiche tous les appels du cluster et n'est pas disponible pour les comptes limités à des sites.
• Pour la liste des appels terminés : l'import CDR de la connexion CUCM est activé.
• Pour les flux d'appel : sur le CUCM, Cisco CallManager utilise le niveau de trace Detailed avec Enable SIP Call Processing Trace.
• Pour les flux d'appel : l'utilisateur AXL de la connexion possède les rôles CUCM Standard CCM Admin Users et Standard RealtimeAndTraceCollection.
• Au moins 256 MiB d'espace disque sont libres sur le serveur EasyUC pour l'exécution.

Pas à pas : extraire des appels

1. Sélectionnez la connexion CUCM dans l'en-tête. La page l'affiche en haut à droite sous CUCM connection.
2. Ouvrez Logs → Call Analysis.
3. Dans la zone Pull calls, choisissez une sélection rapide sous Period : Last 15 minutes, Last 30 minutes ou Last 60 minutes.
4. Pour une autre fenêtre, cliquez sur Custom period et saisissez From et To.
5. Sous Data sources, sélectionnez CDRs (finished calls) et Call flows from CUCM traces (SIP). Au moins une source doit être sélectionnée.
6. Si nécessaire, ouvrez Filters (optional) et saisissez un Number ou un Device name pour ne conserver que les appels correspondants.
7. Lisez les indications sous le bouton. Elles précisent la durée autorisée et l'actualité des CDR, par exemple « CDRs are available up to …. Later calls come from the traces only. »
8. Cliquez sur Pull calls. EasyUC crée l'exécution et ouvre sa page.
9. Suivez la progression. L'affichage indique la phase (« Reading CDRs », « Downloading and reading trace files », « Combining calls » …), le nœud, le compteur de fichiers ainsi que les CDR et messages SIP lus jusqu'ici.
10. Lorsque l'exécution est terminée, la page affiche la liste des appels. Le chapitre sur la liste des appels poursuit à partir de là.

Pas à pas : annuler, rouvrir ou supprimer une exécution

1. Pour arrêter une exécution en cours, cliquez sur Cancel run sur sa page. Une exécution annulée n'enregistre aucun appel.
2. Pour ouvrir un résultat antérieur, ouvrez Logs → Call Analysis et cliquez sur la ligne sous Stored runs.
3. Pour répéter la même période avec des CDR plus récents, cliquez sur Pull this period again sur la page de l'exécution.
4. Pour supprimer une exécution, cliquez sur l'icône de corbeille dans sa ligne et confirmez Delete this run with all its stored calls?. Une exécution en cours doit d'abord être annulée.

Champs et options

Comment lire la page d'une exécution

Contrôler le résultat et circonscrire les erreurs

• Vous reconnaissez le succès à l'état Completed et au fait que le nombre sous With call flow correspond au nombre d'appels SIP de la période.
• « A run is already active for this connection. » : une seule exécution à la fois par connexion. Open the active run vous y conduit.
• « Several runs are already waiting. Please try again later. » : trois exécutions au plus sont actives en même temps au total.
• « The run is waiting. If another diagnosis is running, it starts afterwards. » : les collectes de traces s'exécutent l'une après l'autre, y compris par rapport aux diagnostics d'appel.
• « The period must not be longer than … minutes. » ou « The period must be at least … seconds long. » : ajustez la période ou désélectionnez la source des traces.
• « Call analysis shows all calls of the cluster and is not available to accounts restricted to locations. » : utilisez un compte sans restriction de sites.
• « There is not enough free disk space on the server for a run. » : supprimez d'anciennes exécutions et contrôlez la page de stockage.
• « The traces contain no SIP messages. Set the trace level "Detailed" with "Enable SIP Call Processing Trace". » : corrigez le réglage de trace sur le CUCM.
• « Node … could not be read (role missing) » : ajoutez les rôles CUCM à l'utilisateur AXL. Pour « TLS error » ou « not reachable », vérifiez le certificat et le chemin réseau vers le nœud.
• « CDR import is off for this connection. The list comes from the traces only. » : configurez l'import CDR sur la connexion CUCM si vous souhaitez voir les appels terminés de façon complète.
• Les exécutions échouées indiquent la raison, par exemple « The worker stopped responding. » ou « The run was not started in time. » Dans ce cas, vérifiez les services d'arrière-plan.
• Limites de protection par exécution : 40 fichiers de trace par nœud et 120 au total, 40 000 messages SIP, 20 000 lignes CDR, 10 000 appels, 10 minutes de lecture des traces et 15 minutes de durée totale d'exécution.
• "The period is … hours old; the traces may already be overwritten on the CUCM." : l'exécution essaie malgré tout. Si les flux d'appel manquent, la liste issue des CDR demeure.
• "More than … CDRs in the period; the rest is missing. Choose a shorter period." et "More than … calls in the period; the list is cut off. Choose a shorter period or a filter." : une limite de protection a été atteinte.
• "More than … SIP messages in the period; later ones are missing. Choose a shorter period.", "Reading the traces stopped after … seconds." et "The worker's memory limit was reached; later SIP messages are missing." : sur un cluster très sollicité, la limite ne suffit pas pour 60 minutes. L'avis "Call flows were read only for … – …." indique la plage couverte.
• "… calls began before the period and are not listed." : un appel appartient à l'exécution s'il a commencé dans la période. Faites commencer la période plus tôt.
• "The devices could not be resolved; the call flow shows addresses." : les voies portent alors des adresses IP au lieu des noms de terminaux. Le flux lui-même est complet.
• "Run filter: … calls kept, … dropped." : confirme l'effet des filtres Number et Device name.
• Autres raisons d'échec d'une exécution : "The CUCM connection is not available.", "The result could not be stored.", "The run could not be handed to the worker." et "Internal error. See the worker log for details."
• Une exécution sans signe de vie est considérée comme échouée après 5 minutes, une exécution en attente après 60 minutes.