Log di posta elettronica 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à possono essere configurate tramite il portale di Azure.

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.

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 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 delle chiamate a una di queste opzioni, i dati del sondaggio non verranno archiviati e andranno persi. Di seguito sono riportate le 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 il nome dell'impostazione di diagnostica, selezionare "Log di aggiornamento stato di recapito del servizio di posta elettronica", "MLog di invio di messaggi di posta elettronica del servizio di posta elettronica", "Log di engagement degli utenti del servizio di posta elettronica" per abilitare i log per i messaggi di posta elettronica

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 di invio di messaggi di posta elettronica: forniscono informazioni dettagliate relative alle richieste di messaggi di posta elettronica inviate dal servizio di posta elettronica.
• Log operativi di aggiornamento dello stato della posta elettronica: forniscono aggiornamenti sullo stato di recapito, a livello di messaggio e destinatario, correlato alle richieste di invio di messaggi di posta elettronica del servizio di posta elettronica.
• Log operativi di engagement degli utenti di posta elettronica: forniscono informazioni correlate alle metriche di engagement degli utenti "open" e "click" per i messaggi inviati dal servizio di posta elettronica.

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 di invio di messaggi di posta elettronica

I log operativi di invio di messaggi di posta elettronica forniscono informazioni dettagliate preziose sulle tendenze delle richieste API nel tempo. Questi dati consentono di i dati analitici chiave di posta elettronica, ad esempio il numero totale di messaggi di posta elettronica inviati, le dimensioni dei messaggi di posta elettronica e il numero di messaggi di posta elettronica con allegati. Queste informazioni possono essere analizzate rapidamente quasi in tempo reale e visualizzate in modo intuitivo per ottimizzare il processo decisionale.

Proprietà	Descrizione
TimeGenerated	Il timestamp (UTC) relativo alla data e all'ora in cui è stato generato il log.
Location	Area in cui è stata elaborata l'operazione.
OperationName	Operazione associata al record di log.
OperationVersion	L'api-version associato all'operazione se operationName è stato eseguito tramite 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.
CorrelationID	L'ID degli eventi correlati. Può essere usato per identificare eventi correlati tra più tabelle. Per tutti i log operativi di posta elettronica, Il valore CorrelationId viene mappato al MessageId, il quale viene restituito da una richiesta SendMail riuscita.
Size	Rappresenta le dimensioni totali del corpo del messaggio di posta elettronica, dell'oggetto, delle intestazioni e degli allegati in megabyte.
ToRecipientsCount	Totale # di indirizzi di posta elettronica univoci nella Riga A.
CcRecipientsCount	Totale # di indirizzi di posta elettronica univoci nella riga Cc.
BccRecipientsCount	Totale # di indirizzi di posta elettronica univoci nella riga Ccn.
UniqueRecipientsCount	Si tratta del conteggio totale dei destinatari deduplicato per i campi indirizzo A, Cc e Ccn.
AttachmentsCount	Totale # di allegati.
TrafficSource	Nome del client da cui ha avuto origine la richiesta di posta elettronica.

Esempi

{
  "OperationType":"SendMail", 
  "OperationCategory":"EmailSendMailOperational",
  "Size":0.026019,
  "ToRecipientsCount":2,
  "CcRecipientsCount":3, 
  "BccRecipientsCount":1, 
  "UniqueRecipientsCount":6, 
  "AttachmentsCount":0,
  "TrafficSource":"Email .NET SDK"
}

Log operativi di aggiornamento dello stato di posta elettronica

I log operativi di aggiornamenti dello stato di posta elettronica forniscono informazioni approfondite sugli aggiornamenti dello stato di recapito a livello di messaggio e a livello di destinatario nelle richieste dell'API sendmail.

• Gli aggiornamenti di stato a livello di messaggio forniscono lo stato dell'operazione di invio tramite posta elettronica a esecuzione prolungata (analogamente agli aggiornamenti di stato ricevuti tramite la chiamata alle API GET). Questi elementi sono contrassegnati dall'assenza della proprietà RecipientId, poiché questi aggiornamenti sono relativi all'intero messaggio e non sono applicabili a un destinatario specifico nella richiesta di messaggio. La proprietà DeliveryStatus contiene lo stato di recapito a livello di messaggio. I valori possibili per DeliveryStatus per questo tipo di evento sono Dropped, OutForDeliverye Queued.
• Gli aggiornamenti di stato a livello di destinatario forniscono lo stato del recapito tramite posta elettronica per ogni singolo destinatario a cui è stato inviato il messaggio di posta elettronica in un singolo messaggio. Contengono una proprietà RecipientId con l'indirizzo di posta elettronica del destinatario. Lo stato di recapito a livello di destinatario viene fornito nella proprietà DeliveryStatus. I valori possibili per DeliveryStatus per questo tipo di evento sono Delivered, Expanded, Failed, Quarantined, FilteredSpam, Suppressed, e Bounced. Tramite il monitoraggio di questi log, è possibile garantire la visibilità completa del processo di recapito della posta elettronica, identificando rapidamente eventuali problemi che potrebbero verificarsi e intraprendendo azioni correttive in base alle esigenze.

