Récupération des données d'événements Amazon SES depuis CloudWatch

Amazon SES peut publier des statistiques relatives à vos événements d'envoi d'e-mails à Amazon CloudWatch. Lorsque vous publiez des données d'événements sur CloudWatch, il fournit ces mesures sous la forme d'un ensemble ordonné de données de séries chronologiques. Vous pouvez utiliser ces métriques pour surveiller les performances de votre envoi d'e-mails. Par exemple, vous pouvez surveiller la métrique de réclamation et définir une CloudWatch alarme pour qu'elle se déclenche lorsque la métrique dépasse une certaine valeur.

Amazon SES peut publier ces événements à deux niveaux de granularité pour CloudWatch :

• Dans votre ensemble Compte AWS — Ces indicateurs grossiers, qui correspondent aux indicateurs que vous surveillez à l'aide de la console Amazon SES et de l'GetSendStatisticsAPI, sont des totaux pour l'ensemble Compte AWS de votre entreprise. Amazon SES publie ces statistiques CloudWatch automatiquement.

• Fine-grained (Détaillées) – Ces métriques sont classées par caractéristiques d'e-mail que vous définissez à l'aide des balises de message. Pour publier ces métriques sur CloudWatch, vous devez configurer la publication d'événements avec une destination d' CloudWatch événement et spécifier un ensemble de configuration lorsque vous envoyez un e-mail. Vous pouvez également spécifier des balises de message ou utiliser des balises automatiques qu'Amazon SES fournit automatiquement.

Cette section décrit les mesures disponibles et explique comment les afficher dans CloudWatch.

Métriques disponibles

Vous pouvez publier les statistiques d'envoi d'e-mails Amazon SES suivantes sur CloudWatch :

• Send (Envoi) – La demande d'envoi a réussi et Amazon SES tente de remettre le message au serveur de messagerie du destinataire. (Si une suppression globale ou au niveau du compte est utilisée, SES la comptera toujours comme un envoi, mais la livraison sera supprimée).

• RenderingFailure— L'e-mail n'a pas été envoyé en raison d'un problème de rendu du modèle. Ce type d'événement peut se produire lorsqu'il manque des données du modèle ou lorsqu'il n'y a pas concordance entre les paramètres du modèle et les données. Ce type d'événement ne se produit que lorsque vous envoyez un e-mail à l'aide des opérations d'API SendTemplatedEmail ou SendBulkTemplatedEmail.

• Reject (Rejet) – Amazon SES a accepté l'e-mail, a déterminé qu'il contenait un virus et l'a rejeté. Amazon SES n'a pas tenté de remettre l'e-mail au serveur de messagerie du destinataire.

• Delivery (Livraison) – Amazon SES a bien remis l'e-mail au serveur de messagerie du destinataire.

• Bounce – Message d'erreur définitif indiquant que le serveur de messagerie du destinataire a définitivement rejeté l'e-mail. (Les soft bounces ne sont inclus que lorsque SES n'essaie plus de livrer l'e-mail. En général, ces rebonds souples indiquent un échec de livraison, bien que dans certains cas, un rebond souple puisse être renvoyé même lorsque le courrier parvient avec succès dans la boîte de réception du destinataire. Cela se produit généralement lorsque le destinataire envoie une réponse out-of-office automatique. Pour en savoir plus sur les soft bounces, consultez cet article de AWS Re:Post.)

• Complaint (Réclamation) – L'e-mail a été correctement remis au serveur de messagerie du destinataire, mais le destinataire l'a marqué comme courrier indésirable.

• DeliveryDelay— L'e-mail n'a pas pu être remis au serveur de messagerie du destinataire en raison d'un problème temporaire. Des retards de livraison peuvent se produire, par exemple lorsque la boîte de réception du destinataire est pleine ou lorsque le serveur de messagerie de réception rencontre un problème transitoire.

• Subscription (Abonnement) – L'e-mail a été envoyé avec succès, mais le destinataire a mis à jour les préférences d'abonnement en cliquant sur List-Unsubscribe dans l'en-tête de l'e-mail ou le lien Unsubscribe dans le pied-de-page.

• Open (Ouverture) – Le destinataire a reçu le message et l'a ouvert dans son client de messagerie.

• Click (Clic) – Le destinataire a cliqué sur un ou plusieurs liens contenus dans l'e-mail.

Dimensions disponibles

CloudWatch utilise les noms de dimension que vous spécifiez lorsque vous ajoutez une destination d' CloudWatch événement à un ensemble de configuration dans Amazon SES. Pour plus d’informations, consultez Configurer une destination d' CloudWatch événement pour la publication d'événements.

Afficher les métriques Amazon SES dans la CloudWatch console

La procédure suivante explique comment consulter les métriques de publication de vos événements Amazon SES à l'aide de la CloudWatch console.

Pour afficher les métriques à l'aide de la CloudWatch console

1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Si nécessaire, changez la région. Dans la barre de navigation, sélectionnez la région dans laquelle se trouvent vos AWS ressources. Pour plus d’informations, consultez Régions et points de terminaison.

3. Dans le volet de navigation, sélectionnez ‎Toutes les métriques.

4. Dans le volet Métriques, sélectionnez SES.

5. Sélectionnez la métrique que vous voulez afficher. Pour consulter des statistiques détaillées relatives à la publication d'événements, choisissez la combinaison de dimensions que vous avez spécifiée lors de la configuration de la destination de votre CloudWatch événement. Pour en savoir plus sur l'affichage des métriques avec CloudWatch, consultez Utiliser CloudWatch les métriques Amazon.

Pour consulter les statistiques à l'aide du AWS CLI

• À partir d'une invite de commande, utilisez la commande suivante :

  aws cloudwatch list-metrics --namespace "AWS/SES"