View a markdown version of this page

AWSSupport-AnalyzeSESMessageSendingStatus - AWS Systems Manager Runbook-Referenz für Automation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWSSupport-AnalyzeSESMessageSendingStatus

Description

Das AWSSupport-AnalyzeSESMessageSendingStatus Automatisierungs-Runbook fasst den E-Mail-Zustellungsstatus nicht zugestellter E-Mail-Nachrichten zusammen und gibt Ihnen Tipps, wie Sie herausfinden können, warum die Nachricht nicht zugestellt wurde. Das Runbook ruft E-Mail-Versandereignisse von Amazon Simple Email Service (Amazon SES) ab, die in einer von Amazon SES veröffentlichten Amazon Logs-Gruppe gespeichert sind. CloudWatch Einzelheiten zur Veröffentlichung von Amazon SES-Ereignissen finden Sie unter Überwachung mithilfe der Veröffentlichung von Amazon Simple Email Service-Ereignissen. Das Runbook enthält auch eine Zusammenfassung und den Zeitplan der E-Mail-Zustellungen sowie Empfehlungen, die sich möglicherweise auf nicht zugestellte E-Mail-Nachrichten auswirken können. Sie finden diese Nachrichten im Ausgabebereich jeder Ausführung. Bitte beachten Sie, dass dieses Runbook die Ereignisse erst nach der Bereitstellung des Eventspeichers beheben kann.

Wie funktioniert es?

Das Runbook führt die folgenden Schritte aus:

  • Prüft gleichzeitige Automatisierungsausführungen für dieselbe CloudWatch Protokollgruppe.

  • Analysieren Sie Amazon SES-Ereignisse, die den im Automatisierungsparameter angegebenen Nachrichten-IDs entsprechen.

  • Geben Sie Übermittlungszusammenfassungen in den Ausgabebereich der Automatisierungsausführung aus.

Wichtig

  • Bevor Sie dieses Runbook ausführen, müssen Sie veröffentlichte Amazon SES-Ereignisse in einer CloudWatch Logs-Protokollgruppe speichern, die durch den Automatisierungsparameter angegeben wird. Dieses Runbook analysiert nur Amazon SES-Ereignisse, die in der Protokollgruppe gespeichert sind.

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

LinuxmacOS, Windows

Parameter

Erforderliche IAM-Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • logs:StartQuery

  • logs:GetQueryResults

  • ses:GetIdentityMailFromDomainAttributes

  • ses:GetSendQuota

  • ssm:DescribeAutomationExecutions

  • ssm:GetAutomationExecution

Anweisungen

Folgen Sie diesen Schritten, um die Automatisierung zu konfigurieren:

  1. Navigieren Sie AWSSupport-AnalyzeSESMessageSendingStatus im Systems Manager unter Dokumente zu.

  2. Wählen Sie Execute automation (Automatisierung ausführen).

  3. Geben Sie für die Eingabeparameter Folgendes ein:

    • AutomationAssumeRole (Fakultativ):

      Der Amazon-Ressourcenname (ARN) der AWS AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen durchzuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

    • MessageIds (Erforderlich)

      Durch Kommas getrennte Amazon Simple Email Service-Nachrichten-IDs der Amazon Simple Email Service-Ereignisse, die Sie analysieren möchten.

    • CloudWatchLogsGroup (Fakultativ)

      Die Amazon CloudWatch Logs-Gruppe, die Amazon Simple Email Service-Ereignisse speichert. Der Standardname der Protokollgruppe ist `/ ses/sending_event_logs `. Wenn Sie eine andere Protokollgruppe als die Standard-Protokollgruppe verwenden möchten, geben Sie bitte Ihren Protokollgruppennamen in dieses Feld ein. „,

    • QueryStartTime (Fakultativ)

      Die Startzeit des Zeitbereichs für die Ereignisanalyse. Das gültige Zeitformat ist ISO8601 (z. B. `yyyy- MM-ddTHH:mm:ss `, `1970-01-01`). T00:00:00 Die Standardzeit für Datum und Uhrzeit ist 30 Tage her.

    • QueryEndTime (Fakultativ)

      Die Endzeit des Zeitbereichs für die Ereignisanalyse. Das gültige Zeitformat ist ISO8601 (z. B. `yyyy- MM-ddTHH:mm:ss `, `1970-01-01`). T00:00:00 Die Standardzeit für Datum und Uhrzeit ist die aktuelle Uhrzeit.

    Abschnitt „Eingabeparameter“ auf der Verwaltungskonsole, in dem Textfelder für die oben genannten fünf Parameter angezeigt werden.

  4. Wählen Sie Ausführen aus.

  5. Die Automatisierung wird initiiert.

  6. Das Dokument führt die folgenden Schritte aus:

    • CheckConcurrency:

      Stellt sicher, dass dieses Runbook nur einmal ausgeführt wird, das auf die Amazon CloudWatch Logs-Gruppe abzielt. Wenn das Runbook eine weitere Ausführung findet, die auf dieselbe Protokollgruppe abzielt, gibt es einen Fehler zurück und wird beendet.

    • AnalyzeSesEvents:

      Analysieren Sie Amazon Simple Email Service-Ereignisse, die in der durch den Automatisierungsparameter angegebenen Amazon CloudWatch Logs-Gruppe gespeichert sind.

    • OutputFailureReason:

      Gibt Fehlermeldungen über Fehler beim Ausführungsschritt aus, wenn der AnalyzeSESMessageSendingStatus Schritt fehlgeschlagen ist.

  7. Wenn Sie fertig sind, finden Sie im Abschnitt Ausgaben die detaillierten Ergebnisse der Ausführung:

    • Ergebnis der Analyse einer E-Mail-Nachricht, die aufgrund eines Bounces nicht zugestellt wurde

      Ausgabe einer automatisierten Ausführung für eine E-Mail-Nachricht, die das Zielpostfach aufgrund eines Bounce nicht erreicht hat.

    Beispiel für eine automatische Ausführung: Ausgabe einer Nachrichten-ID, die eine Bounce vom Ziel-E-Mail-Server erhalten hat.

Referenzen

Systems Manager Automation