Proprietà	Descrizione
TimeGenerated	Il timestamp (UTC) relativo alla data e all'ora in cui è stato generato il log.
Location	Area in cui è stata elaborata l'operazione.
OperationName	Operazione associata al record di log.
OperationVersion	L'api-version associato all'operazione se operationName è stato eseguito tramite 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.
CorrelationID	L'ID degli eventi correlati. Può essere usato per identificare eventi correlati tra più tabelle. Per tutti i log operativi di posta elettronica, Il valore CorrelationId viene mappato al MessageId, il quale viene restituito da una richiesta SendMail riuscita.
RecipientId	Indirizzo di posta elettronica del destinatario. È presente solo per eventi a livello di destinatario. Per eventi a livello di messaggio, la proprietà sarà vuota.
DeliveryStatus	Stato terminale del messaggio. I possibili valori per l'evento a livello di messaggio sono: Dropped, OutForDelivery, Queued. I possibili valori per un evento a livello di destinatario sono: Delivered, Expanded, Failed, Quarantined, FilteredSpam, Suppressed Bounced.
SmtpStatusCode	Codice di stato SMTP restituito dal server di posta elettronica destinatario in risposta a una richiesta di invio di posta elettronica.
EnhancedSmtpStatusCode	Codice di stato SMTP migliorato restituito dal server di posta elettronica del destinatario.
SenderDomain	Porzione del dominio di SenderAddress utilizzata per l'invio di messaggi di posta elettronica.
SenderUsername	Porzione del nome utente di SenderAddress utilizzata per l'invio di messaggi di posta elettronica.
IsHardBounce	Indica se un errore di recapito è dovuto a un problema permanente o temporaneo. IsHardBounce == true indica un problema permanente relativo alla cassetta postale che impedisce il recapito di messaggi di posta elettronica.

Esempi

{
  "OperationType":"DeliveryStatusUpdate", 
  "OperationCategory":"EmailStatusUpdateOperational", 
  "RecipientId":"user@email.com", 
  "DeliveryStatus":"Delivered", 
  "SenderDomain":"contoso.com", 
  "SenderUsername":"donotreply", 
  "IsHardBounce":false
}

Log operativi di engagement degli utenti di posta elettronica

I log operativi di engagement degli utenti di posta elettronica forniscono informazioni dettagliate sulle tendenze di engagement della posta elettronica per il sistema di posta elettronica. Questi dati consentono di tenere traccia di e analizzare le metriche chiave di posta elettronica, ad esempio tassi aperti, tassi click-through e tassi di annullamento della sottoscrizione. Questi log possono essere archiviati e analizzati, consentendo di ottenere informazioni più approfondite sulle prestazioni del sistema di posta elettronica e adattare la propria strategia di conseguenza. In generale, i log operativi di engagement degli utenti di posta elettronica offrono uno strumento efficace per migliorare le prestazioni del sistema di posta elettronica, misurare proattivamente e migliorare le campagne di posta elettronica e aumentare l'engagement degli utenti nel corso del tempo.

Proprietà	Descrizione
TimeGenerated	Il timestamp (UTC) relativo alla data e all'ora in cui è stato generato il log.
Location	Area in cui è stata elaborata l'operazione.
OperationName	Operazione associata al record di log.
OperationVersion	L'api-version associato all'operazione se operationName è stato eseguito tramite 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.
CorrelationID	L'ID degli eventi correlati. Può essere usato per identificare eventi correlati tra più tabelle. Per tutti i log operativi di posta elettronica, Il valore CorrelationId viene mappato al MessageId, il quale viene restituito da una richiesta SendMail riuscita.
RecipientId	Indirizzo di posta elettronica del destinatario. Per eventi a livello di messaggio, la proprietà sarà vuota.
EngagementType	Tipo di engagement degli utenti monitorato.
EngagementContext	Il contesto rappresenta gli elementi con cui l'utente ha interagito.
UserAgent	Stringa agente utente dal client.

Esempi

{
    "OperationType": "UserEngagementUpdate",
    "OperationCategory": "EmailUserEngagementOperational",
    "EngagementType": "View",
    "UserAgent": "Mozilla/5.0"
}

{
  "OperationType":"UserEngagementUpdate", 
  "OperationCategory":"EmailUserEngagementOperational",
  "EngagementType":"Click",
  "EngagementContext":"https://www.contoso.com/support?id=12345", 
  "UserAgent":"Mozilla/5.0"
}