Configurer une destination d' CloudWatch événement pour la publication d'événements - Amazon Simple Email Service
Ajouter les détails de la destination de l' CloudWatch événementChoix des CloudWatch dimensions

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configurer une destination d' CloudWatch événement pour la publication d'événements

Avec Amazon CloudWatch Metrics, vous pouvez utiliser les destinations des événements pour publier les événements d'envoi d'e-mails vers Amazon SES CloudWatch. Comme une destination d' CloudWatch événement ne peut être configurée que dans un ensemble de configuration, vous devez d'abord créer un ensemble de configuration, puis ajouter la destination de l'événement au jeu de configuration.

Lorsque vous ajoutez une destination d' CloudWatch événement à un ensemble de configuration, vous devez choisir une ou plusieurs CloudWatch dimensions correspondant aux balises de message que vous utilisez lorsque vous envoyez vos e-mails. À l'instar des balises de message, une CloudWatch dimension est une paire nom/valeur qui vous aide à identifier une métrique de manière unique.

Par exemple, vous pouvez utiliser une balise de message et une dimension appelée campaign pour identifier votre campagne d'e-mailing. Lorsque vous publiez vos événements d'envoi d'e-mails sur CloudWatch, il est important de choisir les balises et les dimensions de vos messages, car ces choix ont une incidence sur votre CloudWatch facturation et déterminent la manière dont vous pouvez filtrer les données de vos événements d'envoi d'e-mails CloudWatch.

Cette section fournit des informations pour vous aider à choisir vos dimensions, puis montre comment ajouter une destination d' CloudWatch événement à un ensemble de configuration.

Ajout d'une destination d'événement CloudWatch

La procédure décrite dans cette section explique comment ajouter les détails de la destination d'un CloudWatch événement à un ensemble de configuration et suppose que vous avez effectué les étapes 1 à 6 dansCréation d'une destination d'événement.

Vous pouvez également utiliser l'opération UpdateConfigurationSetEventDestination dans l'API Amazon SES V2 pour créer et modifier les destinations des événements.

