Einrichten eines CloudWatch-Ereignisziels für die Ereignisveröffentlichung - Amazon Simple Email Service

Einrichten eines CloudWatch-Ereignisziels für die Ereignisveröffentlichung

Mit Amazon-CloudWatch-Metriken können Sie Ereignisziele verwenden, um E-Mail-Sendeereignisse von Amazon SES in CloudWatch zu veröffentlichen. Da ein CloudWatch-Ereignisziel nur in einem Konfigurationssatz vorhanden ist, müssen Sie zuerst einen Konfigurationssatz erstellen und ihm anschließend das Ereignisziel hinzufügen.

Wenn Sie einem Konfigurationssatz ein CloudWatch-Ereignisziel hinzufügen, müssen Sie mindestens eine CloudWatch-Dimensionen auswählen, die den Nachrichten-Tags entspricht, die Sie beim Senden Ihrer E-Mails verwenden. Wie Nachrichten-Tags ist auch eine CloudWatch-Dimension ein Name-Wert-Paar, mit dem Sie eine Metrik eindeutig identifizieren können.

Sie können beispielsweise ein Nachrichten-Tag und eine Dimension mit dem Namen campaign verwenden, um Ihre E-Mail-Kampagne zu identifizieren. Wenn Sie Ihre E-Mail-Sendeereignisse in CloudWatch veröffentlichen, ist es wichtig, dass Sie Ihre Nachrichten-Tags und Dimensionen auswählen. Diese Auswahl hat Auswirkungen auf die CloudWatch-Fakturierung und bestimmt, wie die Ereignisdaten Ihres E-Mail-Versands in CloudWatch gefiltert werden.

Die Informationen in diesem Abschnitt sollen Sie beim Auswählen Ihrer Dimensionen unterstützen. Danach wird außerdem gezeigt, wie Sie einem Konfigurationssatz ein CloudWatch-Ereignisziel hinzufügen.

Hinzufügen eines CloudWatch Ereignisziels

Das Verfahren in diesem Abschnitt veranschaulicht, wie die Details zum CloudWatch-Ereignisziel einem Konfigurationssatz hinzugefügt werden, und setzt voraus, dass Sie die Schritte 1 bis 6 unter Erstellen eines Ereignisziels abgeschlossen haben.

Sie können auch den UpdateConfigurationSetEventDestination-Vorgang in der Amazon SES API V2 von verwenden, um Ereignisziele zu erstellen und zu ändern.

So fügen Sie einem Konfigurationssatz mithilfe der Konsole ein CloudWatch-Ereignisziel hinzu
  1. Dies sind die detaillierten Anweisungen zur Auswahl von CloudWatch als Ereigniszieltyp in Schritt 7. Es wird vorausgesetzt, dass Sie alle vorherigen Schritte in Erstellen eines Ereignisziels abgeschlossen haben. Nachdem Sie Destination type (Zieltyp) für CloudWatch ausgewählt und Event publishing (Ereignisveröffentlichung) aktiviert haben, wird der Bereich Amazon CloudWatch dimensions (Dimensionen von Amazon CloudWatch) angezeigt. Die einzelnen Felder werden in den folgenden Schritten behandelt.

  2. Geben Sie für Value Source (Wertquelle) an, wie Amazon SES die Daten erhält, die es an CloudWatch weiterleitet. Die folgenden Quellen für Werte sind verfügbar:

    • Message Tag (Nachrichten-Tag) – Amazon SES ruft den Dimensionsnamen und Wert aus einem Tag ab, der von Ihnen mittels eines X-SES-MESSAGE-TAGS-Headers oder eines Parameters für die Tags-API angegeben wurde. Weitere Informationen zur Verwendung von Nachrichten-Tags finden Sie unter Schritt 3: Festlegen eines Konfigurationssatzes für das Senden von E-Mail.

      Anmerkung

      Nachrichten-Tags können die Zahlen 0-9, die Buchstaben A-Z (Groß- und Kleinbuchstaben), Bindestriche (-) und Unterstriche (_) enthalten.

      Sie können auch mithilfe der Wertquelle Message Tag (Nachrichten-Tag) Dimensionen basierend auf automatischen Amazon SES-Tags erstellen. Sie können einen automatischen Tag verwenden, indem Sie unter Dimension Name (Dimensionsname) den vollständigen Namen des automatischen Tag eingeben. Um z. B. eine Dimension basierend auf dem automatischen Tag des Konfigurationssatzes zu erstellen, verwenden Sie ses:configuration-set für den Dimension Name (Dimensionsname) und den Namen des Konfigurationssatzes für Default Value (Standardwert). Eine vollständige Liste automatischer Tags finden Sie unter Funktionsweise der -Ereignisveröffentlichung.

    • Email Header (E-Mail-Überschrift) – Amazon SES ruft den Dimensionsnamen und Wert aus einem Header in der E-Mail ab.

      Anmerkung

      Die folgenden E-Mail-Header dürfen nicht als Dimension Name (Dimensionsname) verwendet werden: Received, To, From, DKIM-Signature, CC, message-id oder Return-Path.

    • Link Tag (Link-Tag) – Amazon SES ruft den Dimensionsnamen und den Wert aus einem Tag ab, der von Ihnen in einem Link angegeben wurde. Weitere Informationen zum Hinzufügen von Tags zu Links finden Sie unter Kann ich Links mit eindeutigen Bezeichnern markieren?.

  3. Geben Sie unter Dimension Name (Dimensionsname) den Namen der Dimension ein, die Sie an CloudWatch übergeben möchten.

    Anmerkung

    Dimensionsnamen dürfen nur ASCII-Buchstaben (a-z, A-Z), Zahlen (0-9), Unterstriche (_) und Bindestriche (-) enthalten. Leerzeichen, Akzentbuchstaben, nicht-lateinische Zeichen und andere Sonderzeichen sind nicht zulässig.

  4. Geben Sie unter Default Value (Standartwert) den Wert der Dimension ein.

    Anmerkung

    Dimensionswerte dürfen nur ASCII-Buchstaben (a-z, A-Z), Ziffern (0-9), Unterstriche (_), Bindestriche (-), bei Zeichen (@) und Punkte (.) enthalten. Leerzeichen, Akzentbuchstaben, nicht-lateinische Zeichen und andere Sonderzeichen sind nicht zulässig.

  5. Wenn Sie weitere Dimensionen hinzufügen möchten, wählen Sie Add Dimension (Dimension hinzufügen) aus. Klicken Sie andernfalls auf Next (Weiter).

  6. Wenn Sie auf dem Review-Bildschirm mit der Definition Ihres Veranstaltungsziels zufrieden sind, wählen Sie Add destination (Ziel hinzufügen) aus.

