ActiveMQ のモニター

「 Instana 」エージェントをインストールすると、「 ActiveMQ 」センサーが自動的に展開およびインストールされます。

サポート情報

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

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

このセンサーは、以下のバージョンの ActiveMQ: に対応しています

  • 5.11.1
  • 5.12.0
  • 5.13.1
  • 5.14.3
  • 5.15.2
  • 5.18.0
  • 6.1.2

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

テクノロジー サポート・ポリシー 最新技術バージョン サポートされる最新バージョン
ActiveMQ 45 日間 6.2.7 6.2.6

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

クライアントサイドのトレースに対応

この技術において、 Instana は以下の言語のクライアントサイドトレースに対応しています:

JMX を有効にする

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

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

`broker` useJmx="true" プロパティを使用して ` JMX ` サポートを有効にする方法の詳細については、 ActiveMQ のドキュメントを参照してください。

構成

詳細なメトリック・モニターを有効にするには、モニターするキューまたはトピックを <agent_install_dir>/etc/instana/configuration.yaml エージェント構成ファイルに追加します。

com.instana.plugin.activemq:
  poll_rate: 1 # values are in seconds. Default value is 1 second.
  monitorQueues:
    - 'test-queue-1'
    - 'DLQ.test-1'
  monitorTopics:
    - 'ActiveMQ.Advisory.Topic'
    - 'test-topic-1'
 

この poll_rate パラメータは秒単位で指定され、デフォルト値は 1 です。

注:ActiveMQ センサーで監視されるキューとトピックの両方について、上限は100に設定されています。

ポーリングレートの設定

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

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

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

メトリック収集

メトリックを表示するには、以下のステップを実行します。

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

  2. 特定のモニター対象ホストをクリックします。

    これで、収集されたすべてのメトリックとモニター対象プロセスを含むホスト・ダッシュボードを表示できます。

構成データ

  • バージョン
  • ブローカー名
  • 正常性状況
  • ポート
  • 役割
  • メモリー制限
  • ストア制限
  • トピック
  • キュー
  • トランスポート・コネクター

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

ブローカー全体

メトリック 説明 粒度
エンキューされたすべてのトピック・メッセージ数 ブローカーに送信され、またブローカーから収集されるメッセージBrokerMBean#TotalEnqueueCountの数。 1 秒
デキューされたすべてのトピック・メッセージ数 ブローカー上で確認応答が行われ、そこから収集されるメッセージBrokerMBean#TotalDequeの数。 1 秒
エンキューされたすべてのキュー・メッセージ数 すべてのキューに送信されるメッセージの数は、すべてのキューに対する合計としてBrokerMBean#EnqueueCount 算出されます。 1 秒
デキューされたすべてのキュー・メッセージ数 すべてのキューで受信確認されたメッセージの数は、すべてのキューに対するBrokerMBean#DequeueCount 合計から算出されます。 1 秒
合計接続数 ブローカー上の総接続数は、合計値BrokerMBean,connector=clientConnectors#connectionCount から算出されます。 1 秒
合計プロデューサー数 ブローカー上の宛先でアクティブであり、そこから収集されるBrokerMBean#TotalProducerCountメッセージプロデューサーの数。 1 秒
合計コンシューマー数 ブローカー上の宛先にサブスクライブしており、そこからメッセージが収集されるBrokerMBean#TotalConsumerCountメッセージコンシューマーの数。 1 秒
メモリー使用率 使用済みメモリの割合(メモリ使用上限に対する割合)であり、これに基づいてガベージコレクションBrokerMBean#MemoryPercentUsageが行われる。 1 秒
ストアの使用率 店舗の制限枠のうち、使用済みであり、そこから徴収されるBrokerMBean#StorePercentUsage割合。 1 秒

トピック

メトリック 説明 粒度
プロデューサー数 そのトピックに関連し、データが収集されたプロデューサーBrokerMBean,destinationType=Topic#ProducerCountの数。 1 秒
コンシューマー数 BrokerMBean,destinationType=Topic#ConsumerCountそのトピックを購読している消費者の数。 1 秒
エンキューされたメッセージ数 そのトピックに送信され、そこから収集されるメッセージBrokerMBean,destinationType=Topic#EnqueueCountの数。 1 秒
デキューされたメッセージ数 トピックから確認済み(かつ削除済み)として処理され、そこから収集されるメッセージBrokerMBean,destinationType=Topic#DequeueCountの数。 1 秒
メモリー使用率 使用済みメモリの割合(メモリ使用上限に対する割合)であり、これに基づいてガベージコレクションBrokerMBean,destinationType=Topic#MemoryPercentUsageが行われる。 1 秒

キュー

メトリック 説明 粒度
キュー・サイズ このキュー上のメッセージ数。これには、送信済みだが受信確認されていないメッセージも含まれ、この情報はこのキューから取得されますBrokerMBean,destinationType=Queue#QueueSize 1 秒
エンキューされたメッセージ数 キューに送信され、またキューから取得されるメッセージBrokerMBean,destinationType=Queue#EnqueueCountの数。 1 秒
デキューされたメッセージ数 キューから確認(および削除)され、そこから収集されるメッセージBrokerMBean,destinationType=Queue#DequeueCountの数。 1 秒
メモリー使用率 使用済みメモリの割合(メモリ使用上限に対する割合)であり、これに基づいてガベージコレクションBrokerMBean,destinationType=Queue#MemoryPercentUsageが行われる。 1 秒

正常性シグニチャー

各センサーについて、正常性シグニチャーのキュレートされた知識ベースが着信メトリックに対して継続的に評価され、ユーザーの影響に依存する問題またはインシデントを発生させるために使用されます。

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

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