Tibco EMS のモニター

Instana エージェントをインストールすると、TIBCO EMSセンサーが自動的にデプロイおよびインストールされます。

サポート情報

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

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

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

  • 8.3.x
  • 8.4.x
  • 8.5.x
  • 8.6.x

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

テクノロジー サポート・ポリシー 最新技術バージョン サポートされる最新バージョン
TIBCO EMS(エンタープライズ・メッセージング・サービス) オンデマンド 10.4.0 8.6.x

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

構成

メトリックのデフォルトのポーリング・レートは 5 秒です。 エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yamlでポーリング・レートを変更できます。

com.instana.plugin.tibcoems:
  poll_rate: 5  # seconds
 
注: ポーリングレートの値を小さくすると、TIBCO EMSプロセスのCPU使用率が上昇します。

インスタンスがユーザー/パスワードによる許可を必要とする場合は、エージェント構成ファイルでもそれらを構成する必要があります。

com.instana.plugin.tibcoems:
  user: ''      # default is 'admin'
  password: ''
 

Instana エージェントは、Tibco EMS 構成ファイルからのホスト名とポートを自動的に解決しようとします。 カスタムのホスト名とポートを使用する必要がある場合は、エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yamlでそれらを構成できます。

com.instana.plugin.tibcoems:
  hostname: '' # optional
  port: ''     # optional

 

プロセス環境やファイルの設定を使用して、複数のTIBCO EMSインスタンスの監視を設定できます。

注記: 非管理ユーザーのメトリックにアクセスするために必要な最小権限は、以下のとおりです。

  • view-destination
  • view-server

ユーザーにこれらの権限を付与するには、 tibemsadmin コマンドラインツールで次のコマンドを実行します

grant admin user=${username} view-destination
grant admin user=${username} view-server
 

モニターするトピックとキューを構成するには、エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yamlで一致する式を指定します。 例:

com.instana.plugin.tibcoems:
   queuesRegex: 'bar.>'
   topicsRegex: 'foo.>'
 

ワイルドカードを使用してキューやトピックを選択する方法の詳細については、 TIBCO EMSの公式ドキュメントを参照してください

統計の有効化

メトリックを収集するには、エージェントで統計が有効になっている必要があります。

以下の行を tibemsd.conf ファイルに追加し、サーバーを再始動します。

statistics = enabled
 

または、tibemsadmin を使用して、以下のコマンドを実行します。

set server statistics=enabled
 

ドライバーの提供

エージェントが開始され、ドライバーが提供されていない Tibco EMS サーバーが検出されると、次のメッセージがログに記録されます。

Cannot monitor Tibco EMS without the following drivers: tibjms-<version>.jar, tibjmsadmin-<version>.jar
For licensing reasons they cannot be provided by Instana and
need to be manually obtained and added to the agent
 

通常、ドライバーは <tibco installation dir>/lib/tibjms.jar ファイルと <tibco installation dir>/lib/tibjmsadmin.jar ファイルで使用できます。

エージェントにドライバーを追加するには、 <agent_install_dir>/system/com/tibco/tibjms/tibjms/<version>/tibjms-<version>.jar<agent_install_dir>/system/com/tibco/tibjms/tibjmsadmin/<version>/tibjmsadmin-<version>.jarのそれぞれの場所にドライバーを追加します。

メトリック収集

メトリクスを表示するには、 Instana のユーザーインターフェースのサイドバーで 「Infrastructure」 を選択し、監視対象の特定のホストをクリックします。すると、収集されたすべてのメトリクスと監視対象のプロセスが表示されたホストダッシュボードが表示されます。

構成データ

  • サーバー名
  • バージョン
  • PID
  • 開始時刻/稼働時間
  • ポート
  • 状態
  • 最大接続数
  • トピック
  • キュー

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

サーバー

