Journaux des salles Azure Communication Services

Article
10/16/2024

Azure Communication Services offre des fonctionnalités de journalisation que vous pouvez utiliser pour superviser et déboguer votre solution Communication Services. Ces fonctionnalités peuvent être configurées à l’aide du portail Azure.

Important

Les éléments suivants font référence aux journaux activés par le biais d’Azure Monitor (voir également la FAQ). Pour activer ces journaux pour vos services de communication, consultez : Activer la journalisation dans les paramètres de diagnostic

Conditions préalables

Azure Communications Services fournit des fonctionnalités de surveillance et d’analytique via la vue d’ensemble des journaux Azure Monitor et les métriques Azure Monitor. Chaque ressource Azure requiert son propre paramètre de diagnostic, qui définit les critères suivants :

Catégories de journaux et données de métriques envoyées aux destinations définies dans le paramètre. Les catégories disponibles varient en fonction des types de ressources.
Une ou plusieurs destinations auxquelles envoyer les journaux. Les destinations actuelles sont l’espace de travail Log Analytics, Event Hubs et le Stockage Azure.
Un seul paramètre de diagnostic ne peut pas définir plus d’une destination. Si vous souhaitez envoyer des données à plus d’un type de destination (par exemple, deux espaces de travail Log Analytics), créez plusieurs paramètres. Chaque ressource peut avoir jusqu’à cinq paramètres de diagnostic.

Vous trouverez ci-dessous des instructions sur la configuration de votre ressource Azure Monitor pour commencer à créer des journaux et des métriques pour vos services de communication. Pour obtenir une documentation détaillée sur l’utilisation des paramètres de diagnostic pour toutes les ressources Azure, consultez Activer la journalisation dans les paramètres de diagnostic.

Remarque

Sous le nom du paramètre de diagnostic, sélectionnez « Journaux des salles opérationnelles » pour activer les journaux des salles.

Vue d’ensemble

Les journaux opérationnels des salles sont des enregistrements d’événements et d’activités qui fournissent des insights sur vos requêtes d’API Salles. Ils capturent des détails sur les performances et les fonctionnalités de la primitive Salles, y compris l’état de chaque requête Salles ainsi que des propriétés supplémentaires. Les journaux opérationnels des salles contiennent des informations qui permettent d’identifier les tendances et les modèles d’utilisation des salles.

Catégories de journal

Communication Services propose les types de journaux suivants que vous pouvez activer :

Journaux des salles opérationnelles : fournit les informations de base relatives au service de salles

Schéma des journaux des salles opérationnelles

Propriété	Description
`Correlation ID`	ID unique de la requête.
`Level`	Niveau de gravité de l’événement.
`Operation Name`	Opération associée à l’enregistrement du journal. Par exemple, CreateRoom, PatchRoom, GetRoom, ListRooms, DeleteRoom, GetParticipants, UpdateParticipants.
`Operation Version`	Version de l’API associée à l’opération.
`ResultType`	État de l'opération.
`ResultSignature`	Sous-état de l’opération. Si cette opération correspond à un appel d’API REST, ce champ est le code d’état HTTP de l’appel REST correspondant.
.`RoomId`	L’ID de la salle.
`RoomLifeSpan`	La durée de vie de la salle en minutes.
`AddedRoomParticipantsCount`	Le nombre de participants ajoutés à une salle.
`UpsertedRoomParticipantsCount`	Le nombre de participants upsertés dans une salle.
`RemovedRoomParticipantsCount`	Le nombre de participants supprimés d’une salle.
`TimeGenerated`	Horodatage (UTC) de la génération du journal.
`PstnDialOutEnabled`	Indique si une salle a la possibilité d’effectuer des appels RTC pour inviter des personnes à une réunion.

Exemple de journal CreateRoom

    [
      {
      "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,
      }
    ]

Exemple de journal GetRoom

    [
      {
      "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",
      },
    ]

Exemple de journal UpdateRoom

    [
      {
      "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,
      },
    ]

Exemple de journal DeleteRoom

    [
      {
      "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",
      },
    ]

Exemple de journal ListRooms

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

Exemple de journal UpdateParticipants

    [
      {
      "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",
      },
    ]

(Voir aussi FAQ).

Partager via