ActiveMQ Artemis のモニタリング

ActiveMQ が実行されているホストに Instana エージェントをインストールすると、 ActiveMQ Artemis センサーが自動的にインストールされます。

センサーの設定が完了すると、 Instana のUIで、 ActiveMQ Artemis に関連する監視対象ホストとメトリクスを確認できます。 センサーの設定の詳細については、設定を参照してください。

サポート情報

ActiveMQ Artemis センサーが現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください:

対応バージョンとサポート方針

ActiveMQ Artemis センサーは、 2.0.0 から 2.36.x までの ActiveMQ Artemis の各バージョンに対応しています。 このセンサーは、JBoss ActiveMQ 7以降にも対応しています。

以下の表は、最新のサポート対象バージョンとサポート方針を示しています:

テクノロジー サポート・ポリシー 最新技術バージョン サポートされる最新バージョン
ActiveMQ Artemis オンデマンド 2.52.x 2.52.x

サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。

JMX を有効にする

JMX が有効になっていない場合、 Instana のUIに次のメッセージが表示されます:

Jmx is not enabled.
You can enable it in activemq config by setting the broker property useJmx to true.

/apache-artemis/bin/myinstance/etc/management.xmlから <authorisation> エレメントを削除することにより、JMX アクセスを有効にすることができます。

の構成

詳細なメトリクスの監視を有効にするには、監視対象のキューをエージェント <agent_install_dir>/etc/instana/configuration.yaml の設定ファイルに追加してください。 また、以下の設定例のように、同じファイルに poll_rate を追加することで、カスタムポーリングレートを設定することもできます:


com.instana.plugin.activemqartemis:
  poll_rate: 1 # Value is in seconds. Default value is 1 second.
  monitorQueues:
    - 'test-queue'
    - 'DLQ'
 
注:ActiveMQ Artemis センサーは、ブローカー1台あたり最大100のキューを監視できます。 指定するキューの数がこの制限を超えないようにしてください。

ポーリングレートの設定

注:Instana、 ActiveMQ Artemis sensor、 1.0.9 以降では、 データ取り込み量を削減するためにポーリングレートを設定できるようになっています。 この機能は、セルフホスト型の Instana バックエンド311以降でサポートされています。

次の例に示すように、agent configuration.yaml ファイル poll_rate 内のパラメータを使用して、 Instana が ActiveMQ Artemis からデータやメトリクスを収集するためにポーリングを行う頻度を設定できます

com.instana.plugin.activemqartemis:
  poll_rate: 1 # values are in seconds. Default value is 1 second.

メトリックの表示

メトリクスを表示するには、以下の手順を実行します:

  1. Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 を選択します。
  2. 特定の監視ホストをクリックします。

ホストのダッシュボードには、収集されたすべてのメトリクスと監視されたプロセスが表示されます。

構成データ

  • バージョン
  • ブローカー名
  • ノード ID
  • ポート
  • メモリー制限
  • 住所
  • キュー
  • トランスポート・アクセプター

パフォーマンス・メトリック

ブローカー全体

メトリック 説明 粒度
追加されたメッセージ数 ブローカーに追加され、 activemq.artemis:broker#TotalMessagesAddedから収集されたメッセージの数。 1 秒
確認済みメッセージ数 ブローカーから確認された (および削除された) メッセージのうち、 activemq.artemis:broker#TotalMessagesAcknowledgedから収集されたメッセージの数。 1 秒
期限切れメッセージ数 ブローカー上で有効期限が切れたメッセージの数。すべてのキューの subcomponent=queues#MessagesExpired の合計から収集されます。 1 秒
メッセージが停止しました ブローカー上で停止され、配信の最大試行回数を超えたメッセージの数。すべてのキューの subcomponent=queues#MessagesKilled の合計から収集されます。 1 秒
メッセージ数 すべてのキューのメッセージ数。すべてのキューの subcomponent=queues#MessageCount の合計から収集されます。 1 秒
合計接続数 ブローカー上の合計接続数。activemq.artemis:broker#ConnectionCount から収集されます。 1 秒
合計コンシューマー数 ブローカー上の合計コンシューマー数。activemq.artemis:broker#TotalConsumerCount から収集されます。 1 秒
メモリー使用率 ブローカー上のすべてのアドレスで使用され、activemq.artemis:broker#AddressMemoryUsagePercentageから収集されるメモリ制限のパーセンテージ。 1 秒

キュー

メトリック 説明 粒度
メッセージ数 現在このキューにあるメッセージの数 (スケジュール済み、ページ化、および配信中のメッセージを含む)。subcomponent=queues#MessageCount から収集されます。 1 秒
追加されたメッセージ数 キューに追加され、 subcomponent=queues#MessagesAddedから収集されたメッセージの数。 1 秒
確認済みメッセージ数 キューから確認された (および削除された) メッセージのうち、 subcomponent=queues#MessagesAcknowledgedから収集されたメッセージの数。 1 秒
期限切れメッセージ数 このキューで期限切れになり、 subcomponent=queues#MessagesExpiredから収集されたメッセージの数。 1 秒
メッセージが停止しました 最大配信試行回数を超えたためにこのキューで停止され、 subcomponent=queues#MessagesKilledから収集されたメッセージの数。 1 秒

正常性シグニチャー

各センサーは、入力されるメトリクスに対して継続的に評価され、ユーザーの影響に依存する問題やインシデントを提起するために使用される健康シグネチャのキュレートされた知識ベースを持っています。

組み込みイベント は、エンティティー上の失敗したヘルス・シグニチャーに基づいて問題またはインシデントをトリガーし、 カスタム・イベント は、エンティティーの個々のメトリックのしきい値に基づいて問題またはインシデントをトリガーします。

ActiveMQ Artemis センサーの組み込みイベントについては、組み込みイベントのリファレンスを参照してください。