コンテンツにスキップ

デッドレターキュー

デッドレターキュー(DLQ)は、メッセージングシステムにおける一般的な概念であり、max_retriesに達した後に消費者との配信失敗が発生した場合にメッセージが送信される場所を表します。デッドレターキューは他のキューと同様であり、独立して生成および消費することができます。

Cloudflare Queuesでは、デッドレターキューは消費者設定内で定義されます。メッセージは、消費者のために設定されたリトライ制限に達したときにDLQに配信されます。DLQが設定されていない場合、リトライ制限に達したメッセージは永久に削除されます。

例えば、以下の消費者設定では、配信をリトライした後(デフォルトでは3回)、メッセージを"my-other-queue"という名前のDLQに送信します:

[[queues.consumers]]
queue = "my-queue"
dead_letter_queue = "my-other-queue"

コマンドラインからwranglerを使用して消費者を作成する際にも、DLQを設定できます:

Terminal window
wrangler queues consumer add $QUEUE_NAME $SCRIPT_NAME --dead-letter-queue=$NAME_OF_OTHER_QUEUE

DLQに置かれたメッセージを処理するには、そのキューのために消費者を設定する必要があります。他のキューと同様に設定します。

アクティブな消費者がない状態でDLQに配信されたメッセージは、キューから削除される前に4日間(4日間)保持されます。