ActiveMQ

ActiveMQ

Agent Check Agentチェック

Linux Mac OS Windows OS Supported

概要

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

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

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

セットアップ

インストール

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

このチェックは、メトリクスを JMX 経由で収集するため、Agent が jmxfetch をフォークできるように、各ノード上に JVM が必要です。Oracle 提供の JVM を使用することをお勧めします。

コンフィギュレーション

ホスト

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

  1. ActiveMQ サーバーで JMX Remote が有効になっていることを確認します。

  2. 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
    
  3. Agent を再起動します

ログの収集

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

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

    logs_enabled: true
    
  2. 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>"
    
  3. 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 が返されます。

トラブルシューティング

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

その他の参考資料

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

ActiveMQ XML インテグレーション

概要

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

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

セットアップ

インストール

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

コンフィギュレーション

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

ホスト

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

  1. ご使用の統計 url で、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの activemq_xml.d/conf.yaml を編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル activemq_xml.d/conf.yaml を参照してください。

    : ActiveMQ XML インテグレーションではカスタムメトリクスを送信することができますが、これはお客様の請求に影響します。デフォルトでは、メトリクス数は 350 に制限されています。メトリクスの追加が必要な場合は、Datadog のサポートチームにお問い合わせください。

  2. Agent を再起動します

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

    logs_enabled: true
    
  2. 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>"
    
  3. 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 のサポートチームまでお問合せください。

その他の参考資料