Partager via


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.

Capture d’écran d’une métrique de requête Messagerie avancée.

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.

Capture d’écran d’une métrique de requête d’authentification.

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.

Capture d’écran d’une métrique de requête d’API Conversation.

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.

Capture d’écran d’une métrique de requête de jeton 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.

Capture d’écran d’une métrique de requête d’API Salles.

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.

Capture d’écran d’une métrique de requête d’API SMS.

Étapes suivantes