テーマ別の解説テーマ:イベント駆動処理の設計
Amazon EventBridgeとは?ルールの一致と配信失敗の調べ方
EventBridgeのイベントバスは、届いた出来事をルールに照らし、条件に合うイベントを指定先へ送ります。 画像の受付と変換依頼を例に、バスに届く、ルールに合う、宛先へ届く、処理が終わるという四つの段階を追います。
架空のイベントとルールを読み、配信されない理由を照合・ターゲット配信・受信後の処理に切り分け、どの記録を次に調べるか説明できる。
イベントは起きた出来事を表すデータです。SQSのキューが受信側のために仕事をためることを知っておくと、バスとキューの役割を比較できます。対象はデフォルトバスとルールを使うClassicバスです。設定変更やAWSへの接続を行わない固定例で学びます。
バスは条件に合う出来事を宛先へ振り分ける
受付サービスは出来事を発行します。バスは到着したイベントを受け取り、ルールはイベントパターンで照合し、ターゲットは一致したイベントを受け取ります。一つの出来事が複数のルールに合う構成もあります。
- 受付サービス → イベントバスイベントを送る
- イベントバス → 変換依頼ルール受信したデータを照合
- 変換依頼ルール → 変換依頼キュー一致した場合に配信
- 受付サービス
- 受付のイベントを発行する
- イベントバス
- イベントを受け取る
- 変換依頼ルール
- 送信元と種別を照合する
- 変換依頼キュー
- ターゲットとして依頼を受け取る
送信元と種別を組み合わせ、一致する入力を読む
{
"source": [
"example.image-intake"
],
"detail-type": [
"Image accepted"
]
}このパターンには二つの項目があります。実際に届いたイベントで、送信元が example.image-intake、種別が Image accepted の両方に一致するかを見ます。下のAは一致し、BとCはそれぞれ一方が異なります。
| 入力 | source | detail-type | 照合結果 |
|---|---|---|---|
| A | example.image-intake | Image accepted | 一致。指定先への配信へ進む。 |
| B | example.image-intake | Image rejected | 種別が異なり、このルールには一致しない。 |
| C | example.batch-import | Image accepted | 送信元が異なり、このルールには一致しない。 |
件数だけを見て、ルールを広げる判断はできません。受付の記録とバス側で観測できる記録を照合し、イベントの実際の値、正しいバス、ルールで想定した種別を確かめます。意図しないBやCも通す変更は、後段の処理を増やします。
一致後に失敗したら、ターゲット配信と処理を分ける
ルールに一致しても、ターゲットの受け入れに失敗する場合があります。EventBridgeは再試行可能な配信エラーに対して、ターゲットの再試行方針に沿って再試行します。権限などに起因する失敗を、回数を増やすだけで解消できると判断しないでください。
ターゲットに設定するEventBridgeのDLQは、ターゲットへ配信できなかったイベントを調べるための受け皿です。SQSの送信元キューに設定するDLQは、メッセージを受信後に処理側が完了できない場合などに受信回数を基に隔離します。どちらもSQSキューを使えますが、どの段階で誰が送ったかを見て切り分けます。
| 判明した範囲 | 次に照合すること | 判断 |
|---|---|---|
| バスへの到着まで | sourceとdetail-type、ルールの条件 | 照合の前提と結果を確認する。 |
| ルール一致後の配信失敗 | 対象ターゲット、権限や宛先、配信失敗記録や設定済みのDLQ | 原因を確認してから回復方法を選ぶ。 |
| キューの受け入れまで | 受信側が同じ依頼を処理した記録、結果の保存、重複 | EventBridgeの配信と画像変換の完了を分ける。 |
三つの段階から次に調べる場所を選ぶ
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 届いたイベントの送信元と種別を、ルールの期待値と照合する。
- 一致後の配信失敗をターゲットの宛先と権限から調べる。
- キューが受け取った後は、同じ依頼の処理記録と業務結果を確認する。
理解を確かめる: 変換依頼キューへの配信が成功したのに、画像が見つかりません。最初に調べる先はどこですか?
受信側の処理記録と出力先です。
バスからキューへの配信はすでに確認しています。変換開始、失敗、保存先を同じ依頼で追います。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件デフォルトバスとClassicバスで、ルールに一致したイベントを指定のターゲットへ送る流れ。
参照した本文バスは条件に合う出来事を宛先へ振り分ける 送信元と種別を組み合わせ、一致する入力を読む 一致後に失敗したら、ターゲット配信と処理を分ける
確認した内容・条件イベントの属性と値をパターンに照合する。この記事は固定の文字列一致例を扱う。
参照した本文送信元と種別を組み合わせ、一致する入力を読む
確認した内容・条件再試行可能なターゲット配信エラーと、期間・回数の上限。
参照した本文一致後に失敗したら、ターゲット配信と処理を分ける
確認した内容・条件未配信イベントのDLQと配信失敗の情報。SQS受信側の失敗とは観測点が異なる。
参照した本文一致後に失敗したら、ターゲット配信と処理を分ける
確認した内容・条件ルールに一致したイベントを受け取る先と、ターゲットに応じた権限の境界。
確認した内容・条件処理できないメッセージの隔離、FIFOの順序への影響、標準/FIFOで異なる保持期限の起点。実データの回復は検証しない。
参照した本文一致後に失敗したら、ターゲット配信と処理を分ける