Condividi tramite

Log SMS

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"
      }
    ]

Domande frequenti su SMS