Live Calls: laufende Anrufe im Cluster beobachten

Wozu dient das

Die Seite Aktive Anrufe zeigt, welche Gespräche im ausgewählten CUCM-Cluster gerade klingeln oder verbunden sind: Anrufer, Ziel, Geräte, Codec, Medienziel und Dauer. Sie brauchen sie, um einen gemeldeten Fehler während des Gesprächs zu beobachten oder um zu prüfen, ob ein Testanruf überhaupt im Cluster ankommt.

EasyUC verbindet sich dazu über JTAPI mit dem CTI Manager des CUCM und beobachtet alle CTI-fähigen Geräte. Die Geräte müssen dem Anwendungsbenutzer nicht einzeln als „Controlled Devices“ zugeordnet werden. Ein Hintergrundjob liest jede Minute über AXL, welche Geräte es gibt; der CTI-Dienst gleicht diese Liste alle 15 Sekunden ab. Geräte- und Leitungskonfigurationen im CUCM bleiben unverändert.

Für den Clusterbetrieb tragen Sie einen primären und einen sekundären CTI Manager ein. Fällt die Verbindung zum primären Knoten aus, nutzt JTAPI den sekundären. Es wird kein Audio aufgezeichnet und kein Gespräch mitgehört. Anrufe über den integrierten Teams-SBC erscheinen auf derselben Seite in einer eigenen Tabelle.

Voraussetzungen

Lizenzmodul cucm für die CUCM-Anrufe. Ohne CUCM-Modul zeigt die Seite nur die Anrufe über den integrierten SBC.
Der Menüpunkt ist ab Rolle ROLE_APP_USER sichtbar. Der Zugriff wird zusätzlich über das Integrationsrecht für Live Calls (Bereich Cisco) bzw. aktive Anrufe (Bereich ACD) geprüft. Speichern der Einrichtung erfordert Schreibrecht in diesem Bereich.
CTI Manager außerhalb der CUCM-Knoten der Verbindung darf nur ein Administrator eintragen.
Auf dem primären und dem sekundären Knoten läuft der Dienst Cisco CTIManager.
Die AXL-Verbindung der CUCM-Verbindung funktioniert. EasyUC legt darüber den Anwendungsbenutzer an und vergibt die Rollen.
An den Telefonen ist im CUCM Allow Control of Device from CTI aktiv. Geräte ohne diese Option sind nicht beobachtbar.

Schritt für Schritt: Live-Überwachung einrichten

Wählen Sie in der Kopfzeile die CUCM-Verbindung.
Öffnen Sie Live Calls.
Klicken Sie oben rechts auf Einrichtung. Der Bereich Live-Überwachung einrichten klappt auf.

Originalansicht zur Anleitung Zu Schritt 3
Die aufgeklappte Einrichtung gehört zur Live-Überwachung. Die Aufnahme zeigt die Konfiguration vor dem Start, keine bereits verbundenen Gesprächssitzungen.

EasyUC · Lab-/Demoumgebung
Live-Anrufe einrichten und gezielt filtern

Richten Sie die CUCM-Überwachung ein und nutzen Sie Suche und Filter für die verfügbaren CUCM- und SBC-Anrufe. Die Aufnahme zeigt die Einrichtungsansicht; die Live-Anrufabfrage ist im Lab noch nicht konfiguriert.
Tragen Sie unter Anwendungsbenutzer einen eigenen Benutzernamen für die Überwachung ein, zum Beispiel easyuc_livecalls.
Tragen Sie ein Passwort ein. Beim ersten Anlegen ist es Pflicht (1 bis 127 Zeichen). Später bleibt das gespeicherte Passwort erhalten, wenn Sie das Feld leer lassen.
Wählen Sie unter Primärer CTI Manager einen CUCM-Knoten aus der Vorschlagsliste.
Wählen Sie unter Sekundärer CTI Manager einen zweiten Knoten als Ersatz. Das Feld ist optional, im Cluster aber empfohlen.
Aktivieren Sie Alle Geräte überwachen.
Aktivieren Sie Live-Überwachung aktiviert.
Klicken Sie auf Speichern und anwenden. EasyUC zeigt das Ergebnis der Konfiguration und der AXL-Einrichtung in einer Zeile an.
Warten Sie einen Moment und prüfen Sie den Monitoring-Status über der Anrufliste. Der Verbindungsaufbau kann kurz dauern.

Schritt für Schritt: Laufende Anrufe und beobachtete Geräte prüfen

Öffnen Sie Live Calls. Die Zahl neben der Überschrift ist die Anzahl der angezeigten Anrufe.
Lassen Sie Auto-Aktualisierung eingeschaltet. Die Liste lädt dann alle 3 Sekunden neu. Mit Aktualisieren laden Sie sofort.
Tragen Sie unter Anrufe durchsuchen eine Rufnummer, einen Namen oder ein Gerät ein, um die Liste einzugrenzen.
Klicken Sie im Monitoring-Status auf Geräte anzeigen, um zu sehen, welche Geräte der CTI-Dienst tatsächlich beobachtet.
Suchen Sie dort unter Geräte suchen nach dem Gerätenamen und stellen Sie Status auf Fehlgeschlagen / nicht verbunden, um Problemgeräte zu finden.
Klicken Sie auf Monitoring-Details, um konfigurierte CTI Manager, Geräte mit deaktivierter CTI-Steuerung und Inventarfehler zu sehen.
Klicken Sie in der Tabelle Anrufe über den integrierten SBC auf eine Zeile, um den SIP-Verlauf dieses Teams-Anrufs zu öffnen.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Anwendungsbenutzer	CTI-Anwendungsbenutzer im CUCM, den EasyUC für die Überwachung anlegt bzw. verwendet. Pflichtfeld.
Passwort	Passwort dieses Benutzers. Wird nicht wieder angezeigt. Leer lassen behält das gespeicherte Passwort.
Primärer CTI Manager	Bevorzugter CUCM-Knoten. Hostname oder IPv4-Adresse ohne Port und ohne `https://`, höchstens 253 Zeichen. Pflichtfeld.
Sekundärer CTI Manager	Ersatzknoten bei Verbindungsverlust. Muss ein anderer Knoten sein als der primäre.
Alle Geräte überwachen	CTI-fähige Geräte automatisch erfassen, ohne einzelne „Controlled Devices“ zuzuordnen.
Live-Überwachung aktiviert	Schaltet die CTI-Verbindung für diesen CUCM-Cluster ein oder aus.
Auto-Aktualisierung	Lädt die Anrufliste alle 3 Sekunden und eine geöffnete Geräteliste etwa alle 15 Sekunden neu.
Geräteliste: Status	Beobachtet, Alle erfassten Geräte, Fehlgeschlagen / nicht verbunden oder Ausstehend.
Geräteliste: Pro Seite	24, 50 oder 100 Geräte.

