- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
Supported OS
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 バージョン 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>"
コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレート のガイドを参照して、次のパラメーターを適用してください。
パラメーター | 値 |
---|---|
<インテグレーション名> | 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 (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.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 (rate) | (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 |
artemis
が含まれています。その他すべては ActiveMQ “classic” に報告されます。ActiveMQ チェックには、イベントは含まれません。
activemq.can_connect
Agent が監視対象の ActiveMQ インスタンスに接続できず、メトリクスを収集できない場合は、CRITICAL
を返します。それ以外の場合は、OK
を返します。
Statuses: ok, クリティカル
ご不明な点は、Datadog のサポートチーム までお問合せください。
お役に立つドキュメント、リンクや記事:
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 のサポートチーム にお問い合わせください。
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>"
コンテナ環境の場合は、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 のサポートチーム までお問合せください。