Azure Communication Services-Chatprotokolle

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 die Version dieses Vorgangs dar, falls die eigenschaften, die der Vorgangsänderung zugeordnet sind, in Zukunft geändert werden.
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 die Version dieses Vorgangs dar, falls die eigenschaften, die der Vorgangsänderung zugeordnet sind, in Zukunft geändert werden.
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 die Version dieses Vorgangs dar, falls die eigenschaften, die der Vorgangsänderung zugeordnet sind, in Zukunft geändert werden.
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.