ActiveMQ

Supported OS Linux Windows Mac OS

インテグレーションバージョン5.0.0

概要

ActiveMQ チェックは、ブローカー、キュー、プロデューサー、コンシューマーなどのメトリクスを収集します。

注: このチェックは ActiveMQ Artemis (将来の ActiveMQ バージョン 6) もサポートしており、メトリクスは activemq.artemis ネームスペースで報告されます。このインテグレーションが提供するメトリクスの一覧は、metadata.csv を参照してください。

注: ActiveMQ バージョンが 5.8.0 より古い場合は、Agent 5.10.x リリース時のサンプルファイルを参照してください。

セットアップ

インストール

Agent の ActiveMQ チェックは Datadog Agent パッケージに含まれているため、ActiveMQ ノードに追加でインストールする必要はありません。

このチェックは、JMXFetch を利用して JMX からメトリクスを収集します。Agent が JMXFetch を実行できるように、各ノードに JVM が必要です。Datadog では Oracle 提供の JVM の使用を推奨しています。

設定

ホスト

ホスト上で稼働している Agent 向けにこのチェックを設定するには、次の手順を行います。

ActiveMQ サーバーで JMX Remote が有効になっていることを確認してください。
Agent が ActiveMQ に接続できるように設定します。Agent の構成ディレクトリ直下の conf.d/ フォルダーにある activemq.d/conf.yaml を編集してください。利用可能な設定オプションの全一覧は、activemq.d/conf.yaml のサンプルを参照してください。デフォルトで収集されるメトリクスは、metrics.yaml ファイルに記載されています。
```
init_config:
  is_jmx: true
  collect_default_metrics: true

instances:
  - host: localhost
    port: 1616
    user: username
    password: password
    name: activemq_instance
```
Agent を再起動してください。

ログ収集

Agent バージョン >6.0 で利用可能

Datadog Agent ではログ収集がデフォルトで無効になっているため、datadog.yaml ファイルで有効化してください:
```
logs_enabled: true
```

ActiveMQ のログ収集を開始するには、activemq.d/conf.yaml ファイルに次の設定ブロックを追加します:

logs:
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/activemq.log"
    source: activemq
    service: "<SERVICE_NAME>"
  - type: file
    path: "<ACTIVEMQ_BASEDIR>/data/audit.log"
    source: activemq
    service: "<SERVICE_NAME>"

Agent を再起動してください。

コンテナ化

コンテナ化環境の場合は、以下のパラメーターの適用方法について Autodiscovery インテグレーションテンプレートを参照してください。

メトリクスの収集

パラメーター	値
`<INTEGRATION_NAME>`	`activemq`
`<INIT_CONFIG>`	`"is_jmx": true`
`<INSTANCE_CONFIG>`	`{"host": "%%host%%","port":"1099"}`

ログ収集

Agent バージョン >6.0 で利用可能

Datadog Agent では、ログ収集はデフォルトで無効になっています。有効化するには、Kubernetes ログ収集を参照してください。

パラメーター	値
`<LOG_CONFIG>`	`{"source": "activemq", "service": "<YOUR_APP_NAME>"}`

検証

Agent の status サブコマンドを実行し、出力の Checks セクションに activemq が表示されていることを確認してください。

収集データ

メトリクス


