デッドレターキュー

デッドレターキュー (DLQ) とは

デッドレターキュー (DLQ) は、処理に失敗したメッセージを退避させ、後から調査・再処理するためのキューである。メッセージが失われるのを防ぎ、障害の原因を特定する。

DLQ の仕組み

メッセージの処理が失敗すると、SQS が自動的にリトライする。maxReceiveCount で指定した回数リトライしても成功しない場合、メッセージは DLQ に移動される。DLQ に溜まったメッセージを調査して障害原因を特定し、修正後に元のキューに戻して再処理する。

メッセージ → SQS → Lambda (処理失敗)
                → リトライ 1 回目 (失敗)
                → リトライ 2 回目 (失敗)
                → リトライ 3 回目 (失敗)
                → DLQ に移動
→ DLQ のメッセージを調査・修正・再処理

DLQ vs エラーハンドリング

DLQ とエラーハンドリングの違いを以下にまとめる。

観点	DLQ	try-catch
対象	非同期メッセージ	同期処理
リトライ	自動 (maxReceiveCount)	手動実装
調査	DLQ のメッセージを確認	ログを確認
再処理	DLQ から元のキューに戻す	再リクエスト

DLQ の再処理

DLQ の再処理の例を示す。

# DLQ のメッセージを元のキューに戻す
aws sqs start-message-move-task \
  --source-arn arn:aws:sqs:ap-northeast-1:123456789012:my-dlq \
  --destination-arn arn:aws:sqs:ap-northeast-1:123456789012:my-queue

Lambda の DLQ

Lambda の DLQ を以下にまとめる。

イベントソース	DLQ の設定場所
SQS トリガー	SQS キューの RedrivePolicy
非同期呼び出し	Lambda の DeadLetterConfig
EventBridge	ルールの DLQ

デッドレターキューの背景や設計思想は関連書籍に詳しい。