Condividi tramite


Panoramica delle metriche

Servizi di comunicazione di Azure offre attualmente metriche per tutte le primitive dei servizi di comunicazione di Azure. È possibile usare Esplora metriche di Azure per tracciare i propri grafici, analizzare le anomalie nei valori delle metriche e interpretare il traffico API usando i dati delle metriche generati dalle richieste di email.

Dove trovare le metriche

Le primitive in Servizi di comunicazione di Azure generano metriche per le richieste API. Queste metriche sono disponibili nella scheda Metriche nella risorsa servizi di comunicazione. È anche possibile creare dashboard permanenti usando la scheda Cartelle di lavoro nella risorsa di Servizi di comunicazione.

Definizioni di metrica

Tutte le metriche delle richieste API contengono tre dimensioni che è possibile usare per filtrare i dati. Queste dimensioni possono essere aggregate usando il tipo di aggregazione Count e supportano tutte le serie temporali di aggregazione standard di Azure, tra cui Sum, Average, Min e Max.

Altre informazioni sui tipi di aggregazione supportati e sulle aggregazioni di serie temporali sono disponibili in Funzionalità avanzate di Esplora metriche di Azure

  • Operazione: tutte le operazioni o le route che possono essere chiamate nel gateway chat di Servizi di comunicazione di Azure.
  • Codice di stato: la risposta del codice di stato inviata dopo la richiesta.
  • StatusSubClass: la serie di codici di stato inviati dopo la risposta.

Richieste API di messaggistica avanzata

Le operazioni seguenti sono disponibili nelle metriche delle richieste API di messaggistica avanzata:

Operazione/Route Descrizione Scenario
DownloadMedia Scaricare la richiesta di payload multimediale. L'azienda ha richiesto di scaricare il payload multimediale.
ListTemplates Richiesta dei modelli di elenco. L'azienda ha richiesto di elencare i modelli per un determinato canale.
ReceiveMessage Messaggio ricevuto. L'utente ha inviato un messaggio all'azienda.
SendMessage Inviare una richiesta di notifica dei messaggi. Azienda che richiede di inviare un messaggio all'utente.
SendMessageDeliveryStatus Stato consegna ricevuto. L'azienda ha ricevuto una risposta su un messaggio che l'azienda ha richiesto di inviare a un utente.

Screenshot della metrica della richiesta di messaggistica avanzata.

Richieste API di autenticazione

Per le metriche delle richieste API di autenticazione sono disponibili le operazioni seguenti:

Operazione/Route Descrizione
CreateIdentity Crea un'identità che rappresenta un singolo utente.
DeleteIdentity Elimina un'identità.
CreateToken Crea un token di accesso.
RevokeToken Revoca tutti i token di accesso creati per un'identità prima di una data o un'ora specificata.
ExchangeTeamsUserAccessToken Scambiare un token di accesso Microsoft Entra di un utente di Teams per un nuovo token di accesso identità di comunicazione con una scadenza corrispondente.

Screenshot della metrica della richiesta di autenticazione.

Richieste API di automazione delle chiamate

Per le metriche delle richieste API di automazione delle chiamate sono disponibili le operazioni seguenti:

Operazione/Route Descrizione
Crea chiamata Creare una chiamata in uscita all'utente.
Chiamata di risposta Rispondere a una chiamata in ingresso.
Chiamata di reindirizzamento Reindirizzare una chiamata in ingresso a un altro utente.
Rifiuta chiamata Rifiutare una chiamata in ingresso.
Trasferisci chiamata al partecipante Trasferire 1:1 chiamata a un altro utente.
Riproduci Riproduci audio per chiamare i partecipanti.
PlayPrompt Riprodurre una richiesta agli utenti come parte dell'azione Recognize.
Recognize Riconoscere l'input dell'utente dai partecipanti alla chiamata.
Aggiungi partecipanti Aggiungere un partecipante a una chiamata.
Rimuovi partecipanti Rimuovere un partecipante da una chiamata.
HangUp Call Interrompi un tratto della chiamata.
Termina chiamata Terminare la chiamata a tutti i partecipanti.
Ottieni chiamata Ottenere informazioni dettagliate su una chiamata.
Ottieni partecipante Ottenere dettagli su un partecipante di una chiamata.
Ottieni partecipanti Ottenere tutti i partecipanti a una chiamata.
Elimina chiamata Eliminare una chiamata.
Annulla tutte le operazioni multimediali Annullare tutte le operazioni multimediali in corso o in coda in una chiamata.

Operazioni per le metriche delle richieste API di Chat

Per le metriche delle richieste API di Chat sono disponibili le operazioni seguenti:

