Servizi di comunicazione di Azure log di automazione delle chiamate
Servizi di comunicazione di Azure offre funzionalità di registrazione che è possibile usare per monitorare ed eseguire il debug della soluzione. Queste funzionalità vengono configurate tramite il portale di Azure.
Prerequisiti
Servizi di comunicazione di Azure fornisce funzionalità di monitoraggio e analisi tramite Log di Monitoraggio di Azure e Metriche di Monitoraggio di Azure. Ogni risorsa di Azure richiede una propria impostazione di diagnostica, che definisce i criteri seguenti:
Categorie di dati di log e metrica inviati alle destinazioni definite dall'impostazione. Le categorie disponibili variano in base al tipo di risorsa.
una o più destinazioni a cui inviare i log. Le destinazioni correnti includono area di lavoro Log Analytics, Hub eventi di Azure e Archiviazione di Azure.
Una singola impostazione di diagnostica può definire non più di uno di ogni tipo di destinazione. Se si vogliono inviare dati a più tipi di destinazione, ad esempio due aree di lavoro Log Analytics, creare più impostazioni. Ogni risorsa può avere fino a cinque impostazioni di diagnostica.
Importante
È necessario abilitare un'impostazione di diagnostica in Monitoraggio di Azure per inviare i dati di log dei sondaggi a un'area di lavoro Log Analytics, a un hub eventi o a un account di archiviazione di Azure per ricevere e analizzare i dati del sondaggio. Se non si inviano dati di Automazione chiamata a una di queste opzioni, i dati del sondaggio non verranno archiviati e andranno persi.
Le istruzioni seguenti configurano la risorsa di Monitoraggio di Azure per iniziare a creare log e metriche per l'istanza di Servizi di comunicazione. Per informazioni dettagliate sull'uso delle impostazioni di diagnostica in tutte le risorse di Azure, vedere Abilitare la registrazione nelle impostazioni di diagnostica.
Sotto il nome dell'impostazione di diagnostica selezionare Log di automazione chiamate operazione e Log riepilogo eventi di automazione delle chiamate per abilitare i log per Automazione chiamate.
Categorie di log delle risorse
Servizi di comunicazione offre i tipi di log seguenti che è possibile abilitare:
- Log di utilizzo: specificare i dati di utilizzo associati a ogni offerta di servizio fatturata.
- Log operativi di Automazione delle chiamate: fornire informazioni operative sulle richieste dell'API di automazione delle chiamate. È possibile usare questi log per identificare i punti di errore ed eseguire query su tutte le richieste effettuate in una chiamata (usando l'ID correlazione o l'ID chiamata server).
- Log di riepilogo dei supporti di Automazione delle chiamate: fornire informazioni sul risultato delle operazioni multimediali. Questi log vengono visualizzati in modo asincrono quando si effettuano richieste multimediali usando le API di automazione delle chiamate. È possibile usare questi log per identificare i punti di errore e i possibili modelli su come gli utenti interagiscono con l'applicazione.
Schema del log di utilizzo
| Proprietà | Descrizione |
|---|---|
Timestamp |
Timestamp (UTC) di quando è stato generato il log. |
OperationName |
Operazione associata al record di log. |
OperationVersion |
Valore api-version associato all'operazione, se l'operazione OperationName è stata eseguita tramite un'API. Se nessuna API corrisponde a questa operazione, la versione rappresenta la versione dell'operazione, nel caso in cui le proprietà associate all'operazione cambino in futuro. |
Category |
La categoria di log dell'evento. La categoria è la granularità in base alla quale è possibile abilitare o disabilitare i log in una risorsa. Le proprietà visualizzate all'interno del properties BLOB di un evento sono le stesse all'interno di una categoria di log e un tipo di risorsa. |
CorrelationID |
L'ID degli eventi correlati. È possibile usarlo per identificare gli eventi correlati tra più tabelle. |
Properties |
Altri dati applicabili a varie modalità di Servizi di comunicazione. |
RecordID |
ID univoco per un record di utilizzo. |
UsageType |
Modalità di utilizzo , ad esempio Chat, PSTN o NAT. |
UnitType |
Tipo di unità su cui si basa l'utilizzo per una modalità di utilizzo, ad esempio minuti, megabyte o messaggi. |
Quantity |
Il numero di unità usate o consumate per questo record. |
Log operativi di Automazione delle chiamate
| Proprietà | Descrizione |
|---|---|
TimeGenerated |
Timestamp (UTC) di quando è stato generato il log. |
OperationName |
Operazione associata al record di log. |
CorrelationID |
Identificatore per identificare una chiamata e correlare eventi per una chiamata univoca. |
OperationVersion |
Versione api-version associata all'operazione, se l'operazione operationName è stata eseguita tramite un'API. Se nessuna API corrisponde a questa operazione, la versione rappresenta la versione dell'operazione, nel caso in cui le proprietà associate all'operazione cambino in futuro. |
Category |
La categoria di log dell'evento. La categoria è la granularità in base alla quale è possibile abilitare o disabilitare i log in una risorsa. Le proprietà visualizzate all'interno del properties BLOB di un evento sono le stesse all'interno di una categoria di log e un tipo di risorsa. |
ResultType |
Lo stato dell'operazione. |
ResultSignature |
Stato secondario dell'operazione. Se questa operazione corrisponde a una chiamata API REST, questo campo contiene il codice di stato HTTP della chiamata REST corrispondente. |
DurationMs |
La durata dell'operazione in millisecondi. |
CallerIpAddress |
Indirizzo IP del chiamante, se l'operazione corrisponde a una chiamata API proveniente da un'entità con un indirizzo IP disponibile pubblicamente. |
Level |
Il livello di gravità dell'evento. |
URI |
URI della richiesta. |
CallConnectionId |
ID che rappresenta la connessione di chiamata, se disponibile. Questo ID è diverso per ogni partecipante e viene usato per identificare la connessione alla chiamata. |
ServerCallId |
ID univoco per identificare una chiamata. |
SDKVersion |
Versione dell'SDK usata per la richiesta. |
SDKType |
Tipo di SDK usato per la richiesta. |
ParticipantId |
ID per identificare il partecipante della chiamata che ha effettuato la richiesta. |
SubOperationName |
Nome usato per identificare il sottotipo di operazione multimediale (riproduzione o riconoscimento). |
operationID |
ID usato per correlare gli eventi asincroni. |
Di seguito è riportato un esempio di log operativo di Automazione chiamate:
[
{
"TimeGenerated [UTC]": "5/25/2023, 5:43:25.746 PM",
"Level": "Informational",
"CorrelationId": "e2a97d52-0cbb-4adf-8c4b-e10f791fb764",
"OperationName": "Play",
"OperationVersion": "3/6/23",
"URI": "ccts-media-synthetics-prod.communication.azure.com",
"ResultType": "Succeeded",
"ResultSignature": "202",
"DurationMs": "82",
"CallerIpAddress": "40.88.50.228",
"CallConnectionId": "401f3500-fcb6-4b84-927e-81cd6372560b",
"ServerCallId": "aHR0cHM6Ly9hcGkuZmxpZ2h0cHJveHkuc2t5cGUuY29tL2FwaS92Mi9jcC9jb252LXVzZWEyLTAxLmNvbnYuc2t5cGUuY29tL2NvbnYvZzRoWlVoS1ZEVUtma19HenRDZ1JTQT9pPTEyJmU9NjM4MjA1NDc4MDg5MzEzMjIz",
"SdkVersion": "",
"SdkType": "unknown",
"SubOperationName": "File",
"OperationId": "5fab0875-3211-4879-8051-c688d0854c4d",
}
Log di riepilogo dei supporti di Automazione delle chiamate
| Proprietà | Descrizione |
|---|---|
TimeGenerated |
Timestamp (UTC) dell'evento. |
level |
Il livello di gravità dell'evento. Deve essere uno di Informational, Warning, Erroro Critical. |
resourceId |
ID della risorsa che ha generato l'evento. |
durationMs |
La durata dell'operazione in millisecondi. |
callerIpAddress |
|
correlationId |
ID catena Skype. |
operationName |
Nome dell'operazione rappresentata da questo evento. |
operationVersion |
|
resultType |
Lo stato dell'evento. I valori tipici includono Completed, Cancelede Failed. |
resultSignature |
Stato secondario dell'operazione. Se questa operazione corrisponde a una chiamata API REST, questo campo contiene il codice di stato HTTP della chiamata REST corrispondente. |
operationId |
ID operazione usato per correlare gli eventi asincroni. |
recognizePromptSubOperationName |
Sottotipo dell'operazione. I valori potenziali includono File, TextToSpeeche SSML. |
playInLoop |
True se è stato richiesto un ciclo per l'operazione di riproduzione. False in caso contrario. |
playToParticipant |
True se l'operazione di riproduzione ha una destinazione. False se fosse un'operazione play-to-all. |
interrupted |
True se il prompt viene interrotto. False in caso contrario. |
resultCode |
Codice del risultato dell'operazione. |
resultSubcode |
Codice secondario del risultato dell'operazione. |
resultMessage |
Messaggio di risultato dell'operazione. |
Di seguito è riportato un esempio di log di riepilogo dei supporti di Automazione chiamata:
[
{
"TimeGenerated [UTC]": "5/24/2023, 7:57:40.480 PM",
"Level": "Informational",
"CorrelationId": "d149d528-a392-404c-8fcd-69087e9d0802",
"ResultType": "Completed",
"OperationName": "Play",
"OperationId": "7bef24d5-eb95-4ee6-bbab-0b7d45d91288",
"PlayInLoop": "FALSE",
"PlayToParticipant": "TRUE",
"PlayInterrupted": "FALSE",
"RecognizePromptSubOperationName": "",
"ResultCode": "200",
"ResultSubcode": "0",
"ResultMessage": "Action completed successfully."
}
Passaggi successivi
- Informazioni sul dashboard delle informazioni dettagliate per monitorare i log e le metriche di Automazione delle chiamate.