Journaux d'emails

Azure Communication Services offre des fonctionnalités de journalisation que vous pouvez utiliser pour superviser et déboguer votre solution Communication Services. Configurez ces fonctionnalités dans le Portail Azure.

Prérequis

Azure Communications Services fournit des fonctionnalités de supervision et d’analytique via la vue d’ensemble des journaux Azure Monitor et les métriques Azure Monitor. Chaque ressource Azure requiert son propre paramètre de diagnostic, qui définit les critères suivants :

• Catégories de journaux et données de métriques envoyées aux destinations définies dans le paramètre. Les catégories disponibles varient en fonction des types de ressources.
• Une ou plusieurs destinations auxquelles envoyer les journaux. Les destinations actuelles sont l’espace de travail Log Analytics, Event Hubs et le Stockage Azure.
• Un seul paramètre de diagnostic ne peut pas définir plus d’une destination. Si vous souhaitez envoyer des données à plus d’un type de destination (par exemple, deux espaces de travail Log Analytics), créez plusieurs paramètres. Chaque ressource peut avoir jusqu’à cinq paramètres de diagnostic.

Suivez les instructions suivantes pour configurer votre ressource Azure Monitor afin de commencer à créer des journaux et des métriques pour vos services de communication. Pour plus d’informations sur l’utilisation des paramètres de diagnostic sur toutes les ressources Azure, consultez : Activer la journalisation dans les paramètres de diagnostic

Catégories de journaux de ressources

Communication Services propose les types de journaux suivants que vous pouvez activer :

• Journaux d’utilisation : fournit des données d’utilisation associées à chaque offre de service facturée.
• Journaux opérationnels de la fonction Envoyer un Courrier électronique : fournit des informations détaillées sur les demandes d'envoi de courrier du service de messagerie.
• Journaux opérationnels de mise à jour du statut des e-mails : fournit des mises à jour du statut de livraison au niveau des messages et des destinataires, en lien avec les demandes d'envoi du service de messagerie.
• Journaux opérationnels de l’engagement utilisateur email : fournit des informations relatives aux métriques d'ouverture et de clics d'engagement utilisateur pour les messages envoyés depuis le service d'email.

Schéma des journaux d’utilisation

Journaux opérationnels Email Send Mail

Les journaux d’activité d’envoi de courrier électronique fournissent des insights précieux sur les tendances des demandes d’API au fil du temps. Ces données vous aident à découvrir des éléments clés de l’analytique de la messagerie, comme le nombre total d’e-mails envoyés, la taille des e-mails et le nombre d’e-mails avec des pièces jointes. Ces informations peuvent être analysées rapidement en quasi-temps réel et visualisées de façon conviviale pour faciliter la prise de décision.

Échantillons

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

Journaux opérationnels Email Status Update

Les journaux opérationnels de mise à jour de l’état de l’e-mail fournissent des informations détaillées sur les mises à jour de l’état de remise au niveau du message et du destinataire pour vos demandes d'API de sendmail.

• Les mises à jour d’état au niveau du message fournissent l’état des opérations d’envoi d’e-mail de longue durée (similaires aux mises à jour d’état que vous recevez via l’appel de nos API GET). Celles-ci sont marquées par l’absence de la propriété RecipientId, car ces mises à jour concernent l’intégralité du message et ne s’appliquent pas à un destinataire spécifique dans cette requête de message. La propriété DeliveryStatus contient l’état de remise au niveau du message. Les valeurs possibles de DeliveryStatus pour ce type d’événement sont Dropped, OutForDelivery et Queued.
• Les mises à jour d’état au niveau du destinataire fournissent l’état de la remise de l’e-mail pour chaque destinataire individuel auquel l’e-mail a été envoyé dans un seul message. Celles-ci contiennent une propriété RecipientId avec l’adresse e-mail du destinataire. L’état de la remise au niveau du destinataire est fourni dans la propriété DeliveryStatus. Les valeurs possibles de DeliveryStatus pour ce type d’événement sont Delivered, Expanded, Failed, Quarantined, FilteredSpam, Suppressed et Bounced. En effectuant le suivi de ces journaux, vous pouvez offrir une visibilité complète de votre processus de remise des e-mails, en identifiant rapidement les problèmes qui peuvent survenir et en prenant si nécessaire des mesures correctives.

Échantillons

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

Journaux opérationnels Email User Engagement

Les journaux opérationnels d’engagement des utilisateurs de messagerie fournissent des insights sur les tendances d’engagement par e-mail pour votre système de messagerie. Ces données vous permettent de faire le suivi et d’analyser des métriques de messagerie clés comme les taux d’ouverture, les taux de clics et les taux de désabonnement. Ces journaux peuvent être stockés et analysés, ce qui vous permet d’obtenir des insights plus approfondis sur les performances de votre système de messagerie et d’adapter votre stratégie en conséquence. Dans l’ensemble, les journaux opérationnels d’engagement des utilisateurs par e-mail fournissent un outil puissant permettant d’améliorer les performances de votre système de messagerie, de mesurer et d’optimiser de manière proactive vos campagnes par e-mail et d’améliorer l’engagement des utilisateurs au fil du temps.

Échantillons

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