Surveillance des SES événements à 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. Une architecture pilotée par les événements est un style de création de systèmes logiciels faiblement couplés qui fonctionnent ensemble en émettant des événements et en y répondant. Les événements sont des messages JSON formatés qui représentent généralement une modification d'une ressource ou d'un environnement, ou un autre événement de gestion.

Certaines SES fonctionnalités 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.

SESenvoie 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.

SESévénements

Les événements suivants sont générés par les SES fonctionnalités 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, consultezSESréférence de schéma d'événements.

SESréférence de schéma d'événements

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 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 de détail des différents SES événements.

Lorsque vous l'utilisez EventBridge pour sélectionner et gérer SES des événements, il est utile de garder à l'esprit les points suivants :

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 queversion,, idaccount, et autres) se trouvent dans la section Référence de la structure des événements dans le guide de l'EventBridge utilisateur. Les detail-type champs source et sont inclus dans la référence ci-dessous car ils contiennent des valeurs SES spécifiques aux SES événements.

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

SESschéma d'état d'envoi d'e-mails

La référence de schéma suivante définit les champs spécifiques aux événements de statut d'envoi d'SESe-mails.

Les définitions des champs généraux qui apparaissent dans tous les schémas d'événements (tels queversion,, idaccount, et autres) se trouvent dans la section Référence de la structure des événements dans le guide de l'EventBridge utilisateur. Les detail-type champs source et sont inclus dans la référence ci-dessous car ils contiennent des valeurs SES spécifiques aux SES événements.

{
  "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 SES événements

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 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 Guide de l'EventBridge utilisateur.

Spécifiez un SES exemple d'événement dans le EventBridge Sandbox

Vous pouvez sélectionner des exemples d'SESévénements afin de les utiliser pour tester les modèles d'événements que vous créez.

Création et test de modèles d'événements pour les SES événements

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.

EventBridge Ressources supplémentaires

Consultez les rubriques suivantes du guide de l' EventBridge utilisateur Amazon pour plus d'informations sur le traitement et la gestion des événements. EventBridge