Auswählen von CloudWatch Dimensionen

Berücksichtigen Sie bei der Auswahl von Namen und Werten zur Verwendung als CloudWatch-Dimensionen die folgenden Faktoren:

  • Price per metric (Preis pro Metric) – Sie können in CloudWatch grundlegende Amazon SES-Metriken kostenlos anzeigen. Wenn Sie Metriken jedoch mittels Ereignisveröffentlichung sammeln, erstellen Sie in CloudWatch benutzerdefinierte Metriken. Jede eindeutige Kombination aus Ereignistyp, Dimensionsname und Dimensionswert erstellt in CloudWatch eine andere benutzerdefinierte Metrik. Wenn Sie CloudWatch verwenden, wird Ihnen jede von Ihnen erstellte benutzerdefinierte Metrik berechnet. Aus diesem Grund sollten Sie vermeiden, Dimensionen auszuwählen, die viele verschiedene Werte haben können. Sie sollten z. B. keine Dimension für das automatische Amazon SES-Tag ses:from-domain definieren, da es viele verschiedene Werte annehmen kann, es sei denn, Sie sind sehr daran interessiert, Ihre E-Mail-Sendeereignisse nach "From" (Von)-Domäne zu verfolgen. Weitere Informationen hierzu finden Sie unter Amazon CloudWatch – Preise.

  • Metric filtering (Metrikfilterung) – Wenn eine Metrik über mehrere Dimensionen verfügt, können Sie nicht auf der Grundlage einzelner Dimensionen auf die Metrik in CloudWatch zugreifen. Aus diesem Grund sollten Sie sorgfältig überlegen, bevor Sie einem einzelnen CloudWatch-Ereignisziel mehr als eine Dimension hinzufügen. Wenn Sie z. B. Metriken je campaign und je Kombination aus campaign und genre möchten, müssen Sie zwei Ereignisziele hinzufügen: eins, das nur campaign als Dimension hat, und eins, das sowohl über campaign als auch genre als Dimensionen verfügt.

  • Dimension value source (Dimensionswertquelle) – Sie können Dimensionswerte nicht nur mithilfe Amazon SES-spezifischer Header oder eines Parameters für die API angeben. Alternativ können Sie auch mit Amazon SES Dimensionswerte aus Ihren eigenen MIME-Nachrichten-Headern abrufen. Verwenden Sie diese Option, wenn Sie bereits benutzerdefinierte Header nutzen und Sie Ihre E-Mails oder Ihre Aufrufe an die E-Mail sendende API nicht ändern möchten, um Metriken auf der Grundlage ihrer Header-Werte zu erfassen. Wenn Sie eigene MIME-Nachrichten-Header für Amazon SES-Ereignisveröffentlichungen verwenden, dürfen die Header-Namen und Werte, die Sie für die Amazon SES-Ereignisveröffentlichung verwenden, nur die Buchstaben A bis Z, die Ziffern 0 bis 9, Unterstriche (_), at-Zeichen (@), Bindestriche (-) und Punkte (.) enthalten. Wenn Sie einen Namen oder Wert mit anderen Zeichen angeben, wird der Aufruf zum Senden von E-Mails weiterhin erfolgreich ausgeführt, die Ereignismetriken werden jedoch nicht an Amazon CloudWatch gesendet.

Weitere Informationen zu CloudWatch finden Sie unter Amazon CloudWatch-Konzepte im Benutzerhandbuch zu Amazon CloudWatch.