Monitorización de SES eventos con Amazon EventBridge

EventBridge es un servicio sin servidor que utiliza eventos para conectar los componentes de la aplicación, lo que facilita la creación de aplicaciones escalables basadas en eventos. La arquitectura basada en eventos es un estilo de creación de sistemas de software de acoplamiento flexible que funcionan juntos emitiendo eventos y respondiendo a ellos. Los eventos son mensajes JSON con formato que, por lo general, representan un cambio en un recurso o entorno u otro evento de administración.

Algunas SES funciones generarán y enviarán los eventos que usted defina al crear un destino de eventos al bus de eventos EventBridge predeterminado. Un bus de eventos es un enrutador que recibe eventos y los envía a cero o más destinos u objetivos. Las reglas que se asocian al bus de eventos evalúan los eventos a medida que llegan. Cada regla comprueba si un evento coincide con el patrón de la regla. Si el evento coincide, EventBridge envía el evento a los destinos especificados.

SESenvía eventos EventBridge cuando una función cambia de estado o actualiza su estado. Puede usar EventBridge reglas para dirigir los eventos a los objetivos definidos. Estos eventos se entregarán según el mejor esfuerzo y pueden entregarse sin ordenar.

SESeventos

Las SES funciones generan los siguientes eventos y los envían al bus de eventos predeterminado en EventBridge. Para obtener más información, incluidos los datos detallados de cada tipo de evento, consulteSESreferencia del esquema de eventos.

SESreferencia del esquema de eventos

Todos los eventos de los AWS servicios tienen un conjunto común de campos que contienen metadatos sobre el evento, como el AWS servicio que es el origen del evento, la hora en que se generó el evento, la cuenta y la región en las que tuvo lugar el evento, etc. Para ver las definiciones de estos campos generales, consulte la referencia a la estructura de eventos en la Guía del EventBridge usuario.

Además, cada evento tiene un campo detail que contiene datos específicos de ese evento en particular. La siguiente referencia define los campos de detalle de los distintos SES eventos.

Al EventBridge utilizarlos para seleccionar y gestionar SES eventos, es útil tener en cuenta lo siguiente:

Esquema de estado de asesor del Administrador virtual de entrega

La siguiente referencia de esquema define los campos específicos de los eventos de estado de asesor de Virtual Deliverability Manager.

Las definiciones de los campos generales que aparecen en todos los esquemas de eventos (comoversion, idaccount, y otros) se encuentran en la referencia a la estructura de eventos de la Guía del EventBridge usuario. Los detail-type campos source y se incluyen en la referencia siguiente porque contienen valores SES específicos para SES los eventos.

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

SESesquema de estado de envío de correo electrónico

La siguiente referencia de esquema define los campos específicos de los eventos de estado del envío de SES correos electrónicos.

Las definiciones de los campos generales que aparecen en todos los esquemas de eventos (comoversion, idaccount, y otros) se encuentran en la referencia a la estructura de eventos de la Guía del EventBridge usuario. Los detail-type campos source y se incluyen en la referencia siguiente porque contienen valores SES específicos para SES los eventos.

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

EventBridge Utilización con SES eventos

De forma predeterminada, SES envía los eventos al bus de eventos EventBridge predeterminado. Puede crear reglas en el bus de eventos predeterminado para identificar eventos específicos y enviarlos EventBridge a uno o más destinos específicos. Cada regla contiene un patrón de eventos que se EventBridge utiliza para hacer coincidir los eventos a medida que llegan al bus de eventos. Si un evento coincide con el patrón de eventos de una regla determinada, EventBridge envía el evento al destino especificado en la regla.

En EventBridge, definir un patrón de eventos suele formar parte de un proceso más amplio de crear una nueva regla o editar una existente. Para obtener información sobre cómo crear EventBridge reglas, consulta Cómo crear EventBridge reglas de Amazon que reaccionen a los eventos en la Guía del EventBridge usuario.

Al utilizar la función Sandbox EventBridge, puedes definir rápidamente un patrón de eventos y usar un evento de muestra para confirmar que el patrón coincide con los eventos deseados, sin tener que crear o editar primero una regla. Para obtener instrucciones detalladas sobre el uso del Sandbox, consulte Probar un patrón de eventos con el EventBridge Sandbox en la Guía del EventBridge usuario.

Especifique un SES ejemplo de evento en el entorno aislado EventBridge

Puede seleccionar eventos de muestra para SES los eventos y usarlos para probar los patrones de eventos que cree.

Crear y probar patrones de SES eventos para eventos

Una vez que haya seleccionado un evento de muestra, como se explicó en la sección anterior, puede crear un patrón de eventos y usar el evento de muestra para asegurarse de que coincide con los eventos que desee.

EventBridge Recursos adicionales

Consulta los siguientes temas de la Guía del EventBridge usuario de Amazon para obtener más información sobre EventBridge cómo procesar y gestionar eventos.