ActiveMQ

Supported OS Linux Windows Mac OS

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

概要

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

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

注: バージョン 5.8.0 以前の ActiveMQ を実行している場合は、Agent 5.10.x リリースのサンプルファイルを参照してください。

セットアップ

インストール

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

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

構成

ホスト

ホストで実行中の Agent に対してこのチェックを構成するには

ActiveMQ サーバーで JMX Remote が有効になっていることを確認します。
ActiveMQ に接続するように Agent を構成します。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 を再起動します。

コンテナ化

コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照して、次のパラメーターを適用してください。

メトリクスの収集

パラメーター	値
`<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 only) Number of bytes used by each page for this address. Shown as byte
activemq.artemis.address.number_of_messages (rate)	(Artemis only) The sum of messages on queue(s), including messages in delivery. Shown as message
activemq.artemis.address.pages_count (gauge)	(Artemis only) Number of pages used by this address. Shown as page
activemq.artemis.address.routed_messages (rate)	(Artemis only) Number of messages routed to one or more bindings, as a rate. Shown as message
activemq.artemis.address.size (gauge)	(Artemis only) Number of estimated bytes being used by all the queue(s) bound to this address; used to control paging and blocking. Shown as byte
activemq.artemis.address.unrouted_messages (rate)	(Artemis only) Number of messages not routed to any bindings, as a rate. Shown as message
activemq.artemis.address_memory_usage (gauge)	(Artemis only) Memory used by all the addresses on broker for in-memory messages. Shown as byte
activemq.artemis.address_memory_usage_pct (gauge)	(Artemis only) Memory used by all the addresses on broker as a percentage of the global-max-size. Shown as percent
activemq.artemis.connection_count (gauge)	(Artemis only) Number of clients connected to this server. Shown as connection
activemq.artemis.disk_store_usage_pct (gauge)	(Artemis only) Percentage of total disk store used. Shown as percent
activemq.artemis.max_disk_usage (gauge)	(Artemis only) Maximum limit for disk use in percentage. Shown as percent
activemq.artemis.queue.consumer_count (gauge)	(Artemis only) Number of consumers consuming messages from this queue.
activemq.artemis.queue.max_consumers (gauge)	(Artemis only) Maximum number of consumers allowed on this queue at any one time.
activemq.artemis.queue.message_count (gauge)	(Artemis only) Number of messages currently in this queue (includes scheduled, paged, and in-delivery messages), as a rate. Shown as message
activemq.artemis.queue.messages_acknowledged (rate)	(Artemis only) Number of messages acknowledged from this queue since it was created, as a rate. Shown as message
activemq.artemis.queue.messages_added (rate)	(Artemis only) Number of messages added to this queue since it was created, as a rate. Shown as message
activemq.artemis.queue.messages_expired (rate)	(Artemis only) Number of messages expired from this queue since it was created, as a rate. Shown as message
activemq.artemis.queue.messages_killed (rate)	(Artemis only) Number of messages removed from this queue since it was created due to exceeding the max delivery attempts, as a rate. Shown as message
activemq.artemis.total_connection_count (rate)	(Artemis only) Number of clients which have connected to this server since it was started, as a rate. Shown as connection
activemq.artemis.total_consumer_count (rate)	(Artemis only) Number of consumers consuming messages from all the queues on this server, as a rate.
activemq.artemis.total_message_count (rate)	(Artemis only) Number of messages in all queues on the server, as a rate. Shown as connection
activemq.artemis.total_messages_acknowledged (rate)	(Artemis only) Number of messages acknowledged from all the queues on this server since it was started, as a rate. Shown as connection
activemq.artemis.total_messages_added (rate)	(Artemis only) Number of messages sent to this server since it was started, as a rate. Shown as connection
activemq.broker.memory_pct (gauge)	The percentage of memory in use. Shown as percent
activemq.broker.store_pct (gauge)	The percentage of store in use. Shown as percent
activemq.broker.temp_pct (gauge)	The percentage of temporary in use. Shown as percent
activemq.queue.avg_enqueue_time (gauge)	On average the amount of time (ms) that messages remained enqueued. Shown as millisecond
activemq.queue.consumer_count (gauge)	The number of consumers connected.
activemq.queue.dequeue_count (gauge)	The amount of messages that remained dequeued. Shown as message
activemq.queue.dispatch_count (gauge)	The amount of messages that have been dispatched. Shown as message
activemq.queue.enqueue_count (gauge)	The amount of messages that have been enqueued. Shown as message
activemq.queue.expired_count (gauge)	The amount of messages that have been expired. Shown as message
activemq.queue.in_flight_count (gauge)	The amount of messages that have been in flight. Shown as message
activemq.queue.max_enqueue_time (gauge)	The max the amount of time (ms) that messages remained enqueued. Shown as millisecond
activemq.queue.memory_pct (gauge)	The percentage of memory currently in use. Shown as percent
activemq.queue.min_enqueue_time (gauge)	The min the amount of time (ms) that messages remained enqueued. Shown as millisecond
activemq.queue.producer_count (gauge)	The number of producers connected.
activemq.queue.size (gauge)	The amount of messages that remained queued. Shown as message

ActiveMQ Artemis フレーバーに関連付けられたメトリクスは、メトリクス名に artemis が含まれています。その他すべては ActiveMQ “classic” に報告されます。

イベント

ActiveMQ チェックには、イベントは含まれません。

サービスチェック

activemq.can_connect
Agent が監視対象の ActiveMQ インスタンスに接続できず、メトリクスを収集できない場合は、CRITICAL を返します。それ以外の場合は、OK を返します。
Statuses: ok, クリティカル

トラブルシューティング

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

その他の参考資料

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

ActiveMQ XML インテグレーション

概要

ActiveMQ XML からメトリクスをリアルタイムで取得して、

ActiveMQ XML の状態を視覚化して監視します。
ActiveMQ XML のフェイルオーバーやイベントの通知を受けます。

セットアップ

インストール

ActiveMQ XML チェックは Datadog Agent パッケージに含まれているので、サーバーに別途インストールする必要はありません。

構成

ホスト上で実行されている Agent に対してこのチェックを構成するには、以下の手順に従ってください。コンテナ環境については、コンテナ化セクションを参照してください。

ホスト

ホストで実行中の Agent に対してこのチェックを構成するには

ご使用の統計 url で、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの activemq_xml.d/conf.yaml を編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル activemq_xml.d/conf.yaml を参照してください。
注: ActiveMQ XML インテグレーションではカスタムメトリクスを送信することができますが、これはお客様の請求に影響します。デフォルトでは、メトリクス数は 350 に制限されています。メトリクスの追加が必要な場合は、Datadog のサポートチームにお問い合わせください。
Agent を再起動します。

ログ収集

Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。
```
logs_enabled: true
```

ActiveMQ のログ収集を開始するには、次のコンフィギュレーションブロックを activemq_xml.d/conf.yaml または 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 を再起動します。

コンテナ化

コンテナ環境の場合は、JMX を使用したオートディスカバリーのガイドを参照してください。

検証

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

収集データ

メトリクス

activemq.queue.consumer_count (gauge)	The number of consumers of a queue.
activemq.queue.count (gauge)	The number of queues.
activemq.queue.dequeue_count (gauge)	The total number of messages sent to a queue since the last restart. Shown as message
activemq.queue.enqueue_count (gauge)	The total number of messages removed from a queue (acknowledged by consumer) since the last restart. Shown as message
activemq.queue.size (gauge)	The size of a queue.
activemq.subscriber.count (gauge)	The number of subscribers.
activemq.subscriber.dequeue_counter (gauge)	The number of messages sent to and acknowledged by the client. Shown as message
activemq.subscriber.dispatched_counter (gauge)	The number of messages sent to the client. Shown as message
activemq.subscriber.dispatched_queue_size (gauge)	The number of messages dispatched that are awaiting acknowledgement. Shown as message
activemq.subscriber.enqueue_counter (gauge)	The number of messages that matched the subscription. Shown as message
activemq.subscriber.pending_queue_size (gauge)	The number of messages pending delivery. Shown as message
activemq.topic.consumer_count (gauge)	The number of consumers of a topic.
activemq.topic.count (gauge)	The number of topics.
activemq.topic.dequeue_count (gauge)	The total number of messages sent to a topic since the last restart. Shown as message
activemq.topic.enqueue_count (gauge)	The total number of messages removed from a topic (acknowledged by consumer) since the last restart. Shown as message
activemq.topic.size (gauge)	The size of a topic.

イベント

ActiveMQ XML チェックには、イベントは含まれません。

サービスチェック

ActiveMQ XML チェックには、サービスのチェック機能は含まれません。

トラブルシューティング

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

その他の参考資料

ActiveMQ のメトリクスとパフォーマンスの監視