Monitoraggio SES degli eventi tramite Amazon EventBridge

EventBridge è un servizio serverless che utilizza gli eventi per connettere tra loro i componenti dell'applicazione, semplificando la creazione di applicazioni scalabili basate sugli eventi. L'architettura basata su eventi è uno stile di creazione di sistemi software ad accoppiamento debole che interagiscono emettendo e rispondendo a eventi. Gli eventi sono messaggi in JSON formato elettronico che in genere rappresentano un cambiamento in una risorsa o in un ambiente o un altro evento di gestione.

Alcune SES funzionalità genereranno e invieranno eventi definiti durante la creazione di una destinazione di eventi sul bus eventi EventBridge predefinito. Un router di eventi è un router che riceve eventi e li invia a nessuna o a più destinazioni o target. Le regole associate al router di eventi valutano gli eventi man mano che arrivano. Ogni regola verifica se un evento corrisponde allo schema della regola. Se l'evento corrisponde, EventBridge invia l'evento ai target specificati.

SESinvia eventi a EventBridge quando una funzionalità ha un cambio di stato o un aggiornamento dello stato. È possibile utilizzare EventBridge le regole per indirizzare gli eventi verso obiettivi definiti. Questi eventi verranno recapitati sulla base del miglior tentativo e potrebbero essere recapitati non in ordine.

SESeventi

I seguenti eventi vengono generati dalle SES feature e inviati al bus eventi predefinito in EventBridge. Per ulteriori informazioni, inclusi i dati di dettaglio per ogni tipo di evento, vedereSESriferimento allo schema degli eventi.

SESriferimento allo schema degli eventi

Tutti gli eventi AWS dei servizi dispongono di un set comune di campi contenenti metadati relativi all'evento, ad esempio il AWS servizio che ne è l'origine, l'ora in cui l'evento è stato generato, l'account e la regione in cui si è verificato l'evento e altri. Per le definizioni di questi campi generali, consultate il riferimento alla struttura degli eventi nella Guida per l'EventBridge utente.

Inoltre, ogni evento ha un campo detail che contiene dati specifici per quel particolare evento. Il riferimento seguente definisce i campi di dettaglio per i vari SES eventi.

Quando si utilizza EventBridge per selezionare e gestire SES eventi, è utile tenere presente quanto segue:

Schema dello stato dell'advisor Gestore virtuale della deliverability delle email

Il seguente riferimento allo schema definisce i campi specifici degli eventi di stato del consulente di Virtual Deliverability Manager.

Le definizioni per i campi generali che compaiono in tutti gli schemi di eventi (comeversion, idaccount, e altri) sono disponibili nel riferimento alla struttura degli eventi nella Guida per l'EventBridge utente. I detail-type campi source e sono inclusi nel riferimento seguente perché contengono valori SES specifici per gli SES eventi.

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

SESschema di stato dell'invio di e-mail

Il seguente riferimento allo schema definisce i campi specifici degli eventi di stato dell'invio di SES e-mail.

Le definizioni per i campi generali che compaiono in tutti gli schemi di eventi (comeversion, idaccount, e altri) sono disponibili nel riferimento alla struttura degli eventi nella Guida per l'EventBridge utente. I detail-type campi source e sono inclusi nel riferimento seguente perché contengono valori SES specifici per gli SES eventi.

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

Utilizzo EventBridge con SES gli eventi

Per impostazione predefinita, SES invia gli eventi al bus eventi EventBridge predefinito. È possibile creare regole sul bus degli eventi predefinito per identificare eventi specifici EventBridge da inviare a una o più destinazioni specificate. Ogni regola contiene uno schema di eventi che EventBridge viene utilizzato per abbinare gli eventi man mano che arrivano sul bus degli eventi. Se un evento corrisponde allo schema di eventi per una determinata regola, EventBridge invia l'evento al target specificato nella regola.

Nel EventBridge, la definizione di un modello di evento fa in genere parte del processo più ampio di creazione di una nuova regola o di modifica di una regola esistente. Per informazioni su come creare EventBridge regole, consulta Creazione di EventBridge regole Amazon che reagiscono agli eventi nella Guida per l'EventBridge utente.

Utilizzando la funzionalità Sandbox in EventBridge, puoi definire rapidamente un pattern di eventi e utilizzare un evento di esempio per confermare che il pattern corrisponda agli eventi desiderati, senza dover prima creare o modificare una regola. Per istruzioni dettagliate sull'uso della Sandbox, consulta Testare un pattern di eventi utilizzando la EventBridge Sandbox nella Guida per l'EventBridge utente.

Specificate un evento SES di esempio nella Sandbox EventBridge

È possibile selezionare eventi di esempio per SES utilizzarli per testare i modelli di eventi creati.

Creazione e test di modelli di SES eventi per gli eventi

Dopo aver selezionato un evento di esempio, come spiegato nella sezione precedente, puoi creare un modello di evento e utilizzare l'evento di esempio per assicurarti che corrisponda agli eventi desiderati.

Risorse aggiuntive EventBridge

Consulta i seguenti argomenti nella Amazon EventBridge User Guide per ulteriori informazioni su come utilizzare EventBridge per elaborare e gestire gli eventi.