Azure Communication Services Rooms-Protokolle

Artikel
10/16/2024

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

Voraussetzungen

Communications Services bietet Überwachungs- und Analysefunktionen über die Übersicht über Azure Monitor-Protokolle und Azure Monitor-Metriken. Jede Azure-Ressource erfordert eine eigene Diagnoseeinstellung, die folgende Kriterien definiert:

Kategorien der Protokolle und Metrikdaten, die an die in der Einstellung definierten Ziele gesendet werden. Die verfügbaren Kategorien sind je nach Ressourcentyp verschieden.
Ein oder mehrere Ziele zum Senden der Protokolle. Zu den aktuellen Zielen gehören der Log Analytics-Arbeitsbereich, Event Hubs und Azure Storage.
Mit einer einzelnen Diagnoseeinstellung kann maximal eines der Ziele definiert werden. Wenn Sie Daten an mehrere Ziele eines bestimmten Typs senden möchten (z.B. zwei verschiedene Log Analytics-Arbeitsbereiche), dann erstellen Sie mehrere Einstellungen. Jede Ressource kann bis zu fünf Diagnoseeinstellungen haben.

Im Folgenden finden Sie Anweisungen zur Konfiguration Ihrer Azure Monitor-Ressource, damit Sie Protokolle und Metriken für Ihre Kommunikationsdienste erstellen können. Eine ausführliche Dokumentation zur Verwendung von Diagnoseeinstellungen für alle Azure-Ressourcen finden Sie unter Aktivieren der Protokollierung in den Diagnoseeinstellungen.

Hinweis

Wählen Sie unter dem Namen der Diagnoseeinstellung „Rooms-Betriebsprotokolle“ aus, um die Protokolle für Rooms zu aktivieren.

Übersicht

Betriebsprotokolle von Rooms sind Datensätze von Ereignissen und Aktivitäten, die Einblicke in Ihre Rooms-API-Anforderungen bieten. Sie erfassen Details zur Leistung und Funktionalität des Rooms-Grundtyps, einschließlich des Status jeder Rooms-Anforderung sowie zusätzlicher Eigenschaften. Betriebsprotokolle für Rooms enthalten Informationen, mit denen Trends und Muster der Nutzung von Rooms identifiziert werden können.

Protokollkategorien

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

Rooms-Betriebsprotokolle: Stellt grundlegende Informationen zum Rooms-Dienst bereit.

Schema für Rooms-Betriebsprotokolle

Eigenschaft	Beschreibung
`Correlation ID`	Eindeutige ID der Anforderung
`Level`	Der Schweregrad des Ereignisses.
`Operation Name`	Der mit der Protokollaufzeichnung verbundene Vorgang. Beispiel: CreateRoom, PatchRoom, GetRoom, ListRooms, DeleteRoom, GetParticipants, UpdateParticipants.
`Operation Version`	Die API-Version, die dem Vorgang zugeordnet ist.
`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.
.`RoomId`	Die ID des Raums.
`RoomLifeSpan`	Die Lebensdauer des Raums in Minuten.
`AddedRoomParticipantsCount`	Die Anzahl der Teilnehmer, die einem Raum hinzugefügt wurden.
`UpsertedRoomParticipantsCount`	Die Anzahl der Teilnehmer in einem Raum.
`RemovedRoomParticipantsCount`	Die Anzahl der Teilnehmer, die aus einem Raum entfernt wurden.
`TimeGenerated`	Der Zeitstempel (UTC), wann das Protokoll generiert wurde.
`PstnDialOutEnabled`	Gibt an, ob ein Raum die Möglichkeit hat, PSTN-Anrufe zu tätigen, um Personen zu einer Besprechung einzuladen.

Beispiel für ein CreateRoom-Protokoll

    [
      {
      "CorrelationId": "Y4x6ZabFE0+E8ERwMpd68w",
      "Level": "Informational",
      "OperationName": "CreateRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": 201,
      "RoomId": "99466898241024408",
      "RoomLifespan": 61,
      "AddedRoomParticipantsCount": 4,
      "TimeGenerated": "5/25/2023, 4:32:49.469 AM",
      "PstnDialOutEnabled": false,
      }
    ]

Beispiel für GetRoom-Protokoll

    [
      {
      "CorrelationId": "CNiZIX7fvkumtBSpFq7fxg",
      "Level": "Informational",
      "OperationName": "GetRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 61,
      "TimeGenerated": "2022-08-19T17:07:30.2400300Z",
      },
    ]

Beispiel für UpdateRoom-Protokoll

    [
      {
      "CorrelationId": "Bwqzh0pdnkGPDwNcMnBkng",
      "Level": "Informational",
      "OperationName": "UpdateRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "TimeGenerated": "2022-08-19T17:07:30.3543160Z",
      "PstnDialOutEnabled": false,
      },
    ]

Beispiel für ein DeleteRoom-Protokoll

    [
      {
      "CorrelationId": "x7rMXmihYEe3GFho9T/H2w",
      "Level": "Informational",
      "OperationName": "DeleteRoom",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "204",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "TimeGenerated": "2022-08-19T17:07:30.5393800Z",
      },
    ]

Beispiel für ein ListRooms-Protokoll

	[
	  {
	  "CorrelationId": "KibM39CaXkK+HTInfsiY2w",
	  "Level": "Informational",
	  "OperationName": "ListRooms",
	  "OperationVersion": "2023-10-30-preview",
	  "ResultType": "Succeeded",
	  "ResultSignature": "200",
	  "TimeGenerated": "2022-08-19T17:07:30.5393800Z",
	  },
	]

Beispiel für ein UpdateParticipants-Protokoll

    [
      {
      "CorrelationId": "zHT8snnUMkaXCRDFfjQDJw",
      "Level": "Informational",
      "OperationName": "UpdateParticipants",
      "OperationVersion": "2023-10-30-preview",
      "ResultType": "Succeeded",
      "ResultSignature": "200",
      "RoomId": "99466387192310000",
      "RoomLifespan": 121,
      "UpsertedRoomParticipantsCount": 5,
      "RemovedRoomParticipantsCount": 1,
      "TimeGenerated": "2023-04-14T17:07:30.5393800Z",
      },
    ]

(Siehe auch Häufig gestellte Fragen (FAQ)).

Freigeben über