activemq.artemis.address.bytes_per_page (gauge)	(Artemis のみ) このアドレスにおける 1 ページあたりの使用バイト数。表示単位: byte
activemq.artemis.address.number_of_messages (rate)	(Artemis のみ) 配信中のメッセージを含む、キュー上のメッセージ合計。表示単位: message
activemq.artemis.address.pages_count (gauge)	(Artemis のみ) このアドレスで使用されているページ数。表示単位: page
activemq.artemis.address.routed_messages (rate)	(Artemis のみ) 1 つ以上のバインディングにルーティングされたメッセージ数 (レート)。表示単位: message
activemq.artemis.address.size (gauge)	(Artemis のみ) このアドレスにバインドされている全キューが使用している推定バイト数。ページングやブロッキング制御に使用されます。表示単位: byte
activemq.artemis.address.unrouted_messages (rate)	(Artemis のみ) どのバインディングにもルーティングされなかったメッセージ数 (レート)。表示単位: message
activemq.artemis.address_memory_usage (gauge)	(Artemis のみ) ブローカー上の全アドレスにおける、インメモリメッセージの使用メモリ量。表示単位: byte
activemq.artemis.address_memory_usage_pct (gauge)	(Artemis のみ) ブローカー上の全アドレスの使用メモリ量を、global-max-size に対する割合で表したもの。表示単位: percent
activemq.artemis.connection_count (gauge)	(Artemis のみ) このサーバーに接続しているクライアント数。表示単位: connection
activemq.artemis.disk_store_usage_pct (gauge)	(Artemis のみ) ディスクストアの総使用量の割合。表示単位: percent
activemq.artemis.max_disk_usage (gauge)	(Artemis のみ) ディスク使用率の上限(%)。表示単位: percent
activemq.artemis.queue.consumer_count (gauge)	(Artemis のみ) このキューからメッセージを消費しているコンシューマー数。
activemq.artemis.queue.max_consumers (gauge)	(Artemis のみ) このキューで同時に許可されるコンシューマー数の上限。
activemq.artemis.queue.message_count (gauge)	(Artemis のみ) 現在このキューに存在するメッセージ数 (スケジュール済み、ページング中、配信中を含む) (レート)。表示単位: message
activemq.artemis.queue.messages_acknowledged (rate)	(Artemis のみ) キュー作成以降、このキューで ACK されたメッセージ数 (レート)。表示単位: message
activemq.artemis.queue.messages_added (rate)	(Artemis のみ) キュー作成以降、このキューに追加されたメッセージ数 (レート)。表示単位: message
activemq.artemis.queue.messages_expired (rate)	(Artemis のみ) キュー作成以降、このキューで期限切れになったメッセージ数(レート)。表示単位: message
activemq.artemis.queue.messages_killed (rate)	(Artemis のみ) キュー作成以降、最大配信試行回数を超えたために削除されたメッセージ数 (レート)。表示単位: message
activemq.artemis.total_connection_count (rate)	(Artemis のみ) サーバー起動以降、このサーバーに接続したクライアント数 (レート)。表示単位: connection
activemq.artemis.total_consumer_count (rate)	(Artemis のみ) サーバー上の全キューでメッセージを消費しているコンシューマー数 (レート)。
activemq.artemis.total_message_count (rate)	(Artemis のみ) サーバー上の全キューに存在するメッセージ数 (レート)。表示単位: connection
activemq.artemis.total_messages_acknowledged (rate)	(Artemis のみ) サーバー起動以降、全キューで ACK されたメッセージ数 (レート)。表示単位: connection
activemq.artemis.total_messages_added (rate)	(Artemis のみ) サーバー起動以降、このサーバーに送信されたメッセージ数 (レート)。表示単位: connection
activemq.broker.memory_pct (gauge)	使用中メモリの割合。表示単位: percent
activemq.broker.store_pct (gauge)	使用中ストアの割合。表示単位: percent
activemq.broker.temp_pct (gauge)	使用中の一時領域の割合。表示単位: percent
activemq.queue.avg_enqueue_time (gauge)	メッセージがキューに滞留していた時間 (ms) の平均。表示単位: millisecond
activemq.queue.consumer_count (gauge)	接続中のコンシューマー数。
activemq.queue.dequeue_count (gauge)	デキューされているメッセージ数 (レート)。表示単位: message
activemq.queue.dispatch_count (gauge)	ディスパッチされているメッセージ数 (レート)。表示単位: message
activemq.queue.enqueue_count (gauge)	エンキューされているメッセージ数 (レート)。表示単位: message
activemq.queue.expired_count (gauge)	期限切れになっているメッセージ数 (レート)。表示単位: message
activemq.queue.in_flight_count (gauge)	処理中 (in flight) のメッセージ数 (レート)。表示単位: message
activemq.queue.max_enqueue_time (gauge)	メッセージがキューに滞留していた時間 (ms) の最大値。表示単位: millisecond
activemq.queue.memory_pct (gauge)	現在使用中のメモリの割合。表示単位: percent
activemq.queue.min_enqueue_time (gauge)	メッセージがキューに滞留していた時間 (ms) の最小値。表示単位: millisecond
activemq.queue.producer_count (gauge)	接続中のプロデューサー数。
activemq.queue.size (gauge)	キューに残っているメッセージ数。表示単位: message