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.