Vue d’ensemble des métriques

Azure Communication Services fournit actuellement des métriques pour les primitives des services de communication Azure. Azure Metrics Explorer peut être utilisé pour tracer vos propres graphiques, étudier des anomalies dans vos valeurs de métrique et comprendre le trafic de vos API à l’aide des données de métriques émises par des requêtes de messagerie.

Où trouver les métriques ?

Les primitives dans Azure Communication Services émettent des métriques pour les requêtes d’API. Ces métriques se trouvent dans l’onglet Métriques sous votre ressource Communication Services. Vous pouvez également créer des tableaux de bord permanents à l’aide de l’onglet Classeurs sous votre ressource Communication Services.

Définitions de métriques

Toutes les métriques de requêtes d’API contiennent trois dimensions que vous pouvez utiliser pour filtrer vos données de métriques. Ces dimensions peuvent être agrégées ensemble à l’aide du type d’agrégation Count et prennent en charge toutes les séries chronologiques d’agrégation Azure standard, notamment Sum, Average, Min et Max.

Vous trouverez plus d’informations sur les types d’agrégation pris en charge et les agrégations de série chronologique dans Fonctionnalités avancées d’Azure Metrics Explorer.

• Opération : toutes les opérations ou routes qui peuvent être appelées sur la passerelle de conversation Azure Communication Services.
• Code d’état : réponse de code d’état envoyée après la demande.
• StatusSubClass : série de codes d’état envoyée après la réponse.

Requêtes d’API Messagerie avancée

Les opérations suivantes sont disponibles sur les métriques des requêtes d’API Messagerie avancée :

Operation/Route	Description	Scénario
DownloadMedia	Requête de téléchargement de la charge utile multimédia.	L’entreprise a demandé de télécharger la charge utile multimédia.
ListTemplates	Requête de génération de la liste de modèles.	L’entreprise a demandé de lister les modèles pour une chaîne donnée.
ReceiveMessage	Message reçu.	L’utilisateur a envoyé un message à l’entreprise.
SendMessage	Requête de notification d’envoi d’un message.	L’entreprise demande d’envoyer un message à l’utilisateur.
SendMessageDeliveryStatus	État de remise reçu.	L’entreprise a reçu une réponse concernant un message qu’elle a demandé d’envoyer à un utilisateur.

Requêtes d’API d’authentification

Les opérations suivantes sont disponibles sur les métriques des requêtes d’API d’authentification :

Operation/Route	Description
CreateIdentity	Crée une identité représentant un seul utilisateur.
DeleteIdentity	Supprime une identité.
CreateToken	Crée un jeton d’accès.
RevokeToken	Révoque tous les jetons d’accès créés pour une identité avant une heure donnée.
ExchangeTeamsUserAccessToken	Échangez un jeton d’accès Microsoft Entra d’un utilisateur Teams contre un nouveau jeton d’accès Communication Identity avec une heure d’expiration correspondante.

Requêtes d’API Automatisation des appels

Les opérations suivantes sont disponibles sur les métriques des requêtes d’API Automatisation des appels :

Operation/Route	Description
Créer un appel	Crée un appel sortant vers l’utilisateur.
Répondre à l’appel	Répond à un appel entrant.
Rediriger l’appel	Redirige un appel entrant vers un autre utilisateur.
Rejeter l’appel	Rejette un appel entrant.
Transférer l’appel au participant	Transfère l’appel 1:1 à un autre utilisateur.
Lire	Lit l’audio aux participants à l’appel.
PlayPrompt	Lit une invite aux utilisateurs dans le cadre de l’action Reconnaître.
Recognize	Reconnaît l’entrée utilisateur des participants à l’appel.
Ajouter des participants	Ajoute un participant à un appel.
Supprimer des participants	Supprime un participant d’un appel.
Raccrocher l’appel	Raccroche le tronçon d’appel.
Terminer l’appel	Termine l’appel pour tous les participants.
Obtenir l’appel	Obtient des détails sur un appel.
Obtenir le participant	Obtient des détails sur le participant à un appel.
Obtenir des participants	Obtient tous les participants d’un appel.
Supprimer l’appel	Supprime un appel.
Annuler toutes les opérations multimédias	Annule toutes les opérations multimédias en cours ou en file d’attente dans un appel.

Opérations pour les métriques des demandes d’API de conversation

Les opérations suivantes sont disponibles sur les métriques des demande d’API de conversation :

