Überwachung von SES-Ereignissen mit Amazon EventBridge

EventBridge ist ein serverloser Dienst, der Ereignisse verwendet, um Anwendungskomponenten miteinander zu verbinden, sodass Sie leichter skalierbare, ereignisgesteuerte Anwendungen erstellen können. Bei der ereignisgesteuerten Architektur werden lose gekoppelte Softwaresysteme entwickelt, die zusammenarbeiten, indem sie Ereignisse senden und darauf reagieren. Bei Ereignissen handelt es sich um Nachrichten im JSON-Format, die in der Regel eine Änderung einer Ressource oder Umgebung oder ein anderes Verwaltungsereignis darstellen.

Bestimmte SES-Funktionen generieren Ereignisse, die Sie bei der Erstellung eines Ereignisziels definieren, und senden sie an den EventBridge Standard-Event-Bus. Ein Event Bus ist ein Router, der Ereignisse empfängt und sie an null oder mehr Ziele weiterleitet. Regeln, die Sie dem Event Bus zuordnen, werten die eintreffenden Ereignisse aus. Bei jeder Regel wird geprüft, ob ein Ereignis dem Muster der Regel entspricht. Wenn das Ereignis übereinstimmt, wird das Ereignis an die angegebenen Ziele EventBridge gesendet.

SES sendet Ereignisse, EventBridge wenn ein Feature einen Statuswechsel oder eine Statusaktualisierung erfährt. Sie können EventBridge Regeln verwenden, um Ereignisse an Ihre definierten Ziele weiterzuleiten. Diese Ereignisse werden auf Grundlage einer optimalen Leistung übermittelt und können in falscher Reihenfolge geliefert werden.

SES-Ereignisse

Die folgenden Ereignisse werden von SES-Funktionen generiert und an den standardmäßigen Event-Bus-Eingang gesendet EventBridge. Weitere Informationen, einschließlich detaillierter Daten für jeden Ereignistyp, finden Sie unterReferenz zu SES-Ereignisschemas.

Referenz zu SES-Ereignisschemas

Alle Ereignisse von AWS Diensten haben einen gemeinsamen Satz von Feldern, die Metadaten über das Ereignis enthalten, z. B. den AWS Dienst, der die Quelle des Ereignisses ist, den Zeitpunkt, zu dem das Ereignis generiert wurde, das Konto und die Region, in der das Ereignis stattgefunden hat, und andere. Definitionen dieser allgemeinen Felder finden Sie unter Referenz zur Ereignisstruktur im EventBridge Benutzerhandbuch.

Darüber hinaus weist jedes Ereignis ein detail-Feld auf, das spezifische Daten für das betreffende Ereignis enthält. In der folgenden Referenz werden die Detailfelder für die verschiedenen SES-Ereignisse definiert.

Bei der EventBridge Auswahl und Verwaltung von SES-Ereignissen ist es hilfreich, Folgendes zu beachten:

Schema des Status des Virtual-Deliverability-Manager-Beraters

Die folgende Schemareferenz definiert die Felder, die spezifisch für Virtual Deliverability Manager Advisor-Statusereignisse sind.

Definitionen für die allgemeinen Felder, die in allen Ereignisschemas vorkommen (wieversion, idaccount, und andere), finden Sie in der Referenz zur Ereignisstruktur im EventBridge Benutzerhandbuch. Die Felder source und detail-type sind in der folgenden Referenz enthalten, da sie SES-spezifische Werte für SES-Ereignisse enthalten.

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

Statusschema für den SES-E-Mail-Versand

Die folgende Schemareferenz definiert die Felder, die für SES-E-Mail-Versandstatusereignisse spezifisch sind.

Definitionen für die allgemeinen Felder, die in allen Ereignisschemas vorkommen (wieversion, idaccount, und andere), finden Sie in der Referenz zur Ereignisstruktur im EventBridge Benutzerhandbuch. Die Felder source und detail-type sind in der folgenden Referenz enthalten, da sie SES-spezifische Werte für SES-Ereignisse enthalten.

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

Verwendung EventBridge mit SES-Ereignissen

Standardmäßig sendet SES Ereignisse an den EventBridge Standard-Event-Bus. Sie können Regeln für den Standard-Event-Bus erstellen, um bestimmte Ereignisse zu identifizieren EventBridge , die an ein oder mehrere angegebene Ziele gesendet werden sollen. Jede Regel enthält ein Ereignismuster, das EventBridge verwendet wird, um Ereignisse zuzuordnen, sobald sie auf dem Event-Bus ankommen. Wenn ein Ereignis dem Ereignismuster für eine bestimmte Regel entspricht, wird das Ereignis an das in der Regel angegebene Ziel EventBridge gesendet.

In EventBridge ist die Definition eines Ereignismusters in der Regel Teil des umfassenderen Prozesses der Erstellung einer neuen Regel oder der Bearbeitung einer vorhandenen Regel. Informationen zum Erstellen von EventBridge Regeln finden Sie im EventBridge Benutzerhandbuch unter Erstellen von EventBridge Amazon-Regeln, die auf Ereignisse reagieren.

Mithilfe der Sandbox-Funktion unter können Sie schnell ein Ereignismuster definieren und anhand eines Beispielereignisses überprüfen, ob das Muster mit den gewünschten Ereignissen übereinstimmt, ohne zuerst eine Regel erstellen oder bearbeiten zu müssen. EventBridge Ausführliche Anweisungen zur Verwendung der Sandbox finden Sie im Benutzerhandbuch unter Testen eines Ereignismusters mithilfe der EventBridge Sandbox. EventBridge

Geben Sie ein SES-Beispielereignis in der Sandbox an EventBridge

Sie können Beispielereignisse für SES-Ereignisse auswählen, um damit die erstellten Ereignismuster zu testen.

Erstellen und Testen von Ereignismustern für SES-Ereignisse

Nachdem Sie, wie im vorherigen Abschnitt erklärt, ein Beispielereignis ausgewählt haben, können Sie ein Ereignismuster erstellen und anhand des Beispielereignisses sicherstellen, dass es den gewünschten Ereignissen entspricht.

Zusätzliche EventBridge Ressourcen

Weitere Informationen zur Verarbeitung und Verwaltung von Ereignissen finden Sie EventBridge in den folgenden Themen im EventBridge Amazon-Benutzerhandbuch.