Teams-Anrufe, SIP-Verlauf und Mitschnitte

Wozu dient das

Wenn ein Anruf aus Teams nicht ankommt, zu früh endet oder keinen Ton hat, brauchen Sie den genauen Ablauf. EasyUC bietet dafür vier Werkzeuge mit steigender Tiefe: die Liste der laufenden Anrufe, den Anrufverlauf mit SIP-Leiterdiagramm je Anruf, den SIP-Mitschnitt des ganzen Tenants und den Netzwerk-Mitschnitt als pcap-Datei.

Der Anrufverlauf speichert zu jedem Anruf alle SIP-Nachrichten zwischen Microsoft und dem EasyUC-SBC, ohne die regelmäßigen OPTIONS. Das Leiterdiagramm zeigt sie in zeitlicher Reihenfolge mit Pfeilen. So sehen Sie auf einen Blick, wer welche Antwort gegeben hat. Schlüssel für die Sprachverschlüsselung werden vor dem Speichern unkenntlich gemacht.

Der SIP-Mitschnitt zeichnet zusätzlich die OPTIONS und alles Übrige des Tenants auf. Der Netzwerk-Mitschnitt schreibt die Pakete selbst mit. Die Strecke zu Microsoft ist darin verschlüsselt und nicht lesbar; lesbar ist nur die interne Strecke zwischen SBC und EasyUC.

Voraussetzungen

Lizenzmodul teams. Ohne dieses Modul erscheint der Workspace EasyUC Teams nicht.
Rolle EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) mit dem Unterrecht TENANTS (ROLE_APP_TEAMS_TENANTS). Zum Schalten und Löschen zusätzlich TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT).
Für den SIP-Verlauf vergangener Anrufe: SIP-Verlauf jedes Anrufs speichern war zum Zeitpunkt des Anrufs eingeschaltet, und die Aufbewahrungszeit ist nicht abgelaufen.
Für den Netzwerk-Mitschnitt: Der SBC-Dienst läuft und meldet sich. Es laufen höchstens zwei Netzwerk-Mitschnitte gleichzeitig auf dem SBC.
Zum Auswerten einer pcap-Datei ein Programm wie Wireshark.

Schritt für Schritt: Einen Anruf im Anrufverlauf untersuchen

Öffnen Sie Teams-Tenants, klicken Sie auf den Tenant und wählen Sie in der Tenant-Leiste Anrufverlauf. Die Seite öffnet sich gefiltert auf diesen Tenant.
Grenzen Sie mit Datum von und Datum bis den Zeitraum ein.
Wählen Sie unter Richtung eingehend oder ausgehend.
Tippen Sie in Suche die Nummer, die gewählte Nummer, die Call-ID oder die UUID ein und bestätigen Sie mit der Lupe.
Klicken Sie auf die Zeile des Anrufs. Die Seite SIP-Verlauf öffnet sich.
Lesen Sie den Kopf: Tenant, Richtung, Von, Bis, gegebenenfalls Pilot, Zustand, Codec, Gegenstelle (IP), Start, Dauer und SIP Call-ID.
Lesen Sie das Leiterdiagramm von oben nach unten. Links steht Microsoft, rechts der EasyUC-SBC. Nachrichten mit SDP tragen das Etikett SDP.
Klicken Sie auf eine Nachricht, um ihren Inhalt zu sehen. Mit den Pfeiltasten wechseln Sie die Auswahl. Kopieren übernimmt den Text in die Zwischenablage.
Klicken Sie SIP-Verlauf herunterladen (.txt), wenn Sie den Ablauf weitergeben wollen.

Schritt für Schritt: Laufende Anrufe beobachten

Wählen Sie in der Tenant-Leiste Anrufe anzeigen. Die Zahl am Menüpunkt nennt die laufenden Anrufe.
Lesen Sie je Anruf Richtung, Von, Bis, Zustand, Codec, Gegenstelle, Dauer und Call-ID.
Klicken Sie auf eine Zeile. Der SIP-Verlauf öffnet sich und aktualisiert sich alle 2 Sekunden, solange der Anruf läuft.
Steht dort „Gerade läuft kein Anruf über diesen Trunk.“, lösen Sie den Testanruf aus und warten einen Moment.

Schritt für Schritt: SIP-Mitschnitt des Tenants aufzeichnen

