Anrufdiagnose: SIP-Ablauf eines einzelnen Anrufs

Wozu dient das

Die Anrufdiagnose beantwortet die Frage, was bei einem bestimmten Anruf auf Signalisierungsebene passiert ist. Sie wählen den Anruf in der Anrufliste (CDR) oder im CURRI-Log aus. EasyUC lädt dann die SDL-Traces des Dienstes Cisco CallManager von allen CallManager-Knoten des Clusters für genau diesen Zeitraum, sucht die SIP-Nachrichten dieses einen Anrufs heraus und zeigt sie als Ablaufdiagramm.

Damit entfällt das manuelle Sammeln und Durchsuchen der Trace-Dateien mit RTMT. Die Funktion liest nur vorhandene Trace-Dateien über die Log-Collection-Schnittstelle des CUCM. Sie ändert keine CUCM-Konfiguration und schaltet keine Traces ein.

Lief der Anruf über einen CUBE mit eingeschalteter Debug-Aufzeichnung, mischt EasyUC dessen SIP-Nachrichten in denselben Ablauf. Das geschieht nur für Benutzer mit Leserecht auf die CUBEs.

Voraussetzungen

Lizenzmodul cucm und eine funktionierende CUCM-Verbindung.
Rolle ROLE_APP_CALL_DIAGNOSTICS (im Rolleneditor „Analyze CUCM Calls“). Sie erlaubt Starten, Anzeigen und Exportieren und schließt die Seitenrolle ROLE_APP_VIEW_CALL_DIAGNOSTICS_PAGE sowie den lesenden Zugriff auf die Anrufliste ein.
Der AXL-Benutzer der CUCM-Verbindung hat im CUCM die Rollen Standard CCM Admin Users und Standard RealtimeAndTraceCollection. Fehlen sie, meldet der Knoten „Rolle fehlt“.
Am CUCM ist für den Dienst Cisco CallManager die Trace-Stufe Detailed mit Enable SIP Call Processing Trace eingestellt. Ohne diese Einstellung enthalten die Traces keine SIP-Nachrichten.
EasyUC erreicht jeden CallManager-Knoten unter seinem Namen aus dem CUCM über HTTPS (Port 8443).
Für den Einstieg über die Anrufliste: Der CDR-Import der Verbindung läuft. Für den Einstieg über CURRI: Der Anruf steht im CURRI-Log.
SSH-Zugangsdaten (Plattform-/OS-Administrator) sind für die Anrufdiagnose nicht nötig. Sie werden nur für „Details (SSH)“ der CUCM-Knoten gebraucht.
Der Hintergrunddienst für die Trace-Sammlung läuft. Er bearbeitet immer nur eine Sammlung zur selben Zeit.
Für Nachrichten des CUBE im Ablauf: Leserecht auf die CUBEs (ROLE_APP_GATEWAYS mit ROLE_APP_GATEWAYS_CUBE). Administratoren haben es immer.

Schritt für Schritt: Diagnose aus der Anrufliste starten

Wählen Sie in der Kopfzeile die CUCM-Verbindung, über die der Anruf lief.
Öffnen Sie Logs → Anrufdiagnose und klicken Sie auf Anruf auswählen. Sie gelangen in die Anrufliste unter Berichte → Nutzung & Erreichbarkeit → Anrufe.
Suchen Sie den Anruf über Zeitraum und Rufnummer.
Klicken Sie in der Zeile des Anrufs in der Spalte Anrufdiagnose auf Analysieren.
Prüfen Sie im Dialog Diesen Anruf analysieren die Zeitzone und das vorbelegte Zeitfenster. Es umfasst 60 Sekunden vor und nach dem Anruf.
Engen Sie das Fenster bei Bedarf über Start Zeit und End Zeit ein.
Klicken Sie auf Anrufanalyse starten. EasyUC öffnet die Detailseite der Diagnose.
Warten Sie, bis die Fortschrittsanzeige durchgelaufen ist. Sie zeigt nacheinander „CallManager-Knoten werden ermittelt“, „Trace-Dateien werden aufgelistet“, „Trace-Dateien werden geladen“, „SIP-Nachrichten werden zugeordnet“ und „Anrufablauf wird gespeichert“, dazu Knoten und Dateizähler.
Lesen Sie das Ergebnis im Reiter Anrufablauf.

