Diagnostic et supervision
Live Calls : suivre les appels en cours dans le cluster
Configurez la surveillance CTI avec un CTI Manager principal et un secondaire, puis lisez la liste des appels.
Dans EasyUC : EasyUC Cisco → Live Calls (in the ACD area: Calls → Active Calls)
Les images proviennent du lab EasyUC. Les noms et valeurs sont des exemples. Toute différence de langue de l’interface est indiquée à côté de l’image.
À quoi cela sert
La page Active Calls montre quels appels sonnent ou sont connectés à cet instant dans le cluster CUCM sélectionné : appelant, destination, terminaux, codec, destination média et durée. Vous en avez besoin pour observer un incident signalé pendant que l'appel est en cours, ou pour vérifier si un appel de test atteint bien le cluster.
Pour cela, EasyUC se connecte au CTI Manager du CUCM via JTAPI et surveille tous les terminaux compatibles CTI. Il n'est pas nécessaire d'attribuer les terminaux un par un à l'utilisateur d'application en tant que « Controlled Devices ». Une tâche d'arrière-plan lit chaque minute les terminaux existants via AXL ; le service CTI rapproche cette liste toutes les 15 secondes. Les configurations de terminaux et de lignes dans le CUCM restent inchangées.
Pour un fonctionnement en cluster, vous saisissez un CTI Manager principal et un secondaire. Si la connexion au nœud principal est perdue, JTAPI utilise le secondaire. Aucun son n'est enregistré et aucun appel n'est écouté. Les appels passant par le SBC Teams intégré apparaissent sur la même page, dans un tableau distinct. Certaines parties de cette page sont libellées en allemand même dans l'interface anglaise ; ces libellés sont cités ici tels qu'ils s'affichent.
Prérequis
- Module de licence
cucmpour les appels CUCM. Sans le module CUCM, la page n'affiche que les appels passant par le SBC intégré. - L'entrée de menu est visible à partir du rôle
ROLE_APP_USER. L'accès est en outre contrôlé par l'autorisation d'intégration pour les appels en direct (zone Cisco) ou les appels actifs (zone ACD). L'enregistrement de la configuration exige l'autorisation d'écriture dans cette zone. - Seul un administrateur peut saisir un CTI Manager situé en dehors des nœuds CUCM de la connexion.
- Le service Cisco CTIManager est en cours d'exécution sur le nœud principal et sur le nœud secondaire.
- La connexion AXL de la connexion CUCM fonctionne. EasyUC l'utilise pour créer l'utilisateur d'application et attribuer les rôles.
- Allow Control of Device from CTI est activé sur les téléphones dans le CUCM. Les terminaux sans cette option ne peuvent pas être surveillés.
Pas à pas : configurer la surveillance en direct
Pas à pas : contrôler les appels en cours et les terminaux surveillés
Champs et options
| Champ / action | Signification et utilisation |
|---|---|
| Anwendungsbenutzer | Utilisateur d'application CTI dans le CUCM qu'EasyUC crée ou utilise pour la surveillance. Obligatoire. |
| Passwort | Mot de passe de cet utilisateur. Il n'est plus affiché ensuite. Si le champ reste vide, le mot de passe enregistré est conservé. |
| Primärer CTI Manager | Nœud CUCM préféré. Nom d'hôte ou adresse IPv4 sans port et sans https://, 253 caractères au plus. Obligatoire. |
| Sekundärer CTI Manager | Nœud de secours en cas de perte de connexion. Doit être un autre nœud que le principal. |
| Alle Geräte überwachen | Capte automatiquement les terminaux compatibles CTI sans attribuer individuellement des « Controlled Devices ». |
| Live-Überwachung aktiviert | Active ou désactive la connexion CTI pour ce cluster CUCM. |
| Auto-refresh | Recharge la liste des appels toutes les 3 secondes et une liste de terminaux ouverte environ toutes les 15 secondes. |
| Device list: Status | Beobachtet (surveillé), Alle erfassten Geräte (tous les terminaux captés), Fehlgeschlagen / nicht verbunden (échoué / non connecté) ou Ausstehend (en attente). |
| Device list: Pro Seite | 24, 50 ou 100 terminaux par page. |
Comment lire l'affichage
| Champ / action | Signification et utilisation |
|---|---|
| Monitoring status | Indique l'état de la surveillance en une phrase ; en dessous figurent le nombre de terminaux surveillés sur l'inventaire, l'heure du dernier inventaire et « Verbunden mit CTI Manager: … » avec le nœud actuellement utilisé et le nœud de secours. Une icône d'avertissement signifie : pas prêt, ou données d'appel pas encore confirmées. |
| Status (call) | Badge vert : appel connecté. Badge jaune : sonnerie. Badge bleu : appel en cours d'établissement. Badge gris : autre état. |
| From (Calling) / To (Called) | Numéro, avec en dessous le nom d'affichage et le nom du terminal lorsqu'ils sont connus. |
| Codec / Medienziel | Codec signalé par le CUCM via JTAPI et adresse média de l'extrémité distante. « Nicht gemeldet » (non signalé) signifie que le CUCM n'a fourni aucune valeur, et non qu'aucun son ne circule. |
| Erfasst / verbunden | Heure à laquelle EasyUC a capté l'appel et heure à laquelle il a été décroché. Pour les appels déjà en cours avant le début de la surveillance, il s'agit de l'heure de capture, et non du début d'origine. |
| Duration | Durée en cours. En vert pour un appel connecté, sinon avec la mention « ringing… ». |
| Device list | Par terminal : nom, type détecté (par exemple client de bureau ou téléphone / terminal CTI) et état Beobachtet, Fehlgeschlagen, Ausstehend ou Nicht verbunden. Beobachtet signifie que l'observateur d'appels est attaché. Cela ne dit rien de l'enregistrement du téléphone. |
| Calls over the integrated SBC | Appels Teams avec tenant, appelant, destination, état (Ringing, Call setup, Connected, On hold, Ended), codec et durée. |
Contrôler le résultat et circonscrire les erreurs
- Vous reconnaissez le succès lorsque l'état de la surveillance nomme un CTI Manager, que le nombre de terminaux surveillés correspond à l'inventaire et qu'un appel de test apparaît dans la liste en quelques secondes.
- Une liste vide ne confirme « aucun appel » que si le texte indique « No calls currently running. » S'il indique « Noch keine bestätigten Anrufdaten verfügbar. » (pas encore de données d'appel confirmées), vérifiez d'abord l'état de la surveillance.
- « Live-Monitoring ist nicht eingerichtet. Bitte Einrichtung öffnen. » : effectuez la configuration comme décrit ci-dessus.
- « Noch keine Geräte beobachtet. Inventar und CTI-Berechtigungen prüfen. » : vérifiez si Alle Geräte überwachen est actif et si la préparation AXL a été signalée comme réussie lors de l'enregistrement.
- « Monitoring ist unvollständig. Nicht alle Geräte können über CTI beobachtet werden. » : ouvrez Monitoring-Details. Le texte indique pour combien de terminaux le contrôle CTI est désactivé dans le CUCM. EasyUC ne modifie pas ces terminaux.
- « Primärer und sekundärer CTI Manager müssen unterschiedliche Knoten sein. » : choisissez deux nœuds différents.
- « Nur Administratoren dürfen CTI Manager außerhalb der CUCM-Knoten dieser Verbindung eintragen. » : choisissez un nœud dans la liste de suggestions ou demandez à un administrateur.
- « Passwort ist erforderlich: Der CTI-Application-User kann in CUCM nicht ohne Passwort angelegt werden (1-127 Zeichen). » : saisissez un mot de passe.
- « Die AXL-Verbindung zu dieser CUCM-Verbindung konnte nicht aufgebaut werden. » : vérifiez la connexion CUCM et l'accès AXL.
- « JTAPI-Dienst nicht erreichbar (/jtapi). » : le service CTI d'EasyUC ne répond pas. Vérifiez dans l'EasyUC Manager s'il est en cours d'exécution.
- Les terminaux sans capacité CTI et les appels purs de trunk ou de passerelle sans terminal surveillable ne sont pas inclus. C'est une limite du CUCM et de JTAPI. Utilisez pour cela le diagnostic d'appel ou l'analyse d'appels.