ActiveMQ

Supported OS Linux Windows Mac OS

インテグレーションバージョン5.0.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 フレーバーに関連付けられたメトリクスは、メトリクス名に 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 XML チェックには、イベントは含まれません。

サービスチェック

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

トラブルシューティング

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

その他の参考資料

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