Schritt für Schritt: Diagnose aus dem CURRI-Log starten

Öffnen Sie CURRI → Curri Logs.
Suchen Sie die Zeile des Anrufs.
Klicken Sie in der Spalte Anrufablauf auf das Diagramm-Symbol (SIP-Verlauf anzeigen).
EasyUC startet die Diagnose ohne weiteren Dialog und öffnet die Detailseite. Das Zeitfenster reicht von 60 Sekunden vor dem CURRI-Eintrag bis 10 Minuten danach.
Wurde dieselbe Zeile in den letzten 15 Minuten schon analysiert, öffnet EasyUC die vorhandene Diagnose statt eine neue zu starten.

Schritt für Schritt: Ergebnis exportieren und wiederfinden

Öffnen Sie Logs → Anrufdiagnose. Unter Letzte Analysen steht je Diagnose eine Karte mit Status, Quelle (CDR oder CURRI), Nummer der Diagnose, Anrufer, Ziel, Zeitpunkt und Gerät.
Klicken Sie auf eine Karte, um die Diagnose wieder zu öffnen.
Klicken Sie oben rechts auf SIP-Nachrichten (Text), Gefilterte Logs oder Analyse (JSON), um das Ergebnis herunterzuladen.
Klicken Sie im Reiter Anrufablauf auf SVG herunterladen, um das Diagramm als Bild zu speichern.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Zeitzone	Zeitzone, in der Sie das Zeitfenster angeben. Vorbelegt mit der Zeitzone Ihres Browsers.
Datumsbereich, Start Zeit, End Zeit	Zeitfenster der Trace-Sammlung. Vorbelegt mit Anrufbeginn minus 60 Sekunden bis Anrufende plus 60 Sekunden. Erlaubt sind eine Sekunde bis 30 Minuten.
Anrufanalyse starten	Legt die Diagnose an. Die Arbeit läuft im Hintergrund.
100 Trying ausblenden	Blendet im Diagramm die Zwischenantworten `100 Trying` aus.
NOTIFY, INFO und OPTIONS ausblenden	Blendet Nachrichten aus, die für den Verbindungsaufbau meist unwichtig sind.
In Nachrichten suchen	Zeigt nur Nachrichten, deren Text den Suchbegriff enthält, zum Beispiel eine Call-ID oder `488`.
Dialog-Schaltflächen über dem Diagramm	Jeder SIP-Dialog hat eine eigene Farbe. Ein Klick blendet den Dialog ein oder aus. Das Anker-Symbol markiert den Dialog, über den der Anruf gefunden wurde.
Reiter Anrufablauf	SIP-Ablaufdiagramm, Tabelle Weitere passende Anrufe und Tabelle CUCM-Knoten.
Reiter Ereignisse	Teilnehmer, Geräte und Adressen, gefundene Kennungen und die Liste Trace-Ereignisse mit Kategorie-Filter. Zu jedem Ereignis lässt sich über Gefilterte Rohzeile anzeigen die Trace-Zeile aufklappen.
SIP-Nachrichten (Text)	Export aller SIP-Nachrichten des Anrufs in zeitlicher Reihenfolge als Textdatei.
Gefilterte Logs	Export der Trace-Zeilen, die zu diesem Anruf gehören, im Original des CUCM.
Analyse (JSON)	Export des gesamten Ergebnisses in maschinenlesbarer Form: Teilnehmer, Dialoge, Nachrichten, Knoten und Hinweise.
SVG herunterladen	Speichert das Ablaufdiagramm mit den aktuell gesetzten Filtern als Vektorgrafik.
Hinweis „… Nachrichten durch die Filter ausgeblendet“	Zeigt, wie viele Nachrichten die Filter gerade verbergen. Ohne Treffer steht dort „Für diese Filter gibt es keine Nachrichten.“
Spur Expressway	Nachrichten von und zu einem Expressway erhalten eine eigene Spur mit dieser Bezeichnung.

So lesen Sie das Ablaufdiagramm

