Freigeben über


Übersicht der Metriken

Azure Communication Services bietet derzeit Metriken für alle Azure Communication Services-Primitive. Mit dem Azure-Metrik-Explorer können Sie Ihre eigenen Diagramme erstellen, Anomalien in Ihren Metrikwerten untersuchen und Ihren Datenverkehr über die API verstehen, indem Sie die Metrikdaten verwenden, die von E-Mail-Anforderungen ausgegeben werden.

Position von Metriken

Primitiven in Azure Communication Services geben Metriken für API-Anforderungen aus. Diese Metriken finden Sie auf dem Registerkarte „Metriken“ unter Ihrer Communication Services-Ressource. Sie können auch permanente Dashboards mithilfe der Registerkarte „Arbeitsmappen“ unter Ihrer Communication Services-Ressource erstellen.

Metrikdefinitionen

Alle API-Anforderungsmetriken enthalten drei Dimensionen, mit denen Sie Ihre Metrikdaten filtern können. Diese Dimensionen können mithilfe des Aggregationstyps Count zusammen aggregiert werden und unterstützen alle Azure Aggregation-Standardzeitreihen, einschließlich Sum, Average, Min und Max.

Weitere Informationen zu unterstützten Aggregationstypen und Zeitreihenaggregationen finden Sie unter Erweiterte Funktionen von Azure-Metrik-Explorer.

  • Vorgang: Alle Vorgänge oder Routen, die über das Azure Communication Services Chat-Gateway aufgerufen werden können.
  • Statuscode: Die Statuscodeantwort, die nach der Anforderung gesendet wurde.
  • StatusSubClass: Die nach der Antwort gesendete Statuscodefolge.

API-Anforderungen für die erweiterte Nachrichtenübermittlung

Die folgenden Vorgänge sind für API-Anforderungsmetriken für die erweiterte Nachrichtenübermittlung verfügbar:

Vorgang/Route Beschreibung Szenario
DownloadMedia Anforderung zum Herunterladen der Medienpayload. Das Unternehmen hat das Herunterladen der Medienpayload angefordert.
ListTemplates Anforderung zum Auflisten von Vorlagen. Das Unternehmen hat das Auflisten von Vorlagen für einen bestimmten Kanal angefordert.
ReceiveMessage Nachricht empfangen. Der Benutzer hat eine Nachricht an das Unternehmen gesendet.
SendMessage Anforderung zum Senden einer Benachrichtigung. Das Unternehmen fordert das Senden einer Nachricht an den Benutzer an.
SendMessageDeliveryStatus Zustellungsstatus erhalten. Das Unternehmen hat eine Antwort auf eine Nachricht erhalten, die auf Anforderung des Unternehmens an einen Benutzer gesendet wurde.

Screenshot: Anforderungsmetrik für die erweiterte Nachrichtenübermittlung.

Anforderungen der Authentifizierungs-API

Die folgenden Vorgänge sind für Anforderungsmetriken der Authentifizierungs-API verfügbar:

Vorgang/Route Beschreibung
CreateIdentity Erstellt eine Identität, die einen einzelnen Benutzer darstellt.
DeleteIdentity Löscht eine Identität.
CreateToken Erstellt ein Zugriffstoken.
RevokeToken Widerruft alle Zugriffstoken, die vor einem bestimmten Zeitpunkt für eine Identität erstellt wurden.
ExchangeTeamsUserAccessToken Tausch eines Microsoft Entra-Zugriffstokens eines Teams-Benutzers gegen ein neues Zugriffstoken für die Kommunikationsidentität mit übereinstimmender Ablaufzeit.

Screenshot: Metrik für Authentifizierungsanforderung.

Anforderungen an Anrufautomatisierungs-API

Die folgenden Vorgänge sind für Anforderungsmetriken der Anrufautomatisierungs-API verfügbar:

Vorgang/Route Beschreibung
Erstellen eines Anrufs Erstellen eines ausgehenden Anrufs an den Benutzer.
Anruf annehmen Annehmen eines eingehenden Anrufs.
Anruf umleiten Umleiten eines eingehenden Anrufs an einen anderen Benutzer.
Aufruf ablehnen Ablehnen eines eingehenden Anrufs.
Anruf an Teilnehmer durchstellen Durchstellen eines 1:1-Anrufs an einen anderen Benutzer.
Play Abspielen von Audio für Anrufteilnehmer.
PlayPrompt Wiedergeben eines Prompts für Benutzer als Teil der Erkennungsaktion.
Recognize Erkennen von Benutzereingaben von Anrufteilnehmern.
Teilnehmer hinzufügen Hinzufügen eines Teilnehmers zu einem Anruf.
Teilnehmer entfernen Entfernen eines Teilnehmers aus einem Anruf.
Anruf auflegen Aufhängen Ihres Anrufzweigs.
Anruf beenden Beenden des Anrufs für alle Teilnehmer.
Anruf abrufen Abrufen von Details zum Anruf.
Einen Teilnehmer abrufen Abrufen von Details zu einem Anrufteilnehmer.
Alle Teilnehmer abrufen Abrufen aller Teilnehmer eines Anrufs.
Anruf löschen Löschen eines Anrufs.
Alle Medienvorgänge abbrechen Abbrechen aller laufenden oder in der Warteschlange befindlichen Medienvorgänge in einem Anruf.

Vorgänge für Chat-API-Anforderungsmetriken

Die folgenden Vorgänge sind für Chat-API-Anforderungsmetriken verfügbar:

Vorgang/Route Beschreibung
GetChatMessage Ruft eine Nachricht nach Nachrichten-ID ab.
ListChatMessages Ruft eine Liste von Chat-Nachrichten aus einem Thread ab.
SendChatMessage Sendet eine Chat-Nachricht an einen Thread.
UpdateChatMessage Aktualisiert eine Chat-Nachricht.
DeleteChatMessage Löscht eine Chat-Nachricht.
GetChatThread Ruft einen Chatthread ab.
ListChatThreads Ruft die Liste der Chatthreads eines Benutzers ab.
UpdateChatThread Aktualisiert die Eigenschaften eines Chatthreads.
CreateChatThread Erstellt einen Chatthread.
DeleteChatThread Löscht einen Thread.
GetReadReceipts Ruft Lesebestätigungen für einen Thread ab.
SendReadReceipt Sendet im Auftrag eines Benutzers ein Lesebestätigungsereignis an einen Thread.
SendTypingIndicator Veröffentlicht im Auftrag eines Benutzers ein Eingabeereignis für einen Thread.
ListChatThreadParticipants Ruft die Mitglieder eines Threads ab.
AddChatThreadParticipants Fügt Threadmitglieder zu einem Thread hinzu. Wenn bereits Mitglieder vorhanden sind, erfolgt keine Änderung.
RemoveChatThreadParticipant Entfernt ein Mitglied aus einem Thread.

Screenshot: Chat-API-Anforderungsmetrik.

Bei einer Anforderung an einen Vorgang, der nicht erkannt wird, erhalten Sie eine Antwort mit dem Wert „Ungültige Route“.

Anforderungen der Auftragsrouter-API

Die folgenden Vorgänge sind für Auftragsrouter-API-Anforderungsmetriken verfügbar:

Vorgang/Route Beschreibung
UpsertClassificationPolicy Erstellt oder aktualisiert eine Klassifizierungsrichtlinie.
GetClassificationPolicy Ruft eine vorhandene Klassifizierungsrichtlinie nach ID ab.
ListClassificationPolicies Ruft vorhandene Klassifizierungsrichtlinien ab.
DeleteDistributionPolicy Löscht eine Klassifizierungsrichtlinie nach der ID.
UpsertDistributionPolicy Erstellt oder aktualisiert eine Verteilungsrichtlinie.
GetDistributionPolicy Ruft eine vorhandene Verteilungsrichtlinie nach ID ab.
ListDistributionPolicies Ruft vorhandene Verteilungsrichtlinien ab.
DeleteDistributionPolicy Löscht eine Verteilungsrichtlinie nach ID.
UpsertExceptionPolicy Erstellt oder aktualisiert eine Ausnahmerichtlinie.
GetExceptionPolicy Ruft eine vorhandene Ausnahmerichtlinie nach ID ab.
ListExceptionPolicies Ruft vorhandene Ausnahmerichtlinien ab.
DeleteExceptionPolicy Löscht eine Ausnahmerichtlinie nach ID.
UpsertQueue Erstellt oder aktualisiert eine Warteschlange.
GetQueue Ruft eine vorhandene Warteschlange nach ID ab.
GetQueues Ruft vorhandene Warteschlangen ab.
DeleteQueue Löscht eine Warteschlange nach ID.
GetQueueStatistics Ruft die Statistiken einer Warteschlange ab.
UpsertJob Erstellt oder aktualisiert einen Auftrag.
GetJob Ruft einen vorhandenen Auftrag nach ID ab.
GetJobs Ruft vorhandene Aufträge ab.
DeleteJob Löscht eine Warteschlangenrichtlinie nach ID.
ReclassifyJob Klassifiziert einen Auftrag neu.
CancelJob Sendet eine Anforderung zum Abbrechen eines vorhandenen Auftrags nach ID, während der Grund für das Abbrechen in Freiform angegeben werden kann.
CompleteJob Schließt einen zugewiesenen Auftrag ab.
CloseJob Schließt einen abgeschlossenen Auftrag.
AcceptJobOffer Akzeptiert ein Angebot für die Arbeit an einem Auftrag und gibt einen 409/Konflikt zurück, wenn ein anderer Agent den Auftrag bereits akzeptiert hat.
DeclineJobOffer Lehnt ein Angebot für die Arbeit an einem Auftrag ab.
UpsertWorker Erstellt oder aktualisiert eine Arbeitskraft.
GetWorker Ruft eine vorhandene Arbeitskraft nach ID ab.
GetWorkers Ruft vorhandene Arbeitskräfte ab.
DeleteWorker Löscht eine Arbeitskraft und alle zugehörigen Ablaufverfolgungen.

Network Traversal-API-Anforderungen

Die folgenden Vorgänge sind für Network Traversal-API-Anforderungsmetriken verfügbar:

Vorgang/Route Beschreibung
IssueRelayConfiguration Problemkonfiguration für einen STUN-/TURN-Server

Screenshot: TURN-Token-Anforderungsmetrik.

Räume-API-Anforderungen

Die folgenden Vorgänge sind für Räume-API-Anforderungsmetriken verfügbar:

Vorgang/Route Beschreibung
CreateRoom Erstellt einen Raum.
DeleteRoom Löscht einen Raum.
GetRoom Ruft einen Raum nach Raum-ID ab.
PatchRoom Aktualisiert einen Raum nach Raum-ID.
ListRooms Listet alle Räume für eine Azure Communication Services-Ressource auf.
AddParticipants Fügt einem Raum Teilnehmer hinzu.
RemoveParticipants Entfernt Teilnehmer aus einem Raum.
GetParticipants Ruft eine Liste der Teilnehmer für einen Raum ab.
UpdateParticipants Aktualisiert die Liste der Teilnehmer für einen Raum.

Screenshot: Räume-Anforderungsmetrik.

SMS-API-Anforderungen

Die folgenden Vorgänge sind für SMS-API-Anforderungsmetriken verfügbar:

Vorgang/Route Beschreibung
SMSMessageSent Sendet eine SMS-Nachricht.
SMSDeliveryReportsReceived Ruft SMS-Zustellberichte ab.
SMSMessagesReceived Ruft SMS-Nachrichten ab.

Screenshot: SMS-API-Anforderungsmetrik.

Nächste Schritte