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. # Surveillance des événements SES à l'aide d'Amazon EventBridge EventBridge est un service sans serveur qui utilise des événements pour connecter les composants de l'application entre eux, ce qui vous permet de créer plus facilement des applications évolutives pilotées par des événements. L'architecture axée sur les événements est un style de création de systèmes logiciels à couplage faible qui fonctionnent ensemble en émettant des événements et en y répondant. Les événements sont des messages au format JSON qui représentent généralement une modification d'une ressource ou d'un environnement, ou un autre événement de gestion. Certaines fonctionnalités de SES génèrent et envoient les événements que vous définissez lors de la création d'une destination d'événement au bus d'événements EventBridge par défaut. Un bus d'événements est un routeur qui reçoit des événements et les transmet à zéro ou plusieurs destinations, ou *cibles*. Les règles que vous associez au bus d'événements évaluent les événements au fur et à mesure qu'ils arrivent. Chaque règle vérifie si un événement correspond au modèle de la règle. Si l'événement correspond, EventBridge envoie l'événement aux cibles spécifiées. SES envoie des événements en EventBridge cas de changement d'état ou de mise à jour de statut d'une fonctionnalité. Vous pouvez utiliser des EventBridge règles pour acheminer les événements vers les cibles que vous avez définies. Ces événements seront transmis dans la mesure du possible, et il se peut qu'ils ne soient pas transmis dans l'ordre. **Topics** + [ ## Événements SES ](#supported-events) + [ ## Référence du schéma des événements SES ](#eventbridge-events) + [ ## Utilisation EventBridge avec des événements SES ](#eventbridge-enable-event-notifications) + [ ## EventBridge Ressources supplémentaires ](#eventbridge-additonal-resources) ## Événements SES Les événements suivants sont générés par les fonctionnalités de SES et envoyés au bus d'événements par défaut dans EventBridge. Pour plus d'informations, y compris les données détaillées pour chaque type d'événement, consultez[Référence du schéma des événements SES](#eventbridge-events). **Événements destinés aux conseillers de Virtual Deliverability Manager** | Type d’événement | Description | | --- | --- | | Statut de recommandation du conseiller ouvert | Un événement généré chaque fois qu'une nouvelle recommandation est ouverte dans le conseiller du gestionnaire de délivrabilité virtuel. | | Statut de recommandation du conseiller résolu | Un événement généré chaque fois qu'une recommandation est résolue dans le conseiller du gestionnaire de délivrabilité virtuel. | **Événements d'envoi d'e-mails SES** | Type d’événement | Description | | --- | --- | | E-mail renvoyé | Un *hard bounce indiquant* que le serveur de messagerie du destinataire a définitivement rejeté l'e-mail. Les *messages d'erreur temporaires* sont inclus uniquement quand SES ne parvient pas à remettre l'e-mail après plusieurs tentatives au cours d'une période donnée. | | E-mail cliqué | Le destinataire a cliqué sur un ou plusieurs liens contenus dans l'e-mail. | | Réception d'une plainte par e-mail | L'e-mail a bien été envoyé au serveur de messagerie du destinataire, mais celui-ci l'a marqué comme spam. | | Livraison d'e-mail | SES a correctement envoyé l'e-mail au serveur de messagerie du destinataire. | | Livraison du courrier électronique retardée | 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. | | Courrier électronique ouvert | Le destinataire a reçu le message et l'a ouvert dans son client de messagerie. | | E-mail refusé | SES a accepté l'e-mail, mais a déterminé qu'il contenait un virus et n'a pas tenté de le transmettre au serveur de messagerie du destinataire. | | Échec du rendu de l'e-mail | 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 [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) ou [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html). | | Courrier électronique envoyé | La demande d'envoi a réussi et SES essaiera de transmettre 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). | | Adresse e-mail souscrite | L'e-mail a été envoyé avec succès, mais le destinataire a mis à jour les préférences d'abonnement en cliquant `List-Unsubscribe` dans l'en-tête de l'e-mail ou sur le `Unsubscribe` lien dans le pied de page. | ## Référence du schéma des événements SES Tous les événements issus AWS des services ont un ensemble commun de champs contenant des métadonnées relatives à l'événement, telles que le AWS service à l'origine de l'événement, l'heure à laquelle l'événement a été généré, le compte et la région dans lesquels l'événement a eu lieu, etc. Pour les définitions de ces champs généraux, voir la [référence relative à la structure des événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) dans le *guide de EventBridge l'utilisateur*. En outre, chaque événement possède un champ `detail` qui contient des données spécifiques à cet événement en particulier. La référence ci-dessous définit les champs détaillés des différents événements SES. Lorsque vous EventBridge les utilisez pour sélectionner et gérer des événements SES, il est utile de garder à l'esprit les points suivants : + Le champ `source` pour tous les événements de SES est défini sur `aws.ses`. + Le champ `detail-type` indique le type d'événement. Consultez le tableau des types d'événements dans[Événements SES](#supported-events). + Le champ `detail` contient les données spécifiques à cet événement en particulier. Pour certains types d'événements, tels que ceux de Virtual Deliverability Manager, le champ de détail est une chaîne de données plutôt simpliste remplie à partir d'un ensemble fini de valeurs statiques. À l'inverse, le champ de détail des événements d'envoi d'e-mails est plus complexe car il peut être composé de nombreux sous-champs de détail combinant des valeurs statiques et dynamiques telles que l'horodatage de l'envoi d'un e-mail, l'adresse du destinataire et de nombreux autres attributs du courrier électronique. **Topics** + [ ### Schéma de statut du conseiller du gestionnaire de délivrabilité virtuel ](#schema-resource-status-event-vdm) + [ ### Schéma d'état d'envoi d'e-mails SES ](#schema-resource-status-event-email-sending) ### Schéma de statut du conseiller du gestionnaire de délivrabilité virtuel La référence de schéma suivante définit les champs spécifiques aux événements relatifs au statut des conseillers de Virtual Deliverability Manager. Les définitions des champs généraux qui apparaissent dans tous les schémas d'événements (tels que`version`,, `id``account`, et autres) se trouvent dans la section [Référence de la structure des événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) dans le *guide de l'EventBridge utilisateur*. Les champs `source` et `detail-type` sont inclus dans la référence ci-dessous, car ils contiennent des valeurs spécifiques à SES pour les événements SES. `source` Identifie le service qui a généré l'événement. Pour les événements SES, cette valeur est `aws.ses`. `detail-type` Identifie le type d'événement. Les valeurs de ce champ sont répertoriées dans le tableau des *événements du conseiller Virtual Deliverability Manager* dans[Événements SES](#supported-events). `detail` Un objet JSON qui contient des informations sur l'événement. Le service qui génère l'événement détermine le contenu de ce champ. Les valeurs de ce champ peuvent être les suivantes : + `DKIM verification is not enabled.` + `DKIM verification has failed.` + `DKIM signing key length is below 2048 bits.` + `DMARC configuration was not found.` + `DMARC configuration could not be parsed.` + `DKIM record was not found.` + `DKIM record is not aligned.` + `MAIL FROM record is not aligned.` + `SPF record was not found.` + `SPF record for Amazon SES was not found.` + `SPF all qualifier is missing.` + `An SPF configuration issue was found.` + `BIMI record not found or configured without default selector.` + `BIMI has malformed TXT record.` **Example Exemple : événement de statut du conseiller du gestionnaire de délivrabilité virtuel** Voici un exemple d'événement de statut du conseiller du gestionnaire de délivrabilité virtuel pour ce type d'événement `Advisor Recommendation Status Open`. La valeur de l'événement détaillé dans cet exemple est`SPF record was not found.`. ``` { "version": "0", "id": "abcd9999-ef33-0123-90ab-abcdef666666", "detail-type": "Advisor Recommendation Status Open", "source": "aws.ses", "account": "012345678901", "time": "2023-11-15T17:00:59Z", "region": "us-east-1", "resources": [ "arn:aws:ses:us-east-1:012345678901:identity/vdm.events-publishing.cajun.syster-games.example.com" ], "detail": { "version": "1.0.0", "data": "SPF record was not found." } } ``` ### Schéma d'état d'envoi d'e-mails SES La référence de schéma suivante définit les champs spécifiques aux événements de statut d'envoi d'e-mails SES. Les définitions des champs généraux qui apparaissent dans tous les schémas d'événements (tels que`version`,, `id``account`, et autres) se trouvent dans la section [Référence de la structure des événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) dans le *guide de l'EventBridge utilisateur*. Les champs `source` et `detail-type` sont inclus dans la référence ci-dessous, car ils contiennent des valeurs spécifiques à SES pour les événements SES. `source` Identifie le service qui a généré l'événement. Pour les événements SES, cette valeur est `aws.ses`. `detail-type` Identifie le type d'événement. Les valeurs de ce champ sont répertoriées dans le tableau des *événements d'envoi d'e-mails SES* dans[Événements SES](#supported-events). `detail` Un objet JSON qui contient des informations sur l'événement. Le service qui génère l'événement détermine le contenu de ce champ. Toutes les valeurs possibles pour ce champ ne peuvent pas être répertoriées ici car elles sont composées de valeurs statiques et dynamiques générées par chaque e-mail unique envoyé à un moment donné. Cependant, un exemple est fourni pour vous donner une idée du type de données que ce champ peut contenir. *Des exemples de données détaillées pour tous les types d'événements d'envoi d'e-mails peuvent être trouvés à l'aide de la EventBridge Sandbox, voir[Spécifiez un exemple d'événement dans EventBridge](#event-pattern-sandbox-sample).* Voici un exemple de données détaillées générées pour l'événement d'envoi d'e-mails de SES `Email Rendering Failed` : ``` ..., "detail": { "eventType": "Rendering Failure", "mail": { "timestamp": "2018-01-22T18:43:06.197Z", "source": "sender@example.com", "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", "sendingAccountId": "123456789012", "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination": ["recipient@example.com"], "headersTruncated": false, "tags": { "ses:configuration-set": ["ConfigSet"] } }, "failure": { "errorMessage": "Attribute 'attributeName' is not present in the rendering data.", "templateName": "MyTemplate" } } ``` **Example Exemple : événement relatif au statut d'envoi d'un e-mail** Voici un exemple de l'événement complet relatif au statut d'envoi d'un e-mail pour le type d'événement`Email Rendering Failed`. Dans cet exemple, la valeur détaillée de l'événement est une combinaison de valeurs statiques et dynamiques basée sur l'événement d'envoi d'un e-mail spécifique. ``` { "version": "0", "id": "12a18625-3328-fafd-2809-a5e16004f112", "detail-type": "Email Rendering Failed", "source": "aws.ses", "account": "123456789012", "time": "2023-07-17T16:48:05Z", "region": "us-east-1", "resources": ["arn:aws:ses:us-east-1:123456789012:identity/example.com"], "detail": { "eventType": "Rendering Failure", "mail": { "timestamp": "2018-01-22T18:43:06.197Z", "source": "sender@example.com", "sourceArn": "arn:aws:ses:us-east-1:123456789012:identity/sender@example.com", "sendingAccountId": "123456789012", "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination": ["recipient@example.com"], "headersTruncated": false, "tags": { "ses:configuration-set": ["ConfigSet"] } }, "failure": { "errorMessage": "Attribute 'attributeName' is not present in the rendering data.", "templateName": "MyTemplate" } } } ``` ## Utilisation EventBridge avec des événements SES Par défaut, SES envoie les événements au bus d'événements EventBridge par défaut. Vous pouvez créer des règles sur le bus d'événements par défaut afin d'identifier des événements spécifiques EventBridge à envoyer à une ou plusieurs cibles spécifiées. Chaque règle contient un *modèle d'événement* qui permet EventBridge de faire correspondre les événements lorsqu'ils arrivent sur le bus d'événements. Si un événement correspond au modèle d'événement d'une règle donnée, EventBridge envoie l'événement à la cible spécifiée dans la règle. Dans EventBridge, la définition d'un modèle d'événement fait généralement partie du processus plus large de création d'une nouvelle règle ou de modification d'une règle existante. Pour savoir comment créer des EventBridge règles, consultez la section [Création de EventBridge règles Amazon qui réagissent aux événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) dans le *Guide de EventBridge l'utilisateur*. À l'aide de la fonctionnalité Sandbox EventBridge, vous pouvez définir rapidement un modèle d'événement et utiliser un exemple d'événement pour confirmer que le modèle correspond aux événements souhaités, sans avoir à créer ou à modifier une règle au préalable. Pour obtenir des instructions détaillées sur l'utilisation du Sandbox, voir [Tester un modèle d'événement à l'aide du EventBridge Sandbox dans le](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-pattern-sandbox.html) Guide de l'*EventBridge utilisateur*. ### Spécifiez un exemple d'événement SES dans le EventBridge Sandbox Vous pouvez sélectionner des exemples d'événements pour les événements SES, afin de les utiliser pour tester les modèles d'événement que vous créez. **Pour spécifier un exemple d'événement SES dans le EventBridge Sandbox** 1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Dans le volet de navigation, choisissez **Ressources pour développeurs,** puis sélectionnez **Environnement de test (sandbox)**, et sur la page **Environnement de test (sandbox)**, choisissez l'onglet **Modèle d'événement**. 1. Dans **Source de l'événement**, choisissez **AWS des événements ou des événements EventBridge partenaires**. 1. Dans la section **Exemple d'événement**, pour **Exemple de type d'événement**, sélectionnez **Événements AWS **. 1. Pour les **exemples d'événement**, faites défiler la page jusqu'à **SES**, puis sélectionnez l'événement SES souhaité. EventBridge affiche un exemple d'événement, ainsi que toutes ses données détaillées, pour le type d'événement. Vous pouvez ensuite utiliser cet événement pour tester le modèle d'événement que vous créez dans la section **Modèle d'événement**, ou l'utiliser comme base pour créer vos propres exemples d'événements pour les tests de modèles décrits dans la section suivante. ### Création et test de modèles d'événement pour les événements SES Une fois que vous avez sélectionné un exemple d'événement, comme expliqué dans la section précédente, vous pouvez créer un modèle d'événement et utiliser l'exemple d'événement pour vous assurer qu'il correspond aux événements souhaités. **Pour créer et tester un modèle d'événement correspondant aux événements SES dans le EventBridge Sandbox** 1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Dans le volet de navigation, choisissez **Ressources pour développeurs,** puis sélectionnez **Environnement de test (sandbox)**, et sur la page **Environnement de test (sandbox)**, choisissez l'onglet **Modèle d'événement**. 1. Dans **Source de l'événement**, choisissez **AWS des événements ou des événements EventBridge partenaires**, puis sélectionnez l'exemple d'événement que vous souhaitez tester, comme expliqué dans la section précédente. 1. Faites défiler l'écran jusqu'à **Méthode de création**, puis choisissez **Utiliser le formulaire de modèle**. 1. Dans la section **Modèle d'événement**, pour **Source d'événement**, choisissez **Services AWS **. 1. Dans **AWS Service**, sélectionnez **SES**. 1. Pour **Type d'événement**, sélectionnez le type d'événement SES à associer. EventBridge affiche le modèle d'événement minimal, composé de `source` et de `detail-type` champs, qui correspond à l'événement SES sélectionné. Dans les deux exemples, le premier schéma d'événements correspond à tous les `Advisor Recommendation Status Resolved` événements, et dans le second, à tous les `Email Bounced` événements : ``` { "source": ["aws.ses"], "detail-type": ["Advisor Recommendation Status Resolved"] } ``` ``` { "source": ["aws.ses"], "detail-type": ["Email Bounced"] } ``` 1. Pour modifier le modèle d'événement, sélectionnez **Modifier le modèle** et apportez vos modifications dans l'éditeur JSON. Vous pouvez également faire correspondre les valeurs d'un ou de plusieurs champs de données détaillés. Cela inclut la spécification de plusieurs valeurs possibles pour une valeur de champ. Dans l'exemple suivant, le champ détaillé a été ajouté au modèle d'événement minimal généré avec la valeur du `data` champ spécifiée `DKIM record was not found` afin de trouver tous les événements du conseiller Virtual Deliverability Manager ayant la même valeur de détail : ``` { "source": ["aws.ses"], "detail-type": ["Advisor Recommendation Status Resolved"], "detail": { "data": ["DKIM record was not found."] } } ``` Dans cet exemple, des sous-champs détaillés ont été ajoutés pour signaler les événements générés par tous les e-mails envoyés par *noreply@example.com* le *05/08/2021 qui ont été renvoyés*. (La correspondance des préfixes est utilisée ici dans le cadre du [filtrage du contenu](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html). ) : ``` { "source": ["aws.ses"], "detail-type": ["Email Bounced"], "detail": { "mail": { "timestamp": [{ "prefix": "2024-08-05" }], "source": ["noreply@example.com"] } } } ``` Il est important de lire les [modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) dans le *guide de EventBridge l'utilisateur*, qui explique que la valeur du modèle d'événement que vous entrez dans l'éditeur JSON doit être entourée de crochets `[...]` car elle est considérée comme un tableau. Ces informations, ainsi que d'autres informations sur la manière de créer des modèles d'événements avancés, sont également fournies. 1. Pour vérifier si votre modèle d'événement correspond à l'exemple d'événement que vous avez spécifié dans le volet **Exemple d'événement** ci-dessus, sélectionnez **Tester le modèle**. S'il correspond, une bannière verte en bas de l'éditeur JSON affichera *: « Exemple d'événement correspondant au modèle d'événement »*. 1. Pour résoudre les erreurs après avoir sélectionné le **modèle de test** : + S'il existe des erreurs liées au JSON, le message en indiquera la raison, par exemple *: « Le modèle d'événement n'est pas valide. Raison : « data » doit être un objet ou un tableau à la ligne : 5, à la colonne : 14"*. Pour remédier à ce problème, placez la valeur de la ligne 5 entre crochets`[...]`. + En cas de divergence entre les valeurs de l'*événement Sample* et celles de votre *modèle d'événement*, le message sera le suivant *: « L'événement de l'échantillon ne correspond pas au modèle d'événement ».* Cela signifie qu'une ou plusieurs valeurs que vous souhaitez tester sont différentes des valeurs d'exemple générées par le générateur *d'événements Sample*. Pour y remédier, passez aux étapes restantes. 1. Pour modifier les valeurs d'échantillon dans l'*événement Sample* afin de tester avec succès votre *modèle d'événement*, dans le volet **Exemple d'événement**, sélectionnez **Copier** sous l'éditeur JSON. 1. Sélectionnez le bouton radio à côté de **Enter my own** pour le **type d'événement Sample** au-dessus de l'éditeur. 1. Collez l'exemple d'événement dans l'éditeur JSON, et pour tout champ que vous utilisez dans votre modèle d'événement, remplacez la valeur de ce même champ pour qu'elle corresponde à la valeur que vous avez spécifiée dans votre modèle d'événement. 1. Revenez au volet Modèle d'événement et sélectionnez à nouveau **Modèle de test**. Si toutes les valeurs ont été saisies correctement et correspondent, une bannière verte en bas de l'éditeur JSON s'affichera, intitulée *« Exemple d'événement correspondant au modèle d'événement »*. ## EventBridge Ressources supplémentaires Consultez les rubriques suivantes du [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) pour plus d'informations sur le traitement et la gestion des événements. EventBridge + Pour obtenir des informations détaillées sur le fonctionnement des bus d'événements, consultez [Amazon EventBridge Event Bus](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html). + Pour plus d'informations sur la structure des événements, consultez [Événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) (français non garanti) + Pour plus d'informations sur la création de modèles d'événements EventBridge à utiliser lors de la mise en correspondance d'événements par rapport à des règles, voir [Modèles d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) + Pour plus d'informations sur la création de règles pour spécifier quels événements EventBridge sont traités, voir [Règles](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) + Pour plus d'informations sur la manière de spécifier les services ou autres destinations EventBridge auxquels les événements correspondants sont envoyés, voir [Cibles](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)