Vue d’ensemble des métriques
Azure Communication Services fournit actuellement des métriques pour toutes les primitives des services de communication Azure. Azure Metrics Explorer peut être utilisé pour tracer vos propres graphiques, examiner les anomalies dans vos valeurs de métriques et comprendre le trafic de votre API à l’aide des données de métriques émises par les demandes 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 sont disponibles sous 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 mesures
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.
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 demande est envoyée à une opération qui n’est pas reconnue, vous recevez une réponse de valeur « Route incorrecte ».
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. |
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 pour un nouveau jeton d’accès Communication Identity avec une heure d’expiration correspondante. |
Appeler des demandes d’API Automation
Les opérations suivantes sont disponibles sur les métriques de requête de l’API Call Automation :
| Operation/Route | Description |
|---|---|
| Créer un appel | Créez un appel sortant à l’utilisateur. |
| Appel de réponse | Répondez à un appel entrant. |
| Appel de redirection | Redirigez un appel entrant vers un autre utilisateur. |
| Rejeter l’appel | Rejeter un appel entrant. |
| Transférer l’appel au participant | Transférez l’appel 1 :1 à un autre utilisateur. |
| Lire | Lire l’audio pour appeler les participants. |
| PlayPrompt | Jouez une invite aux utilisateurs dans le cadre de l’action Recognize. |
| Recognize | Reconnaître l’entrée utilisateur des participants aux appels. |
| Ajouter des participants | Ajoutez un participant à un appel. |
| Supprimer les participants | Supprimez un participant d’un appel. |
| Appel hangup | Raccrocher la jambe d’appel. |
| Terminer l’appel | Terminez l’appel pour tous les participants. |
| Obtenir l’appel | Obtenez des détails sur un appel. |
| Obtenir le participant | Obtenez des détails sur un participant d’appel. |
| Obtenir des participants | Obtenez tous les participants dans un appel. |
| Supprimer l’appel | Supprimez un appel. |
| Annuler toutes les opérations multimédias | Annulez toutes les opérations multimédias en cours ou en file d’attente dans un appel. |
Demandes de l’API Routeur de travaux
Les opérations suivantes sont disponibles sur les métriques de requête de l’API Job Router :
| 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 | Supprimez 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 | Supprimez une stratégie de distribution 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 | Supprimez 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 | Supprimez une file d’attente par ID. |
| GetQueueStatistics | Récupère les statistiques d’une file d’attente. |
| UpsertJob | Crée ou met à jour un travail. |
| GetJob | Récupère un travail existant par ID. |
| GetJobs | Récupère les travaux existants |
| DeleteJob | Supprimez une stratégie de file d’attente par ID. |
| ReclassifyJob | Reclassifier un travail. |
| CancelJob | Envoie une demande d’annulation d’un travail existant par ID lors de la fourniture d’une raison d’annulation de formulaire libre. |
| CompleteJob | Termine un travail affecté. |
| CloseJob | Ferme un travail terminé. |
| AcceptJobOffer | Accepte une offre pour travailler sur un travail et retourne un 409/Conflit si un autre agent a déjà accepté le travail. |
| DeclineJobOffer | Refuse une offre pour travailler sur un emploi. |
| 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. |
Demandes de l’API Salles
Les opérations suivantes sont disponibles sur les métriques de requête de l’API Rooms :
| Operation/Route | Description |
|---|---|
| CreateRoom | Crée une salle. |
| DeleteRoom | Supprime une salle. |
| GetRoom | Obtient une pièce par ID de salle. |
| PatchRoom | Mises à jour un room by Room ID. |
| ListRooms | Répertorie 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 | Mises à jour liste des participants pour une salle. |
Étapes suivantes
- Découvrez-en plus sur les métriques de la plateforme de données.