So lesen Sie das Ablaufdiagramm
Feld / Aktion	Bedeutung und Verwendung
Spalten (Spuren)	Jede Spur ist eine Gegenstelle: CUCM-Knoten, IP-Telefon, Jabber oder Webex App, Gateway / CUBE, SIP-Trunk, anderer CUCM-Cluster, Anrufbeantworter oder unbekanntes Gerät. Eine Spur entsteht je IP-Adresse. Geräte hinter derselben Adresse teilen sich eine Spur.
Zeit	Uhrzeit der Nachricht, darunter der Abstand zur vorherigen Nachricht.
Pfeile	Ein Pfeil ist eine SIP-Nachricht vom Absender zum Empfänger. Die Beschriftung nennt die Methode (zum Beispiel `INVITE`, `BYE`) oder den Antwortcode.
Farben der Pfeile	Blau: Anfrage. Grau: vorläufige Antwort 1xx. Grün: Erfolg 2xx. Orange: Umleitung 3xx. Rot: Fehler 4xx, 5xx oder 6xx.
Marke SDP	Die Nachricht enthält eine Medienbeschreibung. In der Nachrichtenansicht stehen Codec- und Adresszeilen; SRTP kennzeichnet verschlüsselte Medien.
Farbiger Balken neben der Zeit	Zeigt, zu welchem Dialog die Nachricht gehört.
Klick auf eine Nachricht	Öffnet die Nachrichtenansicht mit Zeit, Zeit auf dem Knoten, Transport, CSeq, Call-ID, Zugeordnet über, Trace-Datei und dem Nachrichtentext. Kopieren übernimmt den Text in die Zwischenablage. Zugangsdaten und SRTP-Schlüssel sind entfernt, lange Nachrichten auf 8 KB gekürzt.
Zugeordnet über	Sagt, woran EasyUC den Anruf erkannt hat: SIP-Call-ID aus dem CDR, anrufende und angerufene Nummer, Diversion (Umleitung), angerufene Nummer, nur anrufende Nummer oder Call-ID bzw. Cisco-Guid aus der CUBE-Debug-Aufzeichnung.
Kacheln SIP-Nachrichten, Dialoge, CUCM-Knoten	Anzahl der Nachrichten dieses Anrufs, Anzahl der Dialoge und Teilnehmer, Anzahl der gelesenen Knoten und Trace-Dateien.
Kachel Status	Abgeschlossen: alle Knoten gelesen, Anruf gefunden. Teilweise: verwertbares Ergebnis, aber eine Grenze wurde erreicht oder ein Knoten fehlt. Keine Treffer: Traces gelesen, aber kein passender SIP-Dialog.
Tabelle CUCM-Knoten	Je Knoten: Host, Zahl der Trace-Dateien und SIP-Nachrichten, Zeitzone und Status. Bei einem Fehler steht der Grund darunter, zum Beispiel „Rolle fehlt“, „TLS-Fehler (Zertifikat geändert?)“, „Nicht erreichbar“ oder „Keine Trace-Dateien“.
Weitere passende Anrufe	Andere Anrufe, die zur selben Zeit ebenfalls zu den Rufnummern passen. Das Diagramm zeigt den zeitlich nächsten.
Status der Karten in der Übersicht	Analyse läuft, Abgeschlossen, Teilweise, Keine Trace-Dateien oder Fehler.

Ergebnis prüfen und Fehler eingrenzen

