Log di posta elettronica

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

I servizi di comunicazione di Azure offrono funzionalità di monitoraggio e analisi tramite la Panoramica dei log di Azure Monitor e le Metriche di Azure Monitor. 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 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 vengono archiviati e persi.

Completare le istruzioni seguenti per configurare la risorsa di Monitoraggio di Azure per iniziare a creare log e metriche per i servizi di comunicazione. Per altre informazioni 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 Log di aggiornamento dello stato di recapito del servizio Email, Log di invio delle email del servizio e Log di coinvolgimento utente del servizio Email per abilitare i log di posta elettronica.

Categorie di log delle risorse

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

• Log di utilizzo: fornisce 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	api-version associato all'operazione se operationName è stato eseguito usando 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 di invio email e messaggi di posta

I log operativi di invio di messaggi di posta elettronica forniscono informazioni dettagliate preziose sulle tendenze delle richieste API nel tempo. Questi dati ti aiutano a scoprire i principali dati analitici delle email, come il numero totale di email inviate, la dimensione delle email e il numero di email 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 registro 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 CorrelationId viene mappato all'identificativo 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	Il 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 registro 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 CorrelationId viene mappato all'identificativo MessageId, il quale viene restituito da una richiesta SendMail riuscita.
RecipientId	Indirizzo di posta elettronica del destinatario. È presente solo per gli eventi a livello di destinatario. Se si tratta di un evento a livello di messaggio, la proprietà è vuota.
DeliveryStatus	Stato terminale del messaggio. I valori possibili per l'evento a livello di messaggio sono: Dropped, OutForDelivery, Queued. I valori possibili per un evento a livello di destinatario sono: Delivered, Expanded, FailedQuarantined, FilteredSpam, SuppressedBounced.
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 coinvolgimento 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 registro 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 CorrelationId viene mappato all'identificativo MessageId, il quale viene restituito da una richiesta SendMail riuscita.
RecipientId	Indirizzo di posta elettronica del destinatario. Se si tratta di un evento a livello di messaggio, la proprietà è 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"
}