Klicken Sie in der Kopfzeile der Tenant-Seite SIP-Mitschnitt starten. Der Hinweis SIP-Mitschnitt läuft erscheint mit der Endzeit. Der Mitschnitt endet nach 30 Minuten von selbst.
Führen Sie den Testanruf durch.
Wählen Sie in der Tenant-Leiste SIP-Log.
Tippen Sie in Filter zum Beispiel INVITE, eine Nummer oder eine Call-ID ein.
Klicken Sie auf einen Eintrag, um die vollständige Nachricht aufzuklappen.
Klicken Sie Log herunterladen für eine Textdatei oder pcap exportieren (TranslatorX/Wireshark) für eine pcap-Datei. Grenzt der Filter auf eine Call-ID ein, enthält die pcap-Datei nur dieses Gespräch.
Klicken Sie in der Kopfzeile Mitschnitt beenden, wenn Sie fertig sind. Mit Leeren löschen Sie das Log des Tenants.

Schritt für Schritt: Netzwerk-Mitschnitt (pcap) aufzeichnen

Wählen Sie in der Tenant-Leiste Mitschnitte.
Wählen Sie unter Mitschneiden für die Dauer: 5, 10, 15, 30 oder 60 Minuten.
Wählen Sie unter Höchstens die Dateigröße: 50, 100, 200 oder 500 MB.
Setzen Sie den Haken Interne Strecke zu EasyUC mitschneiden nur, wenn Sie SIP und Ton im Klartext brauchen. Lesen Sie den Warnhinweis: Die Datei enthält dann die Gespräche aller Tenants dieses SBC.
Klicken Sie Netzwerk-Mitschnitt starten und bestätigen Sie gegebenenfalls die Rückfrage.
Warten Sie auf Netzwerk-Mitschnitt läuft und führen Sie den Testanruf durch.
Klicken Sie Netzwerk-Mitschnitt beenden oder warten Sie das Ende ab.
Die Datei erscheint in der Liste, sobald der SBC sie übertragen hat. Solange steht dort Wird übertragen.
Klicken Sie auf das Download-Symbol der Zeile. Mit dem Papierkorb-Symbol löschen Sie die Datei.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Letztes OPTIONS	Zeitpunkt der letzten SIP-OPTIONS von Microsoft an diesem Tenant. Steht in der Kopfzeile der Tenant-Seite.
Bis	Die gewählte Nummer. Bei Operator Connect über Teams-Weiterleitung ist das die Operator-Connect-Nummer; die Pilotnummer steht als Zusatz „über Pilot …“ darunter.
Zustand	Zustand des Anrufs. Laufende Anrufe tragen im Verlauf das Etikett Live.
SIP-Nachrichten	Anzahl der zu diesem Anruf gespeicherten SIP-Nachrichten. 0 bedeutet: SIP-Verlauf war aus oder ist bereits gelöscht.
SIP-Mitschnitt starten / Mitschnitt beenden	Schreibt jede SIP-Nachricht dieses Tenants in die Datenbank, auch OPTIONS. Läuft 30 Minuten. Das Log behält höchstens die neuesten 20 000 Nachrichten je Tenant.
Netzwerk-Mitschnitt starten / beenden	Schreibt die SIP- und RTP-Ports dieses Tenants und die TLS-Verbindungen aller Tenants zu Microsoft in eine pcap-Datei. Dauer 1 bis 60 Minuten, Größe 1 bis 500 MB, Vorgabe 15 Minuten und 200 MB.
Interne Strecke zu EasyUC mitschneiden	Nimmt zusätzlich die unverschlüsselte Strecke zwischen SBC und EasyUC auf. Nur damit sind SIP und Ton in Wireshark lesbar.
Belegter Speicher	Speicher für Aufnahmen und Mitschnitte dieses Tenants, begrenzt auf 1 GB. Daneben der gemeinsame Speicher aller Tenants.
Mitschnitt-Liste	Gestartet, Beendet, Dauer, Dateigröße, Pakete. Mitschnitte werden nach 7 Tagen automatisch gelöscht.
Anrufverlauf: Suche und Filter	Die Suche findet Anrufer, Ziel, gewählte Nummer, Call-ID und UUID. Dazu Datum von, Datum bis und Richtung. Neueste Anrufe stehen oben.
SIP-Verlauf jedes Anrufs speichern	Schalter in den Tenant-Einstellungen, Vorgabe ein. Gespeichert werden alle SIP-Nachrichten eines Anrufs zwischen Microsoft und dem SBC, ohne OPTIONS.
Anrufverlauf aufbewahren (Tage)	1 bis 365 Tage, Vorgabe 14. Ältere Anrufe und ihre SIP-Nachrichten werden gelöscht.
Leiterdiagramm: Aufbau	Links die Zeit mit Millisekunden, dann die Spur Microsoft mit der Adresse der Gegenstelle und rechts die Spur EasyUC SBC. Ein Pfeil nach rechts kommt von Microsoft, ein Pfeil nach links geht zu Microsoft. Antworten tragen Code und Text, zum Beispiel `200 OK`.
SIP-Verlauf herunterladen (.txt)	Textdatei mit allen Nachrichten des Anrufs. Weicht die gewählte Nummer vom Ziel ab, nennt die Datei beide.
Nicht enthalten	Die interne Strecke zwischen dem SBC und der Script-Laufzeit von EasyUC wird im Anrufverlauf nicht aufgezeichnet. Dafür dient der Netzwerk-Mitschnitt mit interner Strecke.
Schlüssel	SRTP-Schlüssel werden vor dem Speichern unkenntlich gemacht, im Anrufverlauf wie im SIP-Log.