Pour ajouter les détails de la destination de l' CloudWatch événement à un ensemble de configuration à l'aide de la console

  1. Voici les instructions détaillées pour sélectionner le type CloudWatch de destination de votre événement à l'étape 7 et en supposant que vous avez effectué toutes les étapes précédentesCréation d'une destination d'événement. Après avoir sélectionné le type de CloudWatch destination, saisi un nom de destination et activé la publication d'événements, le volet des CloudWatch dimensions Amazon s'affiche. Ses champs sont traités dans les étapes suivantes. (Des frais supplémentaires s'appliquent, voir Prix par métrique pour CloudWatch.)

  2. Pour Value Source, spécifiez comment Amazon SES obtiendra les données auxquelles elles seront transmises CloudWatch. Les sources de valeur suivantes sont disponibles :

    • Message Tag (Balise de message) – Amazon SES extrait le nom et la valeur de la dimension d'une balise que vous spécifiez à l'aide de l'en-tête X-SES-MESSAGE-TAGS ou du paramètre d'API EmailTags. Pour en savoir plus sur l'utilisation des balises de message, consultez la page Étape 3 : Spécifier votre jeu de configuration lorsque vous envoyez un e-mail.

      Note

      Les balises de messages peuvent inclure les chiffres de 0 à 9, les lettres A-Z (majuscules et minuscules), des tirets (-) et des traits de soulignement (_).

      Vous pouvez également utiliser la source de valeur Message Tag (Balise de message) pour créer des dimensions en fonction des balises automatiques pour Amazon SES. Pour utiliser une balise automatique, tapez le nom de cette balise automatique en tant que Dimension Name (Nom de la dimension). Par exemple, pour créer une dimension basée sur la balise automatique de jeu de configurations, utilisez ses:configuration-set pour Dimension Name (Nom de la dimension), et le nom du jeu de configurations pour Default Value (Valeur par défaut). Pour obtenir la liste complète des balises automatiques, consultez Comment fonctionne la publication d'événements avec les ensembles de configuration et les balises de message.

    • Email Header (En-tête d'e-mail) – Amazon SES extrait le nom et la valeur de la dimension d'un en-tête dans l'e-mail.

      Note

      Vous ne pouvez pas utiliser les en-têtes d'e-mail suivants comme Dimension Name (Nom de dimension) : Received, To, From, DKIM-Signature, CC, message-id ou Return-Path.

    • Link Tag (Balise de lien) – Amazon SES extrait le nom et la valeur de la dimension d'une balise que vous avez spécifiée dans un lien. Pour en savoir plus sur l'ajout des balises, consultez Puis-je baliser les liens avec des identificateurs uniques ?.

  3. Dans Nom de la dimension, tapez le nom de la dimension à laquelle vous souhaitez passer CloudWatch.

    Note

    Les noms de dimension peuvent uniquement contenir des lettres ASCII (a à z, A à Z), des chiffres (0 à 9), des traits de soulignement (_) ou des tirets (-). Les espaces, les caractères accentués, les caractères non latins et les autres caractères spéciaux ne sont pas autorisés.

  4. Dans Default Value (Valeur par défaut), saisissez la valeur de la dimension.

    Note

    Les valeurs de dimension ne peuvent contenir que des lettres ASCII (a à z, A à Z), des chiffres (0 à 9), des traits de soulignement (_), des tirets (-), des signes (@) et des points (.). Les espaces, les caractères accentués, les caractères non latins et les autres caractères spéciaux ne sont pas autorisés.

  5. Pour ajouter d'autres dimensions, sélectionnez Add Dimension (Ajouter une dimension). Sinon, choisissez Next (Suivant).

  6. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez Add destination (Ajouter une destination).

Choix des CloudWatch dimensions

Lorsque vous choisissez des noms et des valeurs à utiliser comme CloudWatch dimensions, tenez compte des facteurs suivants :

  • Prix par métrique — Vous pouvez consulter les statistiques de base d'Amazon SES CloudWatch gratuitement. Toutefois, lorsque vous collectez des statistiques à l'aide de la publication d'événements, vous encourez des coûts de surveillance CloudWatch détaillée. Chaque combinaison unique de type d'événement, de nom de dimension et de valeur de dimension crée une métrique différente dans CloudWatch. Lorsque vous utilisez CloudWatch la surveillance détaillée, vous êtes facturé pour chaque métrique. Pour cette raison, vous pouvez décider de ne pas choisir de dimensions qui peuvent prendre de nombreuses valeurs différentes. Par exemple, à moins que vous soyez très intéressé par le suivi de vos événements d'envoi d'e-mails par domaine d'expédition, vous pouvez décider de ne pas définir de dimension pour la balise automatique ses:from-domain Amazon SES, car elle peut prendre de nombreuses valeurs différentes. Pour plus d’informations, consultez Tarification d’CloudWatch.

  • Filtrage des métriques : si une métrique possède plusieurs dimensions, vous ne pouvez pas accéder à la métrique en CloudWatch fonction de chaque dimension séparément. Pour cette raison, réfléchissez bien avant d'ajouter plusieurs dimensions à une même destination d' CloudWatch événement. Par exemple, si vous souhaitez des métriques par campaign et par combinaison de campaign et genre, vous devez ajouter deux destinations d'événement : l'une avec uniquement campaign comme dimension, et l'autre avec campaign et genre comme dimensions.

  • Source des valeurs de dimension – Au lieu de spécifier vos valeurs de dimension en utilisant des en-têtes propres à Amazon SES ou un paramètre destiné à l'API, vous pouvez également choisir de laisser Amazon SES prendre les valeurs de dimension de vos propres en-têtes de message MIME. Vous pouvez opter pour cette solution si vous utilisez déjà des en-têtes personnalisés et que vous ne voulez pas modifier vos e-mails ou vos appels à l'API d'envoi d'e-mails de façon à collecter les métriques en fonction de vos valeurs d'en-tête. Si vous utilisez vos propres en-têtes de message MIME pour la publication d'événements Amazon SES, les noms et les valeurs d'en-tête que vous utilisez pour la publication d'événements Amazon SES peuvent uniquement inclure les lettres A à Z, les nombres 0 à 9, les traits de soulignement (_), les arobas (@), les traits d'union (-) et les points (.). Si vous spécifiez un nom ou une valeur contenant d'autres caractères, l'appel d'envoi d'e-mail réussira toujours, mais les statistiques de l'événement ne seront pas envoyées à Amazon CloudWatch.

Pour plus d'informations sur CloudWatch les concepts, consultez Amazon CloudWatch Concepts dans le guide de CloudWatch l'utilisateur Amazon.