概要

このチェックは、Datadog Agent を通じて RabbitMQ を監視します。

• キューサイズ、コンシューマー数、未承認メッセージ、再配信メッセージなどのキューベースの統計を追跡できます。
• 待機プロセス、使用されたソケット、使用されたファイルディスクリプタなどのノードベースの統計を追跡できます。
• vhost の稼働状態や接続数を監視できます。

セットアップ

インストール

RabbitMQ チェックは Datadog Agent パッケージに含まれています。サーバーに追加でインストールする必要はありません。

構成

RabbitMQ は、RabbitMQ Management Plugin と RabbitMQ Prometheus Plugin の 2 つの方法でメトリクスを公開します。Datadog インテグレーションは両方のバージョンをサポートしています。使用するバージョンに関連する構成説明については、このファイルの指示に従ってください。また、Datadog インテグレーションには、それぞれのバージョンに対応するすぐに使えるダッシュボードとモニターが付属しており、ダッシュボードとモニターのタイトルで区別されています。

RabbitMQ の準備

RabbitMQ Prometheus Plugin。

RabbitMQ v3.8 から RabbitMQ Prometheus Plugin がデフォルトで有効になっています。

RabbitMQ の Prometheus プラグインバージョンは、Datadog Agent による Python 3 のサポートが必要なため、Agent v6 以降でのみサポート可能です。Prometheus プラグインバージョンのインテグレーションを構成する前に、Agent がアップデートされていることを確認してください。

インスタンス構成で prometheus_plugin セクションを設定します。prometheus_plugin オプションを使用する場合、Management Plugin に関連する設定は無視されます。

instances:
  - prometheus_plugin:
      url: http://<HOST>:15692

これにより、1 つの RabbitMQ ノードで /metrics エンドポイントのスクレイピングが可能になります。また、Datadog は /metrics/detailed エンドポイントからもデータを収集することができます。

instances:
  - prometheus_plugin:
      url: http://<HOST>:15692
      unaggregated_endpoint: detailed?family=queue_coarse_metrics

 これにより、/metrics/detailed エンドポイントをスクレイピングして、キューの粗いメトリクスを収集することができます。

RabbitMQ Management Plugin。

プラグインを有効化します。Agent ユーザーは、少なくともmonitoringタグとこれらの必要な権限が必要です。

次のコマンドで、デフォルトの vhost 用に Agent ユーザーを作成します。

rabbitmqctl add_user datadog <シークレット>
rabbitmqctl set_permissions  -p / datadog "^aliveness-test$" "^amq\.default$" ".*"
rabbitmqctl set_user_tags datadog monitoring

ここで、/ はデフォルトのホストを表します。これを、指定した仮想ホスト名に設定してください。詳細については、RabbitMQ のドキュメントを参照してください。

検証

Agent の status サブコマンドを実行し、Checks セクションで rabbitmq を探します。

収集データ

メトリクス

イベント

サービスチェック

rabbitmq.aliveness
Only available with the RabbitMQ Management Plugin. Returns the status of a vhost based on the RabbitMQ Aliveness API. The Aliveness API creates a test queue, then publishes and consumes a message from that queue. Returns OK if the status code from the API is 200 and CRITICAL otherwise.
Statuses: ok, critical

rabbitmq.status
Only available with the RabbitMQ Management Plugin. Returns the status of the RabbitMQ server. Returns OK if the agent was able to contact the API and CRITICAL otherwise.
Statuses: ok, critical

rabbitmq.openmetrics.health
Only available with the RabbitMQ Prometheus Plugin. Returns CRITICAL if the Agent is unable to connect to the OpenMetrics endpoint, otherwise returns OK.
Statuses: ok, critical

トラブルシューティング

Prometheus Plugin への移行

Prometheus Plugin は、Management Plugin とは異なるメトリクスを公開します。 ここでは、Management Plugin から Prometheus Plugin に移行する際に注意すべき点を説明します。

• この表でメトリクスを検索してください。メトリクスの説明に [OpenMetricsV2] タグが含まれていれば、Prometheus Plugin で利用可能です。Management Plugin のみで利用可能なメトリクスは、説明にタグを持ちません。
• Management Plugin のメトリクスを使用しているダッシュボードやモニターは機能しません。OpenMetrics Version と表示されているダッシュボードやモニターに切り替えてください。
• デフォルトの構成では、集計されたメトリクスが収集されます。これは、例えば、キューによってタグ付けされたメトリクスが存在しないことを意味します。オプション prometheus_plugin.unaggregated_endpoint を構成すると、集計せずにメトリクスを取得することができます。
• サービスチェックの rabbitmq.status は rabbitmq.openmetrics.health に置き換えられました。サービスチェックの rabbitmq.aliveness は、Prometheus Plugin では同等のものはありません。

Prometheus Plugin では、いくつかのタグが変更されます。以下の表は、より一般的なタグの変更点を説明したものです。

詳しくは、タグファミリーに基づいて RabbitMQ キューをタグ付けを参照してください。

ご不明な点は、Datadog のサポートチームまでお問合せください。

その他の参考資料

お役に立つドキュメント、リンクや記事:

• RabbitMQ 監視のキーメトリクス
• RabbitMQ 監視ツールでメトリクスを収集
• Datadog を使用した RabbitMQ パフォーマンスの監視