Freigeben über

Übersicht über Azure Communication Services-Anrufprotokolle

  • Artikel

Azure Communication Services bietet Protokollierungsfunktionen, mit denen Sie Ihre Communication Services-Lösung überwachen und debuggen können. Diese Funktionen können über das Azure-Portal konfiguriert werden.

Der Inhalt dieses Artikels bezieht sich auf Protokolle, die über Azure Monitor aktiviert werden (siehe dazu auch FAQ). Informationen zum Aktivieren dieser Protokolle für Communication Services finden Sie unter Aktivieren der Protokollierung in den Diagnoseeinstellungen.

Wichtig

Sie müssen Protokolle sammeln, wenn Sie sie analysieren möchten. Weitere Informationen finden Sie unter: Wie speichere ich Protokolle?

Azure speichert Ihre Anruflistendaten nur, wenn Sie diese spezifischen Diagnoseeinstellungen aktivieren. Ihre Anrufdaten sind nicht rückwirkend verfügbar. Sie erfassen die Daten, nachdem Sie die Diagnoseeinstellungen erstellt haben.

Verwenden von Anrufprotokollen

Es wird empfohlen, alle verfügbaren Anrufprotokolle in einer Protokollanalyseressource zu sammeln, damit Sie Ihre Anrufnutzung überwachen, die Anrufqualität verbessern und neue Protokolle von Azure Communication Services erhalten können, wenn sie veröffentlicht werden.

Es gibt zwei Haupttools, mit denen Sie Ihre Anrufe überwachen und die Anrufqualität verbessern können.

Es wird empfohlen, das „Einblicke in Sprache und Video“-Dashboard zu verwenden, um qualitätsbezogene Untersuchungen zu starten, und bei Bedarf die Anrufdiagnose zu verwenden, um einzelne Anrufe zu untersuchen, wenn Sie präzise Details benötigen.

Verfügbare Protokolle

Azure Communication Services erstellt acht Anrufprotokolle:

Protokolle für Updates der Anrufzusammenfassung:

Diese Protokolldaten werden in Azure Monitor schneller als die Protokolle der Anrufzusammenfassung empfangen, und es wird empfohlen, diese Protokolle anstelle des Protokollschemas der Anrufzusammenfassung zu verwenden. Dieses Protokoll enthält grundlegende Informationen zum Anruf, einschließlich aller relevanten IDs, Zeitstempel, Endpunkte und SDK-Informationen.

Weitere Informationen finden Sie unter: Protokollschema für Updates der Anrufzusammenfassung

Protokolle der Anrufzusammenfassung :

Dieses Protokoll ist eine Teilmenge des Protokollschemas für Updates der Anrufzusammenfassung. Es enthält grundlegende Informationen zum Anruf, einschließlich aller relevanten IDs, Zeitstempel, Endpunkte und SDK-Informationen. Verwenden Sie stattdessen die Protokolle für Updates der Anrufzusammenfassung, um eine schnellere Protokolllatenz zu erhalten.

Weitere Informationen finden Sie unter: Protokollschema der Anrufzusammenfassung

Protokolle für Updates der Anrufdiagnose:

Diese Protokolldaten werden in Azure Monitor schneller als die Protokolle der Anrufdiagnose empfangen, und es wird empfohlen, diese Protokolle anstelle des Protokollschemas der Anrufdiagnose zu verwenden. Dieses Protokoll enthält Informationen zum Mediendatenstrom des Anrufs eines Teilnehmers sowie eine Reihe von Metriken, die Messungen im Zusammenhang mit der Erlebnisqualität anzeigen.

Weitere Informationen finden Sie unter: Protokollschema für Updates der Anrufdiagnose

Protokolle der Anrufdiagnose:

Dieses Protokoll ist eine Teilmenge des Protokollschemas für Updates der Anrufdiagnose. Es enthält Informationen zum Datenstrom sowie eine Reihe von Metriken, die Messungen im Zusammenhang mit der Erlebnisqualität anzeigen. Verwenden Sie stattdessen die Protokolle für Updates der Anrufzusammenfassung, um eine schnellere Protokolllatenz zu erhalten.

Weitere Informationen finden Sie unter: Protokollschema der Anrufdiagnose

Vorgangsprotokoll des Anrufclients:

