Tuxedo アプリケーションのモニター

Instana エージェントをインストールすると、Tuxedoアプリケーションセンサーが自動的にインストールされます。

Tuxedoセンサーはローカル監視のみをサポートしているため、Tuxedoアプリケーションのパフォーマンスデータファイルが保存されているホストに、 Instana エージェントをインストールする必要があります。 「設定 」セクションの手順に従ってTuxedoアプリケーションセンサーを設定すると、 Instana のUIでTuxedoアプリケーションに関連するメトリクスを確認できるようになります。

の構成

Tuxedo アプリケーション・センサーは、トポロジー・ファイル、サービス・ブローカー・プロジェクト、および Tuxedo サービスのパフォーマンス・データ・ファイルからデータを抽出することにより、Tuxedo アプリケーションをモニターします。 Tuxedo アプリケーションからモニター・データを収集するには、 <agent_install_dir>/etc/instana/configuration.yaml エージェント構成ファイルで以下のパラメーターの値を設定します。

#Tuxedo Application
com.instana.plugin.tuxedoapp:
  enabled: true
  poll_rate: 120 # The metrics poll rate in seconds.
  timeZoneServiceBroker: 'GMT' # The time zone that is used for the reporting time of the Service Broker Project log data. The default value is 'GMT'.
  timeZoneTuxedoService: 'GMT' # The time zone that is used for the reporting time of the Tuxedo Service performance data. The default value is 'GMT'.
  availabilityZone: 'Tuxedo Application Performance' # The default availability zone of the Tuxedo application.
  topology: '' # The directory where topology data files are located.
  serviceBrokerCallLog: '' # The directory where Service Broker Project log files are located.
  tuxedoPerf: '' # The directory where Tuxedo performance files are located.
  batchSizeServiceBroker: 400 # Indicates how many Service Broker Project log files will be handled in each thread.
  batchSizeTuxedo: 4000 # Indicates how many Tuxedo performance files will be handled in each thread.

バッチサイズとポーリング頻度の調整

Tuxedo センサーは、マルチスレッドを使用してパフォーマンス・ファイルとスレッド・モニター・マルチ・ファイルをモニターします。 センサーが、設定されたポーリング・レート内のファイルの構文解析を完了しない場合、以下の例のようなエラー・メッセージが <agent_install_dir>/data/log/agent.log ファイルに表示されます。

2023-06-16T18:19:08.531+08:00 | WARN | instana-executor-thread-2-11     | okerDataProvider | com.instana.sensor-tuxedoapp - 1.0.0 | 547531ms is taken to parse files, which is longer than the current poll rate 300000ms. You are suggested to increase the poll rate or reduce the batch size of Service Broker Project files.
2023-06-16T18:18:59.200+08:00 | WARN | instana-executor-thread-2-2      | xedoDataProvider | com.instana.sensor-tuxedoapp - 1.0.0 |  538200ms is taken to parse files, which is longer than the current poll rate 300000ms. You are suggested to increase the poll rate or reduce the batch size of Tuxedo Service files.

このエラーが発生した場合は、ポーリング率を上げるか、パフォーマンス・ファイルのバッチ・サイズを減らしてください。

メトリックの表示

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

  1. Instana のUIのサイドバーで 「インフラストラクチャ」 を選択します。
  2. 構成ファイルで定義したアベイラビリティー・ゾーンを見つけます。 アベイラビリティー・ゾーンが構成ファイルで指定されていない場合、アベイラビリティー・ゾーンはデフォルトで Tuxedo Application Performance に設定されます。
  3. アベイラビリティー・ゾーン内のアプリケーションをクリックします。

ダッシュボードでは、以下の詳細とメトリックを表示できます。

タキシードの着用

Tuxedo アプリケーションおよびメトリックの詳細を表示できます。

プロパティー

Tuxedo アプリケーションの詳細は、以下の表にリストされています。

