Log di SMS Servizi di comunicazione di Azure

  • Articolo

Servizi di comunicazione di Azure offre funzionalità di registrazione che è possibile usare per monitorare ed eseguire il debug della soluzione. Queste funzionalità possono essere configurate tramite il portale di Azure.

Importante

Di seguito viene fatto riferimento ai 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 risorsa.
  • 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 vogliono inviare dati a più tipi specifici di destinazione (ad esempio, due diverse aree di lavoro di Log Analytics), creare più impostazioni. Ogni risorsa può avere fino a cinque impostazioni di diagnostica.

Di seguito sono riportate le istruzioni per configurare la risorsa di Monitoraggio di Azure per iniziare a creare log e metriche per 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

In nome dell'impostazione di diagnostica selezionare "SMS Operational" per abilitare i log per SMS.

Sintesi

I log operativi SMS sono record di eventi e attività che forniscono informazioni dettagliate sulle richieste API SMS. Sono stati acquisiti dettagli sulle prestazioni e sulle funzionalità della primitiva SMS, inclusi i dettagli sullo stato del messaggio se sono stati recapitati, bloccati o non inviati correttamente. I log operativi SMS contengono informazioni che consentono di 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 dei messaggi.

Categorie di log delle risorse

Servizi di comunicazione offre i tipi di log seguenti che è possibile abilitare:

  • 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 non esiste un'API corrispondente 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 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 a 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 non esiste un'API corrispondente 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 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.
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 o ShortCodeNumber o DynamicAlphaSenderID
MessageID Rappresenta il messageId univoco generato per ogni messaggio in uscita e in arrivo. Questo è disponibile nell'oggetto risposta dell'API SMS
Country Rappresenta i paesi/aree geografiche da cui i messaggi SMS sono stati inviati o ricevuti

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": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "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": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "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": "Incoming_2023011818121211c6ee31-63fe-477c-8d51-f800543c6694",
        "Country": "US"
      }
    ]

(vedere anche Domande frequenti).