Enthalten detaillierte Anrufclientereignisse. Diese Protokollereignisse werden für jeden Endpunkt (EndpointId) in einem Anruf generiert. Die Anzahl der generierten Ereignisprotokolle hängt von den Vorgängen ab, die die teilnehmende Person während des Anrufs ausgeführt hat.

Weitere Informationen finden Sie unter: Protokollschema für Vorgänge des Anrufclients

Protokolle für Medienstatistiken des Anrufclients:

Enthält detaillierte Mediendatenstromwerte. Diese Protokolle werden für jeden Mediendatenstrom in einem Anruf generiert. Für jede EndpointId in einem Anruf (einschließlich des Servers) erstellt Azure Communication Services ein eigenes Protokoll für jeden Mediendatenstrom (z. B. Audio oder Video) zwischen Endpunkten. Die in jedem Protokoll generierte Datenmenge hängt von der Dauer des Anrufs und der Anzahl von Mediendatenströme im Anruf ab.

Bei einem P2P-Anruf enthält jedes Protokoll Daten, die sich auf jeden der ausgehenden Datenströme beziehen, die den einzelnen Endpunkten zugeordnet sind. In einem Gruppenanruf erstellt jeder mit endpointType = "Server" verknüpfte Datenstrom ein Protokoll, das Daten für die eingehenden Datenströme enthält. Alle anderen Datenströme erstellen Protokolle, die Daten für die ausgehenden Datenströme für Endpunkte enthalten, die keine Server sind. Bei Gruppenanrufen verwenden Sie den participantId-Wert als Schlüssel, um die zugehörigen ein- und ausgehenden Protokolle zu einer eigenen Teilnehmerverbindung zusammenzufassen.

Weitere Informationen finden Sie unter: Schema des Zeitreihenprotokolls für Anrufclient-Medienstatistiken

Protokolle der Umfrage am Ende des Anrufs:

Diese Protokolle werden aufgefüllt, wenn der Webanrufclient eine Umfrage am Ende des Anrufs sendet. Sie können diese Protokolle verwenden, um mehr über die subjektive Wahrnehmung Ihrer Anrufqualität von Ihren Benutzern zu erfahren.

Weitere Informationen finden Sie unter: Übersicht über die Umfrage am Ende des Anrufs

Anrufmetrikprotokolle:

Diese Protokolle enthalten aggregierte Anrufmetriken in täglichen Lagerplätze basierend auf Attributen wie SDK-Version, Betriebssystemname und Fehleruntercode. Diese Protokolle werden im „Einblicke in Sprache und Video“-Dashboard verwendet, um langfristige Diagramme zur Zuverlässigkeit, Qualität und Leistung basierend auf der Anzahl der erfolgreichen und fehlgeschlagenen Anruf-SDK-API-Aufrufe verschiedener Vorgänge zu visualisieren.

Weitere Informationen finden Sie unter: Protokollschema der Anrufmetriken

Datenkonzepte

Die folgenden allgemeinen Beschreibungen von Datenkonzepten gelten speziell für Sprach- und Videoanrufe. Diese Konzepte müssen bekannt sein, um die Bedeutung der in den Protokollen erfassten Daten verstehen zu können.

Entitäten und IDs

Machen Sie sich mit den folgenden Begriffen vertraut:

  • Anruf: Wie in den Daten dargestellt, ist ein Anruf eine Abstraktion, die durch correlationId dargestellt wird. Werte für correlationId sind für jeden Anruf eindeutig und durch callStartTime und callDuration zeitgebunden.

  • Teilnehmende Person: Stellt die Verbindung zwischen einem Endpunkt und dem Server dar. Ein Teilnehmer bzw. eine Teilnehmerin (participantId) ist nur vorhanden, wenn der Anruf ein Gruppenanruf ist.

  • Endpunkt: Dies ist die eindeutigste Einheit, dargestellt durch endpointId. Jeder Anruf ist ein Ereignis, das Daten von mindestens zwei Endpunkten enthält. Endpunkte stellen die Teilnehmenden des Anrufs dar.

    EndpointType gibt an, ob es sich bei dem Endpunkt um einen Menschen (PSTN, VoIP), um einen Bot oder um den Server handelt, der mehrere Teilnehmende innerhalb eines Anrufs verwaltet. Wenn ein endpointType-Wert "Server" lautet, wird dem Endpunkt keine eindeutige ID zugewiesen. Sie können endpointType und die Anzahl von endpointId-Werten analysieren, um zu bestimmen, wie viele Benutzer bzw. Benutzerinnen und andere, nicht menschliche Teilnehmende (Bots, Server) an einem Anruf teilnehmen.

    Native SDKs für Android und iOS verwenden anrufübergreifend den gleichen endpointId-Wert für Benutzer bzw. Benutzerinnen, was ein sitzungsübergreifendes Verständnis der Erfahrung ermöglicht. Dieser Prozess unterscheidet sich von webbasierten Endpunkten, die einen neuen endpointId-Wert für jeden neuen Anruf generieren.

  • Datenstrom: Dies ist die präziseste Entität. Es gibt jeweils einen Datenstrom pro Richtung (eingehend oder ausgehend) und einen mediaType-Wert (z. B. Audio oder Video).

