This product is not supported for your selected
Datadog site. (
).
Data Streams Monitoring (DSM) は、空ではないデッドレターキュー (DLQ) を可視化して、メッセージ処理の失敗を監視し、調査できるようにします。DSM により、これらのメッセージ処理の失敗を Datadog 内で直接修復することも可能になります。
デッドレターキューの監視は、Amazon SQS キューで利用可能です。
DLQ の監視
セットアップ
使用方法
デッドレターキューのモニターを作成する
キューがメッセージを DLQ に再ルーティングしているかどうかを追跡するには、data_streams.sqs.dead_letter_queue.messages メトリクスに基づいてアラートを起動する メトリクスモニター を作成できます。
キューの DLQ 対応モニターを作成するには:
- Datadog で Data Streams Monitoring に移動します。
- Explore タブ (デフォルト) を選択します。
- サポートされているキューをクリックして、そのサイドパネルを開きます。
- Dead Letter Queue タブを選択します。
- Create Monitor をクリックして、モニターセットアップページを開きます。DLQ が空でない場合にアラートを起動するモニターを作成するにはデフォルトの入力で十分ですが、必要に応じてこのページで追加の設定を行うこともできます。
- ページ下部にある Create をクリックします。
メッセージ処理の問題を検出する
Data Streams Monitoring を利用することで、メッセージを処理できなかった場所と、影響を受ける可能性のあるダウンストリームのサービスを検出できます。
空ではない DLQ を Datadog で直接調査して解決するには、Datadog Actions を使用できます。
セットアップ
Datadog で コネクション を作成します。アクションを実行するには IAM エンティティが必要です。この IAM エンティティは、IAM ユーザー (シークレットアクセスキーを使用) または IAM ロール (sts:AssumeRole を使用することにより前提される) のいずれかにすることができ、次の権限が付与されます。
sqs:ReceiveMessage (peek 対応)sqs:StartMessageMoveTask (redrive 対応)sqs:PurgeQueue (purge 対応)
これらの権限は、すべての SQS キューにグローバルに適用することも、特定のキューに制限することもできます。
使用方法
コネクションをセットアップした後、サポートされているキューのいずれかをクリックしてそのサイドパネルを開き、次の操作を実行することができます。
- Peek: 失敗したメッセージの内容を調査し、根本原因を特定するための操作
- Redrive: 別の処理を試みる目的でメッセージを再びキューに入れるための操作
- Purge: 処理が不要になったメッセージを削除するための操作
トラブルシューティング
デッドレターキューの情報が表示されない場合:
- Datadog-AWS インテグレーション がインストールされていることを確認
- AWS ロールで AWS 管理の
AmazonSQSReadOnlyAccess ポリシーが使用されていることを確認 - ロールに
sqs:ListQueues および sqs:GetQueueAttributes の権限が付与されていることを確認
参考文献
