AWSSupport-AnalyzeSESMessageSendingStatus - AWS Systems Manager Referenz zum Automatisierungs-Runbook

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

Beschreibung

Das Runbook zur AWSSupport-AnalyzeSESMessageSendingStatus Automatisierung fasst den Status der E-Mail-Zustellung nicht zugestellter E-Mail-Nachrichten zusammen und gibt Ihnen Tipps, wie Sie herausfinden können, warum sie nicht zugestellt wurden. Das Runbook ruft E-Mail-Sendeereignisse von Amazon Simple Email Service (AmazonSES) ab, die in einer von Amazon veröffentlichten Amazon CloudWatch Logs-Gruppe gespeichert sind. SES Einzelheiten zur Veröffentlichung von SES Amazon-Veranstaltungen finden Sie unter Überwachung mithilfe der Veröffentlichung von Ereignissen mit Amazon Simple Email Service. 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 Event-Speichers beheben kann.

Wie funktioniert es?

Das Runbook führt die folgenden Schritte aus:

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

  • Analysieren Sie SES Amazon-Ereignisse, die der durch den Automatisierungsparameter IDs übermittelten Nachricht entsprechen.

  • Geben Sie die Lieferzusammenfassungen im Ausgabebereich der Automatisierungsausführung aus.

Wichtig

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

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

Linux, macOS, 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

Gehen Sie wie folgt vor, um die Automatisierung zu konfigurieren:

  1. Navigieren Sie AWSSupport-AnalyzeSESMessageSendingStatusim 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 Rolle AWS AWS Identity and Access Management (IAM), der 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-Nachricht IDs von den Amazon Simple Email Service-Ereignissen, die Sie analysieren möchten.

    • CloudWatchLogsGroup (Fakultativ)

      Die Amazon CloudWatch Logs-Gruppe, in der Amazon Simple Email Service-Ereignisse gespeichert werden. Der Standardname der Protokollgruppe lautet `/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 ISO86 01 (z. B. `YYYY-MM-DD:MM:SS`, THH `1970-01-01T 00:00:00 `). Das Standarddatum ist vor 30 Tagen.

    • QueryEndTime (Fakultativ)

      Die Endzeit des Zeitbereichs für die Ereignisanalyse. Das gültige Zeitformat ist ISO86 01 (z. B. `YYYY-MM-DD:MM:SS`, THH `1970-01-01T 00:00:00 `). Die Standardzeit für Datum und Uhrzeit ist die aktuelle Uhrzeit.

    Input parameters form for AWS Systems Manager Automation with fields for role, message IDs, logs, and time range.

  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 es nur eine Ausführung dieses Runbooks gibt, die 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 bei einem Ausführungsschritt aus, wenn der AnalyzeSESMessageSendingStatus Schritt fehlgeschlagen ist.

  7. Wenn Sie den Vorgang abgeschlossen haben, 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 Bounces nicht erreicht hat.

    Email delivery error message showing a permanent bounce due to unknown user, with timeline and recommendations.

Referenzen

Systems Manager Automation