Share via


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.

Screenshot of Chat API Request Metric.

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.

Screenshot of SMS API Request Metric.

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.

Screenshot of authentication Request Metric.

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.

Screenshot of TURN Token Request Metric.

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.

Screenshot of Rooms Request Metric.

Étapes suivantes