ActiveMQ

Supported OS Linux Windows Mac OS

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

概要

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

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

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

セットアップ

APM に Datadog Agent を構成する

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 を再起動します。

コンテナ化

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

メトリクスの収集

パラメーター	値
`<インテグレーション名>`	`activemq`
`<初期コンフィギュレーション>`	空白または `{}`
`<インスタンスコンフィギュレーション>`	`{"host": "%%host%%","port":"1099"}`

ログの収集

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

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

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

検証

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

収集データ

メトリクス

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.producer_count (gauge)	The number of producers connected.
activemq.queue.max_enqueue_time (gauge)	The max the amount of time (ms) that messages remained enqueued. Shown as millisecond
activemq.queue.min_enqueue_time (gauge)	The min 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.size (gauge)	The amount of messages that remained queued. Shown as message
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.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.broker.memory_pct (gauge)	The percentage of memory in use. Shown as percent
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.max_disk_usage (gauge)	(Artemis only) Maximum limit for disk use in percentage. Shown as percent
activemq.artemis.disk_store_usage_pct (gauge)	(Artemis only) Percentage of total disk store used. Shown as percent
activemq.artemis.connection_count (gauge)	(Artemis only) Number of clients connected to this server. Shown as connection
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_message_count (rate)	(Artemis only) Number of messages in all queues on the server, 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.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_consumer_count (rate)	(Artemis only) Number of consumers consuming messages from all the queues on this server, as a rate.
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.pages_count (gauge)	(Artemis only) Number of pages used by this address. Shown as page
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.bytes_per_page (gauge)	(Artemis only) Number of bytes used by each page for this address. Shown as byte
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.unrouted_messages (rate)	(Artemis only) Number of messages not routed to any bindings, as a rate. Shown as message
activemq.artemis.queue.message_count (rate)	(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.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.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 (gauge)	(Artemis only) Number of messages expired from this queue since it was created, 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_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 フレーバーに関連付けられたメトリクスは、メトリクス名に artemis が含まれています。その他すべては ActiveMQ “classic” に報告されます。

イベント

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

サービスのチェック

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

トラブルシューティング

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

その他の参考資料

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

ActiveMQ XML インテグレーション

概要

ActiveMQ XML からメトリクスをリアルタイムに取得すると、以下のことが可能になります。

ActiveMQ XML の状態を視覚化および監視できます。
ActiveMQ XML のフェイルオーバーとイベントの通知を受けることができます。

セットアップ

APM に Datadog Agent を構成する

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.count (gauge)	The number of queues.
activemq.queue.consumer_count (gauge)	The number of consumers of a queue.
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.topic.count (gauge)	The number of topics.
activemq.topic.consumer_count (gauge)	The number of consumers of a topic.
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.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 XML チェックには、イベントは含まれません。

サービスのチェック

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

トラブルシューティング

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

その他の参考資料

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