So lesen Sie die Anzeige

So lesen Sie die Anzeige
Feld / Aktion	Bedeutung und Verwendung
Monitoring-Status	Zeigt in einem Satz den Zustand der Überwachung, darunter „… / … Geräte beobachtet“, die Uhrzeit des letzten Inventars und „Verbunden mit CTI Manager: …“ mit dem gerade genutzten Knoten sowie dem Ersatzknoten. Ein Warnsymbol bedeutet: nicht bereit oder Anrufdaten noch nicht bestätigt.
Status (Anruf)	Grüne Marke: Gespräch verbunden. Gelbe Marke: es klingelt. Blaue Marke: Anruf wird aufgebaut. Graue Marke: sonstiger Zustand.
Von (Anrufer) / Nach (Angerufener)	Nummer, darunter Anzeigename und Gerätename, soweit bekannt.
Codec / Medienziel	Vom CUCM über JTAPI gemeldeter Codec und die Medienadresse der Gegenseite. „Nicht gemeldet“ heißt: Der CUCM hat keinen Wert geliefert, nicht: es fließt kein Audio.
Erfasst / verbunden	Zeitpunkt, zu dem EasyUC den Anruf erfasst hat, und Zeitpunkt der Annahme. Bei Gesprächen, die schon vor dem Start der Überwachung liefen, ist es die Erfassungszeit, nicht der ursprüngliche Beginn.
Dauer	Laufende Dauer. Grün bei verbundenem Gespräch, sonst mit dem Zusatz „klingelt…“.
Geräteliste	Je Gerät Name, erkannter Typ (zum Beispiel Desktop-Client oder Telefon / CTI-Gerät) und Status Beobachtet, Fehlgeschlagen, Ausstehend oder Nicht verbunden. Beobachtet heißt, dass der Anrufbeobachter angehängt ist. Es sagt nichts über die Registrierung des Telefons.
Anrufe über den integrierten SBC	Teams-Anrufe mit Tenant, Anrufer, Ziel, Status (Klingelt, Verbindungsaufbau, Verbunden, Gehalten, Beendet), Codec und Dauer.

Ergebnis prüfen und Fehler eingrenzen

Erfolg erkennen Sie daran, dass der Monitoring-Status einen CTI Manager nennt, die Zahl der beobachteten Geräte dem Inventar entspricht und ein Testanruf innerhalb weniger Sekunden in der Liste erscheint.
Eine leere Liste ist nur dann ein bestätigtes „keine Anrufe“, wenn der Text „Aktuell laufen keine Anrufe.“ lautet. Bei „Noch keine bestätigten Anrufdaten verfügbar.“ prüfen Sie zuerst den Monitoring-Status.
„Live-Monitoring ist nicht eingerichtet. Bitte Einrichtung öffnen.“: Einrichtung wie oben durchführen.
„Noch keine Geräte beobachtet. Inventar und CTI-Berechtigungen prüfen.“: Prüfen Sie, ob Alle Geräte überwachen aktiv ist und ob die AXL-Einrichtung beim Speichern erfolgreich gemeldet wurde.
„Monitoring ist unvollständig. Nicht alle Geräte können über CTI beobachtet werden.“: Öffnen Sie Monitoring-Details. Dort steht, bei wie vielen Geräten die CTI-Steuerung im CUCM deaktiviert ist. EasyUC ändert diese Geräte nicht.
„Primärer und sekundärer CTI Manager müssen unterschiedliche Knoten sein.“: Zwei verschiedene Knoten wählen.
„Nur Administratoren dürfen CTI Manager außerhalb der CUCM-Knoten dieser Verbindung eintragen.“: Einen Knoten aus der Vorschlagsliste wählen oder einen Administrator bitten.
„Passwort ist erforderlich: Der CTI-Application-User kann in CUCM nicht ohne Passwort angelegt werden (1-127 Zeichen).“: Passwort eintragen.
„Die AXL-Verbindung zu dieser CUCM-Verbindung konnte nicht aufgebaut werden.“: CUCM-Verbindung und AXL-Zugang prüfen.
„JTAPI-Dienst nicht erreichbar (/jtapi).“: Der CTI-Dienst von EasyUC antwortet nicht. Prüfen Sie im EasyUC Manager, ob er läuft.
Nicht enthalten sind Geräte ohne CTI-Fähigkeit und reine Trunk- oder Gateway-Gespräche ohne beobachtbaren Endpunkt. Das ist eine Grenze von CUCM und JTAPI. Nutzen Sie dafür die Anrufdiagnose oder die Anrufanalyse.