アプリケーション詳細 説明
アプリケーション名 アプリケーションを一意的に識別するドメインの名前

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

以下の表に、Tuxedo アプリケーション・メトリックをリストします。

アプリケーション・メトリック 説明
numOfSBrokerProjects サービス・ブローカー・プロジェクトの数
numOfTuxSvcs Tuxedo サービスの数
sbp_avgResTime サービス・ブローカー・プロジェクトの平均応答時間
sbp_preCallTime サービス・ブローカーが事前呼び出し処理に費やした時間の平均
sbp_callTime サービス・ブローカー・プロジェクトの平均往復サービス呼び出し時間
sbp_postCallTime サービス・ブローカーが呼び出し後の処理に費やした平均時間
SB スループット サービス・ブローカー・プロジェクトのスループット
SB エラー Service Broker プロジェクトに対して発生した特定の時間間隔 (ポーリング率) の 1 秒当たりのエラー数
ts_avgResTime Tuxedo サービスの平均応答時間
TS スループット Tuxedo サービスのスループット。

Tuxedo サービス

Tuxedo サービスおよびメトリックの詳細を表示できます。

プロパティー

以下の表に、Tuxedo サービスの詳細をリストします。

Tuxedo サービスの詳細 説明
tsName Tuxedo サービスの名前

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

以下の表に、Tuxedo サービス・メトリックをリストします。

マシン・メトリック 説明
countLessHalf 完了までにかかる時間が 0.5 秒未満のトランザクションの数
countHalfAndOneHalf 0.5 秒から 1.5 秒の間に完了するトランザクションの数
countOneHalfAndThree 完了するまでに 1.5 秒から 3 秒かかるトランザクションの数
countThreeAndFive 完了までにかかる時間が 3 秒から 5 秒までのトランザクションの数
countGreaterFive 完了までにかかる時間が 5 秒を超えるトランザクションの数
avgResTime 平均応答時間。
スループット スループット

Tuxedo サーバー

Tuxedo サーバーおよびメトリックの詳細を表示できます。

プロパティー

以下の表に、Tuxedo サーバーの詳細をリストします。

Tuxedo サーバーの詳細 説明
サーバー Tuxedo サーバーの名前
リリース Tuxedo サービスのリリース
ホスト ホスト名
パフォーマンス・メトリック

以下の表に、Tuxedo サーバー・メトリックをリストします。

Tuxedo サーバーの詳細 説明
avgResTime 平均応答時間。
スループット スループット

サービス・ブローカー・プロジェクト

Service Broker プロジェクトの詳細とメトリックを表示できます。

プロパティー

Service Broker プロジェクトの詳細を以下の表に示します。

サービス・ブローカー・プロジェクトの詳細 説明
sbpName サービス・ブローカー・プロジェクトの名前

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

以下の表に、サービス・ブローカー・プロジェクトのメトリックをリストします。

サービス・ブローカー・プロジェクトの詳細 説明
avgResTime 平均応答時間。
preCallTime サービス・ブローカーが事前呼び出し処理に費やした時間の平均
callTime サービス・ブローカー・プロジェクトの平均往復サービス呼び出し時間
postCallTime サービス・ブローカーが呼び出し後の処理に費やした平均時間
スループット スループット
エラー 特定の時間間隔における 1 秒当たりのエラー数 (ポーリング率)
RSFO FML 応答の平均ペイロード。
RQフー FML 要求の平均ペイロード。

サービス・ブローカー

Service Broker の詳細とメトリックを表示できます。

プロパティー

Service Broker の詳細を以下の表に示します。

サービス・ブローカーの詳細 説明
serviceBroker サービス・ブローカーの名前
パフォーマンス・メトリック

以下の表に、Service Broker のメトリックをリストします。

サービス・ブローカーの詳細 説明
avgResTime 平均応答時間。
スループット スループット
RSFO FML 応答の平均ペイロード。
RQフー FML 要求の平均ペイロード。