Ergebnis prüfen und Fehler eingrenzen

Erfolg: Der Testanruf steht im Anrufverlauf, und das Leiterdiagramm zeigt INVITE, 200 OK und BYE.
Der Anruf fehlt im Anrufverlauf: Teams hat ihn nicht über den EasyUC-Trunk geschickt. Prüfen Sie, ob dem Anrufer die EasyUC-Richtlinie zugewiesen ist, ob die Nummer unter Scripts über diesen Trunk als Erreichbar steht und ob Routen in Teams Aktuell zeigt.
„Für diesen Tenant wird kein SIP-Verlauf gespeichert“ Schalten Sie in den Tenant-Einstellungen SIP-Verlauf jedes Anrufs speichern ein. Gespeichert werden Anrufe, die danach beginnen.
„Zu diesem Anruf wurden keine SIP-Nachrichten gespeichert.“ Der Verlauf war beim Anruf aus oder ist nach der Aufbewahrungszeit gelöscht.
Kein Ton oder Ton nur in eine Richtung: Prüfen Sie Öffentliche IP und Media-IP auf der SBC-Seite und die UDP-Freigabe des RTP-Bereichs. Erfolgreiche OPTIONS belegen nur den Signalisierungsweg.
Anruf endet etwa 10 Sekunden nach der Annahme ohne Ton: Die Script-Laufzeit liefert keine Sprache an den SBC. Prüfen Sie, ob das Script aktiv ist und der Dienst für die Script-Laufzeit läuft.
Teams meldet sofort einen fehlgeschlagenen Anruf auf eine Script-Nummer: Das Script ist unbekannt, abgeschaltet oder nicht Über MS Teams erreichbar, oder die Script-Laufzeit antwortet nicht.
„Der SBC hat den Netzwerk-Mitschnitt noch nicht bestätigt.“ oder „Netzwerk-Mitschnitt nicht verfügbar: …“ Der SBC-Dienst meldet sich nicht oder der Mitschnitt-Teil läuft nicht. Prüfen Sie den Dienst im EasyUC Manager.
„Es laufen bereits 2 Netzwerk-Mitschnitte auf anderen Tenants. Bitte einen davon beenden oder sein Ende abwarten.“ Beenden Sie einen laufenden Mitschnitt.
„Der SIP-Mitschnitt ist aus. Oben einschalten, um aufzuzeichnen, was über diesen Trunk läuft.“ Das SIP-Log ist leer, solange kein Mitschnitt lief.
Mitschnitte enthalten Rufnummern und mit interner Strecke Gesprächsinhalte. Geben Sie sie nur an den vorgesehenen Empfänger weiter.
Ein laufender Anruf gilt als beendet, wenn der SBC ihn zwei Minuten lang nicht mehr gemeldet hat. Bis dahin trägt er das Etikett Live.
Bei Operator Connect über Teams-Weiterleitung zeigt das INVITE im Leiterdiagramm den Header History-Info mit der Operator-Connect-Nummer. Der Anrufverlauf speichert damit auch den Anmeldenamen des weiterleitenden Dienstkontos. Er unterliegt derselben Aufbewahrungszeit.
Ablauf lesen wie im Kapitel zum SIP-Ablaufdiagramm: erstes INVITE, letzte Antwort darauf, BYE. Eine rote Antwort vom SBC nennt den Grund auf EasyUC-Seite, eine rote Antwort von Microsoft den Grund im Tenant.