Log di Automazione delle chiamate di Servizi di comunicazione di Azure
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 offre funzionalità di monitoraggio e analisi tramite i log di Monitoraggio di Azure e le 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 attuali includono l'area di lavoro Log Analytics, Hub eventi di Azure e Archiviazione di Azure.
Una singola impostazione di diagnostica può definire un solo elemento per ogni tipo di destinazione. Se si vogliono inviare dati a più tipi di destinazione (ad esempio due aree di lavoro Log Analytics), è necessario 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, 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 una documentazione dettagliata 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 seguenti tipi di log che è possibile abilitare:
- Log di utilizzo: forniscono i dati di utilizzo associati a ogni offerta del 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 degli elementi multimediali 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 tali 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) relativo alla data e all'ora in cui è stato generato il log. |
OperationName |
Operazione associata al record del 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 di tale operazione nel caso in cui le proprietà associate all'operazione cambino in futuro. |
Category |
La categoria di log dell'evento. La categoria è la granularità con cui è possibile abilitare o disabilitare i log di una risorsa. Le proprietà che appaiono all'interno del BLOB properties di un evento sono le stesse all'interno di una categoria di log e di un tipo di risorsa. |
CorrelationID |
L'ID degli eventi correlati. Può essere usato per identificare 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) relativo alla data e all'ora in cui è stato generato il log. |
OperationName |
Operazione associata al record del 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 di tale operazione nel caso in cui le proprietà associate all'operazione cambino in futuro. |
Category |
La categoria di log dell'evento. La categoria è la granularità con cui è possibile abilitare o disabilitare i log di una risorsa. Le proprietà che appaiono all'interno del BLOB properties di un evento sono le stesse all'interno di una categoria di log e di 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 |
L'indirizzo IP del chiamante, se l'operazione corrisponde a una chiamata API proveniente da un'entità con un indirizzo IP pubblicamente disponibile. |
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 |
Il tipo di SDK usato nella 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 degli elementi multimediali di Automazione delle chiamate
| Proprietà | Descrizione |
|---|---|
TimeGenerated |
Indicatore data e ora (UTC) dell'evento. |
level |
Il livello di gravità dell'evento. Deve essere Informational, Warning, Error o Critical. |
resourceId |
ID della risorsa che ha emesso 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, Canceled e 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, TextToSpeech e SSML. |
playInLoop |
True se è stato richiesto un ciclo per l'operazione di riproduzione. False in caso contrario. |
playToParticipant |
True se l'operazione di riproduzione aveva una destinazione. False nel caso di un'operazione play-to-all. |
interrupted |
True se il prompt viene interrotto. False in caso contrario. |
resultCode |
Codice di 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 degli elementi multimediali 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."
}