Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Servizi di comunicazione di Azure offre funzionalità di registrazione che è possibile usare per monitorare ed eseguire il debug della soluzione Servizi di comunicazione. È possibile configurare queste funzionalità tramite il portale di Azure.
Importante
Questo articolo descrive i log abilitati tramite Monitoraggio di Azure Vedere anche domande frequenti. Per abilitare questi log per i servizi di comunicazione, vedere Abilitare la registrazione in Impostazioni di diagnostica.
Prerequisiti
Servizi di comunicazione di Azure offre funzionalità di monitoraggio e analisi tramite la panoramica dei 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 log e dati di metriche inviati alle destinazioni definite nell'impostazione. Le categorie disponibili variano per i diversi tipi di risorse.
- una o più destinazioni a cui inviare i log. Le destinazioni correnti includono l'area di lavoro di Log Analytics, Hub eventi e Archiviazione di Azure.
- Una singola impostazione di diagnostica può definire al massimo una destinazione di ogni tipo. Se si desidera inviare dati a più di un tipo di destinazione specifico ,ad esempio due aree di lavoro Log Analytics diverse, è necessario creare più impostazioni. Ogni risorsa può avere fino a cinque impostazioni di diagnostica.
Completare queste istruzioni per configurare la risorsa di Monitoraggio di Azure per iniziare a creare log e metriche per i servizi di comunicazione. Per informazioni dettagliate sull'uso delle impostazioni di diagnostica in tutte le risorse di Azure, vedere Abilitare la registrazione in Impostazioni di diagnostica.
Nota
Per abilitare i log per SMS, nel nome dell'impostazione di diagnostica selezionare SMS Operational.
Sintesi
I log operativi SMS sono record di eventi e attività che forniscono informazioni dettagliate sulle richieste API SMS. Registra informazioni dettagliate sulle prestazioni e sulla funzione di SMS. I dettagli includono lo stato dei messaggi, se il messaggio è stato recapitato, bloccato o non è riuscito a inviare.
I log operativi SMS contengono informazioni per identificare tendenze e modelli, risolvere i problemi che potrebbero influire sulle prestazioni, ad esempio i messaggi recapitati non riusciti o i problemi di gestione. I log includono i dettagli seguenti:
- Messaggi inviati.
- Messaggio ricevuto.
- Messaggi recapitati.
- Consenso esplicito e rifiuto esplicito ai messaggi.
Categorie di log delle risorse
I Servizi di Comunicazione offrono i seguenti tipi di registri:
- Log di utilizzo: forniscono i dati di utilizzo associati a ogni offerta di servizio fatturata
- Log operativi degli SMS: forniscono informazioni di base relative al servizio SMS
Schema dei log di utilizzo
Proprietà | Descrizione |
---|---|
Timestamp |
Il timestamp (UTC) relativo alla data e all'ora in cui è stato generato il log. |
Operation Name |
L'operazione associata al record del log. |
Operation Version |
L'oggetto api-version associato all'operazione se operationName è stato eseguito con 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à con cui è possibile abilitare o disabilitare i log di una particolare risorsa. Le proprietà che appaiono all'interno del BLOB delle proprietà di un evento sono le stesse all'interno di una particolare categoria di log e tipo di risorsa. |
Correlation ID |
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. |
Record ID |
L'ID univoco di un record di utilizzo specificato. |
Usage Type |
La modalità di utilizzo. Ad esempio Chat, PSTN, NAT e così via. |
Unit Type |
Il tipo di unità su cui è basato l'utilizzo per una specifica modalità, Ad esempio minuti, megabyte, messaggi e così via. |
Quantity |
Il numero di unità usate o consumate per questo record. |
Log operativi degli SMS
Proprietà | Descrizione |
---|---|
TimeGenerated |
Il timestamp (UTC) relativo alla data e all'ora in cui è stato generato il log. |
OperationName |
L'operazione associata al record del log. |
CorrelationID |
L'ID degli eventi correlati. Può essere usato per identificare eventi correlati tra più tabelle. |
OperationVersion |
L'oggetto api-version associato all'operazione, se operationName è stato eseguito con 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à con cui è possibile abilitare o disabilitare i log di una particolare risorsa. Le proprietà nel blob delle proprietà di un evento sono le stesse all'interno di una determinata categoria di log e tipo di risorsa. |
ResultType |
Lo stato dell'operazione. |
ResultSignature |
Il sottostato dell'operazione. Se questa operazione corrisponde a una chiamata API REST, questo campo contiene il codice di stato HTTP della chiamata REST corrispondente. |
ResultDescription |
La descrizione in testo statico di questa operazione. |
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 accessibile pubblicamente. |
Level |
Il livello di gravità dell'evento. |
URI |
URI della richiesta. |
OutgoingMessageLength |
Il numero di caratteri del messaggio in uscita. |
IncomingMessageLength |
Il numero di caratteri del messaggio in ingresso. |
DeliveryAttempts |
Il numero di tentativi effettuati per recapitare questo messaggio. |
PhoneNumber |
Il numero di telefono da cui viene inviato il messaggio SMS. |
SdkType |
Il tipo di SDK usato nella richiesta. |
PlatformType |
Il tipo di piattaforma usato nella richiesta. |
Method |
Il metodo usato nella richiesta. |
NumberType |
Il tipo di numero, il messaggio SMS da cui viene inviato. Può essere LongCodeNumber, ShortCodeNumber o DynamicAlphaSenderID. |
MessageID |
Rappresenta l'ID messaggio univoco generato per ogni messaggio in uscita e in arrivo. Trovare MessageId nell'oggetto risposta DELL'API SMS. Il formato dell'ID messaggio restituito da questa API è considerato un dettaglio di implementazione interno ed è soggetto a modifiche senza preavviso. I clienti devono considerare l'ID del messaggio come identificatori opachi e non devono analizzare, inferire la struttura o costruire logica in base al loro formato o contenuto. |
Country |
Rappresenta i paesi/aree geografiche da cui vengono inviati o ricevuti messaggi SMS. |
Esempio di log inviato tramite SMS
[
{
"TimeGenerated": "2022-09-26T15:58:30.100Z",
"OperationName": "SMSMessagesSent",
"CorrelationId": "dDRmubfpNZZZZZnxBtw3Q.0",
"OperationVersion": "2020-07-20-preview1",
"Category":"SMSOperational",
"ResultType": "Succeeded",
"ResultSignature": 202,
"DurationMs": 130,
"CallerIpAddress": "127.0.0.1",
"Level": "Informational",
"URI": "https://sms-e2e-prod.communication.azure.com/sms?api-version=2020-07-20-preview1",
"OutgoingMessageLength": 151,
"IncomingMessageLength": 0,
"DeliveryAttempts": 0,
"PhoneNumber": "+18445791704",
"NumberType": "LongCodeNumber",
"SdkType": "azsdk-net-Communication.Sms",
"PlatformType": "Microsoft Windows 10.0.17763",
"Method": "POST",
"MessageId": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
"Country": "US"
}
]
Esempio di log del report di recapito SMS
[
{
"TimeGenerated": "2022-09-26T15:58:30.200Z",
"OperationName": "SMSDeliveryReportsReceived",
"CorrelationId": "tl8WpUTESTSTSTccYadXJm.0",
"Category":"SMSOperational",
"ResultType": "Succeeded",
"ResultSignature": 200,
"DurationMs": 130,
"CallerIpAddress": "127.0.0.1",
"Level": "Informational",
"URI": "https://global.smsgw.prod.communication.microsoft.com/rtc/telephony/sms/DeliveryReport",
"OutgoingMessageLength": 0,
"IncomingMessageLength": 0,
"DeliveryAttempts": 1,
"PhoneNumber": "+18445791704",
"NumberType": "LongCodeNumber",
"SdkType": "",
"PlatformType": "",
"Method": "POST",
"MessageId": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
"Country": "US"
}
]
Esempio di log ricevuto tramite SMS
[
{
"TimeGenerated": "2022-09-27T15:58:30.200Z",
"OperationName": "SMSMessagesReceived",
"CorrelationId": "e2KFTSTSTI/5PTx4ZZB.0",
"Category":"SMSOperational",
"ResultType": "Succeeded",
"ResultSignature": 200,
"DurationMs": 130,
"CallerIpAddress": "127.0.0.1",
"Level": "Informational",
"URI": "https://global.smsgw.prod.communication.microsoft.com/rtc/telephony/sms/inbound",
"OutgoingMessageLength": 0,
"IncomingMessageLength": 110,
"DeliveryAttempts": 0,
"PhoneNumber": "+18445791704",
"NumberType": "LongCodeNumber",
"SdkType": "",
"PlatformType": "",
"Method": "POST",
"MessageId": "11c6ee31-63fe-477c-8d51-f800543c6694",
"Country": "US"
}
]