Operation/Route	Description
GetChatMessage	Obtient un message par ID de message.
ListChatMessages	Obtient une liste de messages de conversation à partir d’un fil.
SendChatMessage	Envoie un message de conversation à un fil.
UpdateChatMessage	Met à jour un message de conversation.
DeleteChatMessage	Supprime un message de conversation.
GetChatThread	Obtient un fil de conversation.
ListChatThreads	Obtient la liste des fils de conversation d’un utilisateur.
UpdateChatThread	Met à jour les propriétés d’un fil de conversation.
CreateChatThread	Crée un fil de conversation.
DeleteChatThread	Supprime un fil.
GetReadReceipts	Obtient les confirmations de lecture d’un fil.
SendReadReceipt	Envoie un événement de confirmation de lecture à un fil, pour le compte d’un utilisateur.
SendTypingIndicator	Publie un événement de frappe sur un fil, pour le compte d’un utilisateur.
ListChatThreadParticipants	Obtient les membres d’un fil.
AddChatThreadParticipants	Ajoute des membres de fil à un fil. Si les membres existent déjà, aucune modification ne se produit.
RemoveChatThreadParticipant	Supprimer un membre d’un fil.

Si une requête est envoyée à une opération qui n’est pas reconnue, vous recevez une réponse dont la valeur est « Bad Route » (route incorrecte).

Requêtes d’API Routeur de tâches

Les opérations suivantes sont disponibles sur les métriques des requêtes d’API Routeur de tâches :

Operation/Route	Description
UpsertClassificationPolicy	Crée ou met à jour une stratégie de classification.
GetClassificationPolicy	Récupère une stratégie de classification existante par ID.
ListClassificationPolicies	Récupère les stratégies de classification existantes
DeleteDistributionPolicy	Supprime une stratégie de classification par ID.
UpsertDistributionPolicy	Crée ou met à jour une stratégie de distribution.
GetDistributionPolicy	Récupère une stratégie de distribution existante par ID.
ListDistributionPolicies	Récupère les stratégies de distribution existantes.
DeleteDistributionPolicy	Supprime une stratégie de classification par ID.
UpsertExceptionPolicy	Crée ou met à jour une stratégie d’exception.
GetExceptionPolicy	Récupère une stratégie d’exception existante par ID.
ListExceptionPolicies	Récupère les stratégies d’exception existantes.
DeleteExceptionPolicy	Supprime une stratégie d’exception par ID.
UpsertQueue	Crée ou met à jour une file d’attente.
GetQueue	Récupère une file d’attente existante par ID.
GetQueues	Récupère les files d’attente existantes
DeleteQueue	Supprime une file d’attente par ID.
GetQueueStatistics	Récupère les statistiques d’une file d’attente.
UpsertJob	Crée ou met à jour une tâche.
GetJob	Récupère une tâche existante par ID.
GetJobs	Récupère les tâches existantes.
DeleteJob	Supprime une stratégie de file d’attente par ID.
ReclassifyJob	Reclassifie une tâche.
CancelJob	Soumet une requête pour annuler une tâche existante par ID tout en fournissant un motif d’annulation en forme libre.
CompleteJob	Termine une tâche affectée.
CloseJob	Ferme une tâche terminée.
AcceptJobOffer	Accepte une offre pour travailler sur une tâche et retourne 409/Conflit si un autre agent a déjà accepté la tâche.
DeclineJobOffer	Refuse une offre pour travailler sur une tâche.
UpsertWorker	Crée ou met à jour un Worker.
GetWorker	Récupère un Worker existant par ID.
GetWorkers	Récupère les Workers existants.
DeleteWorker	Supprime un Worker et toutes ses traces.

Requêtes d’API Network Traversal

Les opérations suivantes sont disponibles sur les métriques des requêtes d’API Network Traversal :

Operation/Route	Description
IssueRelayConfiguration	Émettre une configuration pour un serveur STUN/TURN.

Requêtes d’API Salles

Les opérations suivantes sont disponibles sur les métriques des requêtes d’API Salles :

Operation/Route	Description
CreateRoom	Crée une salle.
DeleteRoom	Supprime une salle.
GetRoom	Obtient une salle par ID de salle.
PatchRoom	Met à jour une salle par ID de salle.
ListRooms	Liste toutes les salles d’une ressource Azure Communication Services.
AddParticipants	Ajoute des participants à une salle.
RemoveParticipants	Supprime les participants d’une salle.
GetParticipants	Obtient la liste des participants pour une salle.
UpdateParticipants	Met à jour la liste des participants pour une salle.

Demandes d’API SMS

Les opérations suivantes sont disponibles sur les métriques des demandes d’API SMS :

Operation/Route	Description
SMSMessageSent	envoie un SMS.
SMSDeliveryReportsReceived	Obtient les rapports de remise de SMS
SMSMessagesReceived	Obtient les SMS.

Étapes suivantes

• Découvrez-en plus sur les métriques de la plateforme de données.