メトリック 説明 粒度
接続数 サーバー上の接続の合計数。ServerInfo から収集されます。 1 秒
セッション数 サーバー上のセッションの総数。ServerInfo から収集されます。 1 秒
永続サブスクライバー サーバー上の永続サブスクライバーの総数。ServerInfo から収集されます。 1 秒
読み取り操作レート サーバー上の 1 秒あたりの読み取り操作数。ServerInfo から収集されます。 1 秒
書き込み操作レート サーバー上の 1 秒あたりの書き込み操作数。ServerInfo から収集されます。 1 秒
保留メッセージ数 サーバー上の保留メッセージの総数。ServerInfo から収集されます。 1 秒
保留メッセージ・サイズ サーバー上の保留メッセージの合計サイズ。ServerInfo から収集されます。 1 秒
メッセージ・メモリー サーバーにメッセージを保管するために使用されているメモリーの量。ServerInfo から収集されます。 1 秒
インバウンド・メッセージ数 サーバー上のインバウンド・メッセージの総数。ServerInfo から収集されます。 1 秒
アウトバウンド・メッセージ数 サーバー上のアウトバウンド・メッセージの総数。ServerInfo から収集されます。 1 秒
インバウンド・メッセージ・レート サーバー上の 1 秒あたりのインバウンド・メッセージ数。ServerInfo から収集されます。 1 秒
アウトバウンド・メッセージ・レート サーバー上の 1 秒あたりのアウトバウンド・メッセージ数。ServerInfo から収集されます。 1 秒

トピック

メトリック 説明 粒度
サブスクライバー数 トピック上のサブスクライバーの総数。TopicInfo から収集されます。 1 秒
保留メッセージ数 トピック上の保留メッセージの総数。TopicInfo から収集されます。 1 秒
保留メッセージ・サイズ トピック上の保留メッセージの合計サイズ。TopicInfo から収集されます。 1 秒
インバウンド・メッセージ数 トピック上のインバウンド・メッセージの総数。TopicInfo から収集されます。 1 秒
アウトバウンド・メッセージ数 トピック上のアウトバウンド・メッセージの総数。TopicInfo から収集されます。 1 秒
インバウンド・メッセージ・レート トピック上の 1 秒あたりのインバウンド・メッセージ数。TopicInfo から収集されます。 1 秒
アウトバウンド・メッセージ・レート トピック上の 1 秒あたりのアウトバウンド・メッセージ数。TopicInfo から収集されます。 1 秒

キュー

メトリック 説明 粒度
受信側数 キュー上の受信側の総数。QueueInfo から収集されます。 1 秒
保留メッセージ数 キュー上の保留メッセージの総数。QueueInfo から収集されます。 1 秒
保留メッセージ・サイズ キュー上の保留メッセージの合計サイズ。QueueInfo から収集されます。 1 秒
インバウンド・メッセージ数 キュー上のインバウンド・メッセージの総数。QueueInfo から収集されます。 1 秒
アウトバウンド・メッセージ数 キュー上のアウトバウンド・メッセージの総数。QueueInfo から収集されます。 1 秒
インバウンド・メッセージ・レート キュー上の 1 秒あたりのインバウンド・メッセージ数。QueueInfo から収集されます。 1 秒
アウトバウンド・メッセージ・レート キュー上の 1 秒あたりのアウトバウンド・メッセージ数。QueueInfo から収集されます。 1 秒

正常性シグニチャー

センサーごとに、着信メトリックに対して継続的に評価され、ユーザーへの影響に応じて問題またはインシデントを提起するために使用される正常性シグニチャーのキュレーション済み知識ベースがあります。

組み込みイベントは、エンティティのヘルスシグネチャに異常が検出されたことを受けて課題やインシデントをトリガーし、 カスタムイベントは、特定のエンティティの個々のメトリクスについて定義されたしきい値に基づいて課題やインシデントをトリガーします。

TIBCO EMS の組み込みイベントに関する詳細については、「 組み込みイベントのリファレンス 」を参照してください。