Gegenüberstellung von P2P- und Gruppenanrufen

Hinweis

In diesem Artikel befinden sich P2P- und Gruppenanrufe standardmäßig im gleichen Mandanten. Auf Anrufszenarien, die mandantenübergreifend sind, wird im gesamten Artikel entsprechend hingewiesen.

Es gibt zwei Arten von Anrufen (dargestellt durch callType):

  • P2P-Anruf: Eine Verbindung zwischen zwei Endpunkten (ohne Serverendpunkt). P2P-Anrufe werden als Anruf zwischen diesen Endpunkten initiiert und nicht als Gruppenanrufereignis vor dem Herstellen der Verbindung erstellt.

    Diagramm mit einem P2P-Aufruf über zwei Endpunkte hinweg.

  • Gruppenanruf: Jeder Anruf, bei dem mehr als zwei Endpunkte miteinander verbunden sind. Gruppenanrufe beinhalten einen Serverendpunkt und die Verbindung zwischen dem jeweiligen Endpunkt und dem Server. P2P-Anrufe, bei denen während des Anrufs ein weiterer Endpunkt hinzugefügt wird, sind keine P2P-Anrufe mehr, sondern werden zu Gruppenanrufen. Anhand der Metriken participantStartTime und participantDuration können Sie ermitteln, wann die einzelnen Endpunkte dem Anruf beigetreten sind.

    Diagramm mit einem Gruppenaufruf über mehrere Endpunkte hinweg.

Beispiele für verschiedene Anruftypen

Hinweis

In diesem Artikel befinden sich P2P- und Gruppenanrufe standardmäßig im gleichen Mandanten. Auf Anrufszenarien, die mandantenübergreifend sind, wird im gesamten Artikel entsprechend hingewiesen.

Beispiel: P2P-Anruf

Das folgende Diagramm zeigt zwei Endpunkte, die direkt in einem P2P-Anruf verbunden sind. In diesem Beispiel erstellt Communication Services zwei Protokolle der Anrufzusammenfassung (eins für jeden participantID-Wert) sowie vier Protokolle der Anrufdiagnose (eins für jeden Mediendatenstrom).

Für teilnehmende Personen vom Azure Communication Services-Anrufclient sind auch mehrere Anrufclient-Vorgangsprotokolle und Zeitreihenprotokolle für Anrufclient-Medienstatistiken verfügbar. Die genaue Anzahl dieser Protokolle hängt von der Art der SDK-Vorgänge, die aufgerufen werden, und der Dauer des Anrufs ab.

Diagramm: P2P-Anruf innerhalb desselben Mandanten.

Beispiel: Gruppenanruf

Das folgende Diagramm zeigt ein Gruppenanrufbeispiel mit drei participantId-Werten (also drei Teilnehmern bzw. Teilnehmerinnen) und einem Serverendpunkt. Es ist möglich, dass mehrere Teilnehmer bzw. Teilnehmerinnen über mehrere Werte für endpointId verfügen – etwa, wenn sie vom gleichen Gerät aus erneut einem Anruf beitreten. Communication Services erstellt für jeden participantId-Wert ein Anrufzusammenfassungsprotokoll. Es werden vier Anrufdiagnoseprotokolle erstellt: je eins für jeden Mediendatenstrom pro participantId.

Bei teilnehmenden Personen vom Azure Communication Services-Anrufclient sind die Anrufclientvorgangsprotokolle identisch mit P2P-Anrufen. Für teilnehmende Personen, die das Calling SDK verwenden, gibt es jeweils eine Reihe von Anrufclientvorgangsprotokollen.

