INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

テーマ別の解説テーマ:イベント駆動処理の設計

Amazon EventBridgeとは?ルールの一致と配信失敗の調べ方

EventBridgeのイベントバスは、届いた出来事をルールに照らし、条件に合うイベントを指定先へ送ります。 画像の受付と変換依頼を例に、バスに届く、ルールに合う、宛先へ届く、処理が終わるという四つの段階を追います。

この教材で学ぶこと

架空のイベントとルールを読み、配信されない理由を照合・ターゲット配信・受信後の処理に切り分け、どの記録を次に調べるか説明できる。

先に知っておくこと

イベントは起きた出来事を表すデータです。SQSのキューが受信側のために仕事をためることを知っておくと、バスとキューの役割を比較できます。対象はデフォルトバスとルールを使うClassicバスです。設定変更やAWSへの接続を行わない固定例で学びます。

バスは条件に合う出来事を宛先へ振り分ける

受付サービスは出来事を発行します。バスは到着したイベントを受け取り、ルールはイベントパターンで照合し、ターゲットは一致したイベントを受け取ります。一つの出来事が複数のルールに合う構成もあります。

架空の画像受付:どこまで進んだかを順に確かめる
架空の画像受付:どこまで進んだかを順に確かめる1: 受付サービス — イベントを送る — イベントバス. 2: イベントバス — 受信したデータを照合 — 変換依頼ルール. 3: 変換依頼ルール — 一致した場合に配信 — 変換依頼キュー123受付サービスイベントバス変換依頼ルール変換依頼キュー架空の画像受付:どこまで進んだかを順に確かめる1: 受付サービス — イベントを送る — イベントバス. 2: イベントバス — 受信したデータを照合 — 変換依頼ルール. 3: 変換依頼ルール — 一致した場合に配信 — 変換依頼キュー123受付サービスイベントバス変換依頼ルール変換依頼キュー
  1. 受付サービス → イベントバスイベントを送る
  2. イベントバス → 変換依頼ルール受信したデータを照合
  3. 変換依頼ルール → 変換依頼キュー一致した場合に配信
受付サービス
受付のイベントを発行する
イベントバス
イベントを受け取る
変換依頼ルール
送信元と種別を照合する
変換依頼キュー
ターゲットとして依頼を受け取る

送信元と種別を組み合わせ、一致する入力を読む

変換依頼ルールの固定例
{
  "source": [
    "example.image-intake"
  ],
  "detail-type": [
    "Image accepted"
  ]
}

このパターンには二つの項目があります。実際に届いたイベントで、送信元が example.image-intake、種別が Image accepted の両方に一致するかを見ます。下のAは一致し、BとCはそれぞれ一方が異なります。

バスが3件を受け取った場合の教材用入力
入力sourcedetail-type照合結果
Aexample.image-intakeImage accepted一致。指定先への配信へ進む。
Bexample.image-intakeImage rejected種別が異なり、このルールには一致しない。
Cexample.batch-importImage accepted送信元が異なり、このルールには一致しない。

件数だけを見て、ルールを広げる判断はできません。受付の記録とバス側で観測できる記録を照合し、イベントの実際の値、正しいバス、ルールで想定した種別を確かめます。意図しないBやCも通す変更は、後段の処理を増やします。

一致後に失敗したら、ターゲット配信と処理を分ける

ルールに一致しても、ターゲットの受け入れに失敗する場合があります。EventBridgeは再試行可能な配信エラーに対して、ターゲットの再試行方針に沿って再試行します。権限などに起因する失敗を、回数を増やすだけで解消できると判断しないでください。

ターゲットに設定するEventBridgeのDLQは、ターゲットへ配信できなかったイベントを調べるための受け皿です。SQSの送信元キューに設定するDLQは、メッセージを受信後に処理側が完了できない場合などに受信回数を基に隔離します。どちらもSQSキューを使えますが、どの段階で誰が送ったかを見て切り分けます。

例Aで変換済み画像が見当たらないときに確認する証拠
判明した範囲次に照合すること判断
バスへの到着までsourceとdetail-type、ルールの条件照合の前提と結果を確認する。
ルール一致後の配信失敗対象ターゲット、権限や宛先、配信失敗記録や設定済みのDLQ原因を確認してから回復方法を選ぶ。
キューの受け入れまで受信側が同じ依頼を処理した記録、結果の保存、重複EventBridgeの配信と画像変換の完了を分ける。

三つの段階から次に調べる場所を選ぶ

選択すると、正誤と理由が表示されます。

固定パターンに一致するのはどの入力ですか?
答えと理由を読む

正解:Aのみ · 送信元と種別が両方一致するのはAです。

Bがバスに届き、変換依頼キューに届きませんでした。このルールで先に確認することは?
答えと理由を読む

正解:届いた種別とルールの期待値を比べる · この固定例ではターゲット配信に進む前に照合で外れます。

Aはルールに一致しましたが、権限の問題でキューに届けられませんでした。次に見るのは?
答えと理由を読む

正解:ターゲットの宛先・権限と配信失敗の記録 · ターゲットの宛先と権限がこの失敗の調査対象です。

Aをキューが受け入れたことまで確認できました。変換完了を判断する証拠は?
答えと理由を読む

正解:受信側の処理記録と保存結果 · 受信側の処理記録と保存された画像を、同じ依頼に対応づけます。

確認して、自分の言葉で説明する

  1. 届いたイベントの送信元と種別を、ルールの期待値と照合する。
  2. 一致後の配信失敗をターゲットの宛先と権限から調べる。
  3. キューが受け取った後は、同じ依頼の処理記録と業務結果を確認する。
理解を確かめる: 変換依頼キューへの配信が成功したのに、画像が見つかりません。最初に調べる先はどこですか?

受信側の処理記録と出力先です。

バスからキューへの配信はすでに確認しています。変換開始、失敗、保存先を同じ依頼で追います。

出典と確認した条件

説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。