Operazione/Route Descrizione
GetChatMessage Ottiene un messaggio in base a ID messaggio.
ListChatMessages Ottiene un elenco di messaggi di chat da un thread.
SendChatMessage Invia un messaggio di chat a un thread.
UpdateChatMessage Aggiorna un messaggio di chat.
DeleteChatMessage Elimina un messaggio di chat.
GetChatThread Ottiene un thread di chat.
ListChatThreads Ottiene l'elenco dei thread di chat di un utente.
UpdateChatThread Aggiorna le proprietà di un thread di chat.
CreateChatThread Crea un thread di chat.
DeleteChatThread Elimina un thread.
GetReadReceipts Ottiene le conferme di lettura per un thread.
SendReadReceipt Invia un evento di conferma di lettura a un thread per conto di un utente.
SendTypingIndicator Pubblica un evento di digitazione in un thread per conto dell'utente.
ListChatThreadParticipants Ottiene i membri di un thread.
AddChatThreadParticipants Aggiunge membri a un thread. Se i membri esistono già, non vengono apportate modifiche.
RemoveChatThreadParticipant Rimuove un membro da un thread.

Screenshot della metrica di richiesta dell'API Chat.

Se viene effettuata una richiesta a un'operazione non riconosciuta, si riceve una risposta con il valore "Route errata".

Richieste API router processo

Per le metriche delle richieste API del router processi sono disponibili le operazioni seguenti:

Operazione/Route Descrizione
UpsertClassificationPolicy Crea o aggiorna un criterio di classificazione.
GetClassificationPolicy Recupera un criterio di classificazione esistente in base all'ID.
ListClassificationPolicies Recupera i criteri di classificazione esistenti
DeleteDistributionPolicy Elimina un criterio di classificazione in base all'ID.
UpsertDistributionPolicy Crea o aggiorna un criterio di distribuzione.
GetDistributionPolicy Recupera un criterio di distribuzione esistente in base all'ID.
ListDistributionPolicies Recupera i criteri di distribuzione esistenti
DeleteDistributionPolicy Elimina un criterio di distribuzione in base all'ID.
UpsertExceptionPolicy Crea o aggiorna un criterio di eccezione.
GetExceptionPolicy Recupera un criterio di eccezione esistente in base all'ID.
ListExceptionPolicies Recupera i criteri di eccezione esistenti
DeleteExceptionPolicy Elimina un criterio di eccezione in base all'ID.
UpsertQueue Crea o aggiorna una coda.
GetQueue Recupera una coda esistente in base all'ID.
GetQueues Recupera le code esistenti
DeleteQueue Elimina una coda in base all'ID.
GetQueueStatistics Recupera le statistiche di una coda.
UpsertJob Crea o aggiorna un processo.
GetJob Recupera un processo esistente in base all'ID.
GetJobs Recupera i processi esistenti
DeleteJob Elimina un criterio di coda in base all'ID.
ReclassifyJob Riclassifica un processo.
CancelJob Invia una richiesta di annullamento di un processo esistente in base all'ID fornendo un motivo di annullamento in formato libero.
Processo completo Completa un processo assegnato.
CloseJob Chiude un processo completato.
AcceptJobOffer Accetta un'offerta per lavorare su un processo e restituisce un 409/conflitto se un altro agente ha già accettato il processo.
DeclineJobOffer Rifiuta un'offerta per lavorare su un lavoro.
UpsertWorker Crea o aggiorna un ruolo di lavoro.
GetWorker Recupera un ruolo di lavoro esistente in base all'ID.
GetWorkers Recupera i ruoli di lavoro esistenti.
DeleteWorker Elimina un ruolo di lavoro e tutte le relative tracce.

Richieste API di attraversamento di rete

Le operazioni seguenti sono disponibili nelle metriche delle richieste dell'API attraversamento di rete:

Operazione/Route Descrizione
IssueRelayConfiguration Problema di configurazione per un server STUN/TURN.

Screenshot della metrica di richiesta del token TURN.

Richieste API Rooms

Le operazioni seguenti sono disponibili nelle metriche delle richieste dell'API Rooms:

Operazione/Route Descrizione
CreateRoom Crea una stanza.
DeleteRoom Elimina una stanza.
GetRoom Ottiene una stanza in base all'ID della stanza.
PatchRoom Aggiorna una stanza in base all'ID sala.
ListRoom Elenca tutte le stanze per una risorsa di Servizi di comunicazione di Azure.
AddParticipants Aggiunge partecipanti a una stanza.
RemoveParticipants Rimuove i partecipanti da una stanza.
GetParticipants Ottiene l'elenco dei partecipanti per una stanza.
UpdateParticipants Aggiorna l'elenco dei partecipanti per una stanza.

Screenshot della metrica richiesta di stanze.

Richieste API di SMS

Per le metriche delle richieste API di SMS sono disponibili le operazioni seguenti:

Operazione/Route Descrizione
SMSMessageSent invia un SMS.
SMSDeliveryReportsReceived Ottiene i report di recapito di SMS
SMSMessagesReceived Ottiene i messaggi SMS.

Screenshot della metrica di richiesta dell'API SMS.

Passaggi successivi