Für teilnehmende Personen vom Azure Communication Services-Anrufclient sind die Anrufclient-Vorgangsprotokolle und Zeitreihenprotokolle für Anrufclient-Medienstatistiken mit denen für P2P-Anrufe identisch. Für jede teilnehmende Person, der das Calling SDK verwendet, werden mehrere Anrufclient-Vorgangsprotokolle und Zeitreihenprotokolle für Anrufclient-Medienstatistiken erstellt.

Diagramm: Gruppenanruf innerhalb desselben Mandanten

Beispiel: Mandantenübergreifender P2P-Anruf

Das folgende Diagramm zeigt zwei Teilnehmer bzw. Teilnehmerinnen in mehreren Mandanten, die direkt über einen P2P-Anruf verbunden sind. In diesem Beispiel erstellt Communication Services ein einzelnes Anrufzusammenfassungsprotokoll (eins für jeden Teilnehmer bzw. jede Teilnehmerin) mit redigierter OS- und SDK-Version. Außerdem erstellt Communication Services vier Anrufdiagnoseprotokolle (je eins für jeden Mediendatenstrom). Jedes Protokoll enthält Daten, die sich auf den ausgehenden Datenstrom von participantID beziehen.

Diagramm: Mandantenübergreifender P2P-Anruf.

Beispiel: Mandantenübergreifender Gruppenanruf

Das folgende Diagramm zeigt ein Gruppenanrufbeispiel mit drei participantId-Werten für mehrere Mandanten. Communication Services erstellt ein einzelnes Anrufzusammenfassungsprotokoll für jeden Teilnehmer bzw. jede Teilnehmerin mit redigierter OS- und SDK-Version. Außerdem erstellt Communication Services vier Anrufdiagnoseprotokolle, die sich auf die einzelnen participantId-Werte beziehen (je eins für jeden Mediendatenstrom).

Diagramm: Mandantenübergreifender Gruppenanruf.

Hinweis

In diesem Release werden nur ausgehende Diagnoseprotokolle unterstützt. Die Betriebssystem- und SDK-Version, die dem Bot und dem Teilnehmer bzw. der Teilnehmerin zugeordnet sind, werden ggf. redigiert, da Communication Services Identitäten von Teilnehmern bzw. Teilnehmerinnen und Bots auf die gleiche Weise behandelt.

Häufig gestellte Fragen

Wie speichere ich Protokolle?

Im folgenden Abschnitt werden diese Anforderungen erläutert.

Azure Communication Services-Protokolle werden standardmäßig nicht in Ihrem Azure-Konto gespeichert, daher müssen Sie mit der Speicherung beginnen, damit Tools wie das „Einblicke in Sprache und Video“-Dashboard und Anrufdiagnose funktionieren. Um diese Anruflisten zu sammeln, müssen Sie eine Diagnoseeinstellung aktivieren, die die Anrufdaten an einen Log Analytics-Arbeitsbereich leitet.

Daten werden nicht rückwirkend gespeichert, sodass Sie erst nach der Konfiguration der Diagnoseeinstellung mit der Erfassung von Anruflisten beginnen.

Folgen Sie den Anweisungen zum Hinzufügen von Diagnoseeinstellungen für Ihre Ressource unter Aktivieren von Protokollen über die Diagnoseeinstellungen in Azure Monitor. Es wird empfohlen, zunächst alle Protokolle zu sammeln. Nachdem Sie die Funktionen in Azure Monitor verstanden haben, bestimmen Sie, welche Protokolle Sie aufbewahren möchten und wie lange. Wenn Sie Ihre Diagnoseeinstellung hinzufügen, werden Sie aufgefordert, Protokolle auszuwählen. Um alle Protokolle zu erfassen, wählen Sie allLogs aus.

Ihr Datenvolumen, Ihre Aufbewahrung und Ihre Nutzung in Log Analytics in Azure Monitor wird über vorhandene Azure-Datenzähler abgerechnet. Aus Kostengründen wird empfohlen, ggf. Ihre Datennutzungs- und Aufbewahrungsrichtlinien zu überwachen. Weitere Informationen finden Sie unter Verwalten der Kosten.

Wenn Sie über mehrere Azure Communications Services-Ressourcen-IDs verfügen, müssen Sie diese Einstellungen für jede Ressourcen-ID aktivieren.

Nächste Schritte