EventBridge で配信されていないイベントを処理するためのデッドレターキューの使用

ターゲットへの配信に失敗した後でイベントが失われるのを避けるために、デッドレターキュー (DLQ) を設定し、失敗したすべてのイベントをそこに送って後で処理することができます。

qEventBridge DLQ は、ターゲットに正常に配信できなかったイベントを保存するために EventBridge が使用する標準的な Amazon SQS キューです。DLQ を使用するかどうかは、ルールを作成してターゲットを追加するときに選択できます。DLQ を設定すると、正常に配信されなかったイベントを保持できます。そのため、失敗したイベント配信の原因となった問題を解決し、後でイベントを処理できるようになります。

ルールのターゲットに DLQ を設定すると、EventBridge は呼び出しに失敗したイベントを、選択した Amazon SQS キューに送信します。

イベントエラーには、さまざまな処理方法があります。一部のイベントは、再試行せずに削除されるか、DLQ に送信されます。例えば、ターゲットに対するアクセス許可が欠落したことに起因するエラーの場合、または存在しなくなったターゲットリソースの場合、根本的な問題を解決するためのアクションが実行されるまで再試行は行われません。 EventBridge は、指定されている場合、これらのイベントをターゲット DLQ に直接送信します。

イベント配信が失敗すると、EventBridge はターゲット invocation が失敗したことを示す Amazon CloudWatch メトリックスにイベントをパブリッシュします。DLQ を使用している場合、InvocationsSentToDLQ および InvocationsFailedToBeSentToDLQ を含めて追加のメトリクスが CloudWatch に送信されます。

を使用して保管中のイベントを暗号化する場合は、イベントバス AWS KMS カスタマーマネージドキー の DLQs を指定することもできます。詳細については、「EventBridge で暗号化されたイベントエラーをキャプチャするためのデッドレターキューの使用」を参照してください。

DLQ の各メッセージには、次のカスタム属性が含まれます。

次のビデオでは、DLQ の設定について説明します。

デッドレターキューを使用する際の考慮事項

EventBridge に DLQ を設定する場合は、以下の点を考慮してください。

デッドレターキューへのアクセス許可の付与

イベントをキューに正常に配信するには、そのためのアクセス許可が Eventbridge に必要です。EventBridge コンソールを使用して DLQ を指定すると、アクセス許可が自動的に追加されます。これには、以下が含まれます。

API を使用してルールを作成する場合、または別の AWS アカウントにあるキューを使用する場合、必要なアクセス許可を付与するリソースベースのポリシーを手動で作成し、それをキューにアタッチする必要があります。

ターゲットデッドレターキューのアクセス許可の例

以下のリソースベースのポリシーは、EventBridge が Amazon SQS キューにイベントメッセージを送信する際に必要なアクセス許可を付与する方法を示しています。このポリシーの例では、「MyEventDLQ」という名前のキューにメッセージを送信するために、SendMessage オペレーションを使用するアクセス許可を EventBridge サービスに付与しています。キューは、 AWS アカウント 123456789012 の us-west-2 リージョンにある必要があります。Condition ステートメントは、 AWS アカウント 123456789012 の us-west-2 リージョンで作成されたMyTestRule」という名前のルールからのリクエストのみを許可します。

{
  "Sid": "Dead-letter queue permissions",
  "Effect": "Allow",
  "Principal": {
     "Service": "events.amazonaws.com"
  },
  "Action": "sqs:SendMessage",
  "Resource": "arn:aws:sqs:us-west-2:123456789012:MyEventDLQ",
  "Condition": {
    "ArnEquals": {
      "aws:SourceArn": "arn:aws:events:us-west-2:123456789012:rule/MyTestRule"
    }
  }
}

イベントバスのデッドレターキューのアクセス許可の例

次のリソースベースのポリシーは、イベントバスの DLQ を指定するときに必要なアクセス許可を付与する方法を示しています。この場合、aws:SourceArn は DLQ にイベントを送信するイベントバスの ARN を指定します。この例では、キューはイベントバスと同じリージョンにある必要があります。

{
  "Sid": "Dead-letter queue permissions",
  "Effect": "Allow",
  "Principal": {
     "Service": "events.amazonaws.com"
  },
  "Action": "sqs:SendMessage",
  "Resource": "arn:aws:sqs:region:account-id:queue-name",
  "Condition": {
    "ArnEquals": {
      "aws:SourceArn": "arn:aws:events:region:account-id:event-bus/event-bus-arn"
    }
  }
}

ポリシーをキューにアタッチするには、Amazon SQS コンソールを使用してキューを開き、[Access policy] (アクセスポリシー) を選択してポリシーを編集します。また、 AWS CLIを使用することもできます 詳細については、「Amazon SQS のアクセス許可」を参照してください。

デッドレターキューからイベントを再送信する方法

メッセージを DLQ から移動するには、次の 2 つの方法があります。