Ü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. |
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. |
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. |
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 |
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. |
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. |
Nächste Schritte
- Erfahren Sie mehr über Datenplattformmetriken.