Freigeben über

Azure Communication Services Chat-Protokolle

  • 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.

Wichtig

Die folgenden Ausführungen beziehen sich auf Protokolle, die über Azure Monitor (siehe auch FAQ). Um diese Protokolle für Ihre Kommunikationsdienste zu aktivieren, siehe: Protokollierung in den Diagnoseeinstellungen aktivieren

Ressourcenprotokollkategorien

Communication Services bietet die folgenden Protokolltypen, die Sie aktivieren können:

  • Nutzungsprotokolle – Stellt Nutzungsdaten bereit, die den einzelnen abgerechneten Dienstangeboten zugeordnet sind.
  • Authentifizierungsbetriebsprotokolle: Stellt grundlegende Informationen zum Authentifizierungsdienst bereit.
  • Chat-Betriebsprotokolle: Stellt grundlegende Informationen zum Chatdienst bereit.

Schema für Nutzungsprotokolle

Eigenschaft Beschreibung
Timestamp Der Zeitstempel (UTC), wann das Protokoll generiert wurde.
Operation Name Der mit der Protokollaufzeichnung verbundene Vorgang.
Operation Version Die api-version, die dem Vorgang zugeordnet ist, wenn für „operationName“ eine API verwendet wurde. Wenn keine API vorhanden ist, die diesem Vorgang entspricht, stellt die Version für den Fall, dass sich die zugeordneten Eigenschaften des Vorgangs in Zukunft ändern, die Version dieses Vorgangs dar.
Category Die Protokollkategorie des Ereignisses. „category“ ist die Granularität, mit der Sie Protokolle für eine bestimmte Ressource aktivieren oder deaktivieren können. Die Eigenschaften, die im Eigenschaftenblob eines Ereignisses angezeigt werden, sind für eine bestimmte Protokollkategorie und einen Ressourcentyp gleich.
Correlation ID Die ID für korrelierte Ereignisse. Kann verwendet werden, um korrelierte Ereignisse zwischen verschiedenen Tabellen zu identifizieren.
Properties Andere Daten, die auf verschiedene Communication Services-Modi anwendbar sind.
Record ID Die eindeutige ID für einen angegebenen Nutzungsdatensatz.
Usage Type Die Art der Nutzung. (Beispiel: Chat, PSTN, NAT usw.)
Unit Type Der Typ der Einheit, auf dem die Nutzung für eine bestimmte Nutzungsart basiert. (Beispiel Minuten, Megabyte, Nachrichten usw.)
Quantity Die Anzahl der für diesen Datensatz verwendeten oder verbrauchten Einheiten.

Authentifizierungsbetriebsprotokolle

Eigenschaft Beschreibung
TimeGenerated Der Zeitstempel (UTC), wann das Protokoll generiert wurde.
OperationName Der mit der Protokollaufzeichnung verbundene Vorgang.
CorrelationID Die ID für korrelierte Ereignisse. Kann verwendet werden, um korrelierte Ereignisse zwischen verschiedenen Tabellen zu identifizieren.
OperationVersion Die api-version, die dem Vorgang zugeordnet ist, wenn für operationName eine API verwendet wurde. Wenn keine API vorhanden ist, die diesem Vorgang entspricht, stellt die Version für den Fall, dass sich die zugeordneten Eigenschaften des Vorgangs in Zukunft ändern, die Version dieses Vorgangs dar.
Category Die Protokollkategorie des Ereignisses. „category“ ist die Granularität, mit der Sie Protokolle für eine bestimmte Ressource aktivieren oder deaktivieren können. Die Eigenschaften, die im Eigenschaftenblob eines Ereignisses angezeigt werden, sind für eine bestimmte Protokollkategorie und einen Ressourcentyp gleich.
ResultType Der Status des Vorgangs.
ResultSignature Der Unterstatus des Vorgangs. Wenn dieser Vorgang einem REST-API-Aufruf entspricht, ist dieses Feld der HTTP-Statuscode des entsprechenden REST-Aufrufs.
DurationMs Die Dauer des Vorgangs in Millisekunden.
CallerIpAddress Die IP-Adresse des Aufrufers, wenn der Vorgang einem API-Aufruf entspricht, der von einer Entität mit einer öffentlich verfügbaren IP-Adresse stammt.
Level Der Schweregrad des Ereignisses.
URI Der URI der Anforderung.
SdkType Der in der Anforderung verwendete SDK-Typ.
PlatformType Der in der Anforderung verwendete Plattformtyp.
Identity Die Identität des Azure Communication Services- oder Teams-Benutzers im Zusammenhang mit dem Vorgang.
Scopes Die Communication Services-Bereiche, die im Zugriffstoken vorhanden sind.

Protokolle zum Chatbetrieb

Eigenschaft BESCHREIBUNG
TimeGenerated Der Zeitstempel (UTC), wann das Protokoll generiert wurde.
Vorgangsname Der mit der Protokollaufzeichnung verbundene Vorgang.
CorrelationID Die ID für korrelierte Ereignisse. Kann verwendet werden, um korrelierte Ereignisse zwischen verschiedenen Tabellen zu identifizieren.
OperationVersion Die API-Version, die dem Vorgang zugeordnet ist, wenn für „operationName“ eine API verwendet wurde. Wenn keine API vorhanden ist, die diesem Vorgang entspricht, stellt die Version für den Fall, dass sich die zugeordneten Eigenschaften des Vorgangs in Zukunft ändern, die Version dieses Vorgangs dar.
Kategorie Die Protokollkategorie des Ereignisses. „category“ ist die Granularität, mit der Sie Protokolle für eine bestimmte Ressource aktivieren oder deaktivieren können. Die Eigenschaften, die im Eigenschaftenblob eines Ereignisses angezeigt werden, sind für eine bestimmte Protokollkategorie und einen Ressourcentyp gleich.
ResultType Der Status des Vorgangs.
ResultSignature Der Unterstatus des Vorgangs. Wenn dieser Vorgang einem REST-API-Aufruf entspricht, ist dieses Feld der HTTP-Statuscode des entsprechenden REST-Aufrufs.
ResultDescription Die statische Textbeschreibung dieses Vorgangs.
DurationMs Die Dauer des Vorgangs in Millisekunden.
CallerIpAddress Die IP-Adresse des Aufrufers, wenn der Vorgang einem API-Aufruf entspricht, der von einer Entität mit einer öffentlich verfügbaren IP-Adresse stammt.
Ebene Der Schweregrad des Ereignisses.
URI Der URI der Anforderung.
UserId Die Benutzer-ID des Absenders der Anforderung.
ChatThreadId Die mit der Anforderung verknüpfte Chatthread-ID.
ChatMessageId Die mit der Anforderung verknüpfte Chatnachrichten-ID.
SdkType Der in der Anforderung verwendete SDK-Typ.
PlatformType Der in der Anforderung verwendete Plattformtyp.