Erfolg erkennen Sie am Status Abgeschlossen und an einem Diagramm, das mit INVITE beginnt und mit BYE oder einer Fehlerantwort endet.
„Die Traces enthalten keine SIP-Nachrichten. Stelle den Trace-Level des Dienstes Cisco CallManager auf „Detailed“ und aktiviere „Enable SIP Call Processing Trace“.“: Trace-Einstellung am CUCM auf allen CallManager-Knoten korrigieren und den Anruf wiederholen.
„Der Anruf ist älter als zwei Stunden; seine Traces wurden auf dem CUCM eventuell schon überschrieben.“: Der CUCM rotiert seine Trace-Dateien. Starten Sie die Diagnose möglichst bald nach dem Anruf.
„Rolle fehlt: Der AXL-Benutzer braucht „Standard CCM Admin Users“ und „Standard RealtimeAndTraceCollection““: Rollen des AXL-Benutzers im CUCM ergänzen.
„Nur die anrufende Nummer passte; der Anrufablauf kann zu einem anderen Anruf dieses Anrufers gehören.“: Vergleichen Sie Uhrzeit und Ziel und prüfen Sie die Tabelle Weitere passende Anrufe.
„Der Anruf lief noch, als die Traces gelesen wurden; der Anrufablauf endet an dieser Stelle.“: Diagnose nach Gesprächsende erneut starten.
„Auf dieser CUCM-Verbindung läuft bereits eine Anrufdiagnose“: Je CUCM-Verbindung läuft eine Diagnose zur selben Zeit. EasyUC öffnet die laufende. Weitere Diagnosen warten in der Reihenfolge ihres Starts.
„Die Analyse wurde nicht abgeschlossen: Der Hintergrunddienst hat sich seit 10 Minuten nicht gemeldet.“ oder „… seit einer Stunde nicht übernommen“: Der Hintergrunddienst für die Trace-Sammlung arbeitet nicht. Diagnose erneut starten und bei Wiederholung den Betrieb der Worker prüfen.
„Das Zeitfenster der Anrufdiagnose muss zwischen einer Sekunde und 30 Minuten liegen.“: Fenster über Start Zeit und End Zeit verkleinern.
Grenzen je Diagnose: höchstens 8 CallManager-Knoten, 12 Trace-Dateien je Knoten, 64 MiB je Datei und 800 Nachrichten im Diagramm. Wird eine Grenze erreicht, bleibt das Ergebnis sichtbar und erhält den Status Teilweise mit einem Hinweis.
Zeigt das Diagramm den CUBE nicht, obwohl der Anruf darüber lief: Die Hinweise nennen den Grund, zum Beispiel „dessen Debug-Aufzeichnung aber ausgeschaltet ist“ oder „wird … Tage aufbewahrt; der Anruf ist älter“.
„Die CUCM-Knotenliste war nicht verfügbar; es wurde nur der AXL-Host durchsucht.“: EasyUC konnte die Knoten des Clusters nicht ermitteln. Lief der Anruf über einen anderen Knoten, fehlt er. AXL-Zugang prüfen.
„Die Zeitzone von … ist unbekannt; es wird UTC angenommen.“: Die Zeiten dieses Knotens können verschoben sein. Vergleichen Sie mit den Zeiten der anderen Knoten.
„Die Traces auf … beginnen erst nach dem Anrufbeginn; der Anfang kann fehlen.“ und „Der CUCM hat für die Zeit des Anrufs keine SDL-Trace-Dateien geliefert.“: Die Traces sind bereits überschrieben.
„Auf … decken mehr Trace-Dateien den Anruf ab als die Grenze von …; das Ende des Anrufs kann fehlen.“ und „Die Trace-Analyse wurde nach … MiB Trace-Daten beendet.“: Zeitfenster verkleinern.
„Mehr als … SIP-Nachrichten im Zeitfenster des Anrufs; spätere Nachrichten wurden ignoriert.“ und „Der Anrufablauf wurde auf … Nachrichten begrenzt.“: Das Zeitfenster ist für den Verkehr auf dem Cluster zu groß. Verkleinern.
„Die Traces enthalten SIP-Nachrichten, aber keine zur Zeit des Anrufs (überschriebene Traces oder ein Zeitzonen-Versatz).“: Zeitzone im Dialog und Uhrzeit des CUCM prüfen.
„Kein SIP-Dialog in den Traces passt zu den Rufnummern und der Zeit des Anrufs.“: Der Anruf lief nicht über SIP, oder die Nummern wurden vor dem Knoten umgeschrieben. Zeitfenster erweitern.
Hinweise zum CUBE: „Die Debug-Aufzeichnung des CUBE … enthält keine SIP-Nachrichten dieses Anrufs.“, „Die CUBE-Debug-Aufzeichnung konnte nicht gelesen werden; der Anrufablauf zeigt nur die CUCM-Traces.“ und „… konnte nur teilweise gelesen werden“. Der Ablauf aus den CUCM-Traces bleibt in allen Fällen gültig.
Entfernt werden vor der Anzeige und in allen Exporten Zugangsdaten und SRTP-Schlüssel. Die Funktion liest nur und ändert nichts am CUCM.