AWSSupport-AnalyzeSESMessageSendingStatus - AWS Systems Manager オートメーションランブックリファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWSSupport-AnalyzeSESMessageSendingStatus

説明

AWSSupport-AnalyzeSESMessageSendingStatus 自動化ランブックは、未配信の E メールメッセージの E メール配信ステータスを要約し、未配信の理由を解決するためのアドバイスを提供します。ランブックは、Amazon によって公開された Amazon CloudWatch Logs グループに保存されている Amazon Simple Email Service (Amazon SES) E メール送信イベントを取得しますSES。Amazon SESイベント発行の詳細については、「Amazon Simple Email Service イベント発行 を使用したモニタリング」を参照してください。ランブックには、E メール配信の概要とタイムライン、および未配信の E メールメッセージに影響を与える可能性のあるレコメンデーションも記載されています。これらのメッセージは、各実行の出力セクションにあります。このランブックは、イベントストアのデプロイ後にのみイベントのトラブルシューティングを行うことができることに注意してください。

動作の仕組み

ランブックは、次の手順を実行します。

  • 同じ CloudWatch Logs グループの同時オートメーション実行をチェックします。

  • オートメーションパラメータによってIDs指定されたメッセージに対応する Amazon SESイベントを分析します。

  • 自動化実行の出力セクションに配信の概要を出力します。

重要

  • このランブックを実行する前に、公開された Amazon SESイベントをオートメーションパラメータで指定された CloudWatch Logs ロググループに保存する必要があります。このランブックは、ロググループに保存されている Amazon SESイベントのみを分析します。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

Automation

[所有者]

Amazon

[Platforms] (プラットフォーム)

Linux、macOS, Windows

パラメータ

必要なIAMアクセス許可

AutomationAssumeRole パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。

  • logs:StartQuery

  • logs:GetQueryResults

  • ses:GetIdentityMailFromDomainAttributes

  • ses:GetSendQuota

  • ssm:DescribeAutomationExecutions

  • ssm:GetAutomationExecution

Instructions

次の手順に従って自動化を設定します。

  1. ドキュメントの Systems Manager AWSSupport-AnalyzeSESMessageSendingStatusで に移動します。

  2. [Execute automation] (オートメーションを実行) を選択します。

  3. 入力パラメータには、以下を入力します。

    • AutomationAssumeRole （オプション):

      Systems Manager Automation がユーザーに代わってアクションを実行できるようにする () ロールARNの Amazon リソースネーム AWS AWS Identity and Access Management （IAM）。ロールが指定されていない場合、Systems Manager Automation は、このランブックを開始するユーザーのアクセス許可を使用します。

    • MessageIds （必須）

      分析する Amazon Simple Email Service イベントの IDs Amazon Simple Email Service メッセージをカンマで区切ります。

    • CloudWatchLogsGroup （オプション）

      Amazon Simple Email Service イベントを保存する Amazon CloudWatch Logs グループ。デフォルトのロググループ名は `/ses/sending_event_logs` です。デフォルトのロググループとは異なるロググループを使用する場合は、このフィールドにロググループ名を入力してください。「」。

    • QueryStartTime （オプション）

      イベント分析の時間範囲の開始時刻。有効な時刻形式は ISO8601 (例: `yyyy-MM-dd THH:mm:ss`、1970-01-01T00:00:00`) です。デフォルトの日時は 30 日前です。

    • QueryEndTime （オプション）

      イベントアナルヤシスの時間範囲の終了時刻。有効な時刻形式は ISO8601 (例: `yyyy-MM-dd THH:mm:ss`、1970-01-01T00:00:00`) です。デフォルトの日時は現在の時刻です。

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

  4. [実行] を選択します。

  5. 自動化が開始されます。

  6. ドキュメントは以下のステップを実行します。

    • CheckConcurrency:

      Amazon CloudWatch Logs グループをターゲットとするこのランブックの実行が 1 つだけであることを確認します。ランブックが同じロググループをターゲットとする別の実行を見つけた場合、エラーが返されて終了します。

    • AnalyzeSesEvents:

      オートメーションパラメータで指定された Amazon CloudWatch Logs グループに保存されている Amazon Simple Email Service イベントを分析します。

    • OutputFailureReason:

      ステップが失敗したときに、実行AnalyzeSESMessageSendingStatusステップの失敗メッセージを出力します。

  7. 完了したら、Outputs セクションで実行の詳細な結果を確認します。

    • バウンスによる未配信 E メールメッセージの分析の出力

      バウンスが原因で送信先メールボックスに到達しなかった E メールメッセージの自動実行の出力。

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

リファレンス

Systems Manager Automation