Servizi di comunicazione di Azure 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à 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 delle 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 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ù di un tipo di destinazione specifico (ad esempio, due aree di lavoro Log Analytics diverse), 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 di Impostazioni di diagnostica in tutte le risorse di Azure, vedere Abilitare la registrazione in Diagnostica Impostazioni

Nota

In nome dell'impostazione di diagnostica selezionare "Log di aggiornamento stato recapito del servizio di posta elettronica", "Messaggi di posta elettronica Service Send Mail Logs", "Email Service User Engagement Logs" 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
• Messaggi di posta elettronica invia log operativi: fornisce informazioni dettagliate relative alle richieste di posta elettronica inviate dal servizio di posta elettronica.
• Log operativi di Aggiornamento stato posta elettronica: fornisce aggiornamenti dello stato di recapito a livello di messaggio e destinatario correlati alle richieste di posta elettronica inviate dal servizio di posta elettronica.
• Log operativi di Email User Engagement: fornisce informazioni correlate alle metriche di coinvolgimento 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 è presente alcuna API che corrisponde 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à in cui è possibile abilitare o disabilitare i log in una determinata 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.

Inviare messaggi di posta elettronica ai log operativi

I log operativi dell'invio di posta elettronica forniscono informazioni dettagliate preziose sulle tendenze delle richieste API nel tempo. Questi dati consentono di individuare l'analisi della posta elettronica chiave, ad esempio il numero totale di messaggi di posta elettronica inviati, le dimensioni della 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 migliorare 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 è presente alcuna API che corrisponde 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à in cui è possibile abilitare o disabilitare i log in una determinata 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, 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	Numero totale di indirizzi di posta elettronica univoci nella riga A.
CcRecipientsCount	Numero totale di indirizzi di posta elettronica univoci nella riga Cc.
BccRecipientsCount	Numero 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	Numero 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 dell'aggiornamento dello stato della posta elettronica

I log operativi degli aggiornamenti dello stato della posta elettronica forniscono informazioni approfondite sugli aggiornamenti dello stato di recapito a livello di messaggio e destinatario nelle richieste dell'API sendmail. Questi log offrono dettagli specifici del messaggio, ad esempio l'ora di recapito, nonché i dettagli a livello di destinatario, ad esempio gli indirizzi di posta elettronica e gli aggiornamenti dello stato del recapito. Monitorando questi log, è possibile garantire la visibilità completa del processo di recapito della posta elettronica, identificando rapidamente eventuali problemi che possono verificarsi e intraprendere 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 è presente alcuna API che corrisponde 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à in cui è possibile abilitare o disabilitare i log in una determinata 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, restituito da una richiesta SendMail riuscita.
RecipientId	Indirizzo di posta elettronica per il destinatario di destinazione. Se si tratta di un evento a livello di messaggio, la proprietà sarà vuota.
DeliveryStatus	Stato del terminale del messaggio.
SmtpStatusCode	Codice di stato SMTP restituito dal server di posta elettronica destinatario in risposta a una richiesta di posta elettronica di invio.
EnhancedSmtpStatusCode	Codice di stato SMTP migliorato restituito dal server di posta elettronica del destinatario.
SenderDomain	Parte del dominio di SenderAddress utilizzata per l'invio di messaggi di posta elettronica.
SenderUsername	Parte 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 della cassetta postale che impedisce il recapito dei 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 Email User Engagement

I log operativi di engagement degli utenti tramite posta elettronica forniscono informazioni dettagliate sulle tendenze di engagement della posta elettronica per il sistema di posta elettronica. Questi dati consentono di tenere traccia e analizzare le metriche chiave della posta elettronica, ad esempio le tariffe aperte, le tariffe click-through e le tariffe 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 di conseguenza la strategia. In generale, i log operativi di Email User Engagement offrono uno strumento efficace per migliorare le prestazioni del sistema di posta elettronica, misurare in modo proattivo e ottimizzare le campagne di posta elettronica e migliorare l'engagement degli utenti nel 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 è presente alcuna API che corrisponde 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à in cui è possibile abilitare o disabilitare i log in una determinata 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, restituito da una richiesta SendMail riuscita.
RecipientId	Indirizzo di posta elettronica per il destinatario di destinazione. Se si tratta di un evento a livello di messaggio, la proprietà sarà vuota.
EngagementType	Tipo di coinvolgimento degli utenti monitorato.
EngagementContext	Il contesto rappresenta ciò che l'utente ha interagito.
UserAgent	Stringa dell'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"
}