モニターを作成し、負荷テスト中にネットワーク情報やシステムのパフォーマンスデータを収集することができます。負荷テストの結果にもメトリクスのモニターを適用し、Web サーバーに渡された負荷が設計どおり処理されているかを確認できます。

このセクションの内容

次のモニターがサポートされています。

SNMP
Windows モニター (Load Test が Windows にインストールされている場合にだけ利用可能)
WebSphere
JBoss
Tomcat
rstat
リモートモニター
デプロイ済みモニター (AppDynamics、Dynatrace など)
カスタムモニター

Oracle Service Bus (OSB/ALSB) 用のパフォーマンスモニターが利用できます。詳細についてはテクニカルサポートに連絡してください。

ビルトインモニターの追加

次のビルトインモニターを追加できます。

SNMP Agent Monitor の追加

Load Test は、バージョン 1 および 2c の SNMP エージェントが提供する OID に基づいてデータを取得できます。

SNMP Agent Monitor を追加するには、次の操作を行います。

負荷テストタブの [Monitors] ノードを右クリックし、ショートカットメニューの [新規 Monitor] をクリックします。[新規 Monitor] ダイアログが表示されます。
[新規 Monitor] ダイアログで [SNMP] を選択し、[終了] をクリックします。右側のパネルに新規モニターの設定パネルが表示されます。
[ホスト] フィールドに SNMP エージェントのホスト名を入力します。
[コミュニティ] フィールドに SNMP エージェントのコミュニティを入力します。
[新規] をクリックしてパラメーターを入力します。[新規パラメーター] ダイアログが開きます。
次の操作を行って、新規パラメーターを入力します。
- パラメータータイプ: [OID] または [コンポジット] を選択します。
- パラメーター: 選択されたパラメータータイプによって、以下のようにパラメーターオプションが異なります。
  - OID: SNMP エージェントコミュニティ内で特定のパラメーターを識別するオブジェクト ID を入力します。([パラメータータイプ] ドロップダウンメニューで [OID] が選択された場合にだけ利用できます)。
  - コンポジット: データを収集するためのプロセッサ、メモリ、ネットワーク、または TCP を選択します。
  - カウンター: [コンポジットパラメーター] ドロップダウンの選択に応じて、CPU 使用率 (%)、メモリ使用率 (%)、ネットワーク使用率 (%) が表示されます。これらのカウンターは、OID のセットを照会することで計算されます。
    [コンポジットパラメーター] ドロップダウンメニューで TCP が選択された場合、[カウンター] ボックスからカウンターを選択する必要があります。
  - パラメーターの説明: 選択されたコンポジットパラメーターの説明が表示されます。
- グラフタイトル: 追加したモニターに対応するグラフのタイトルを入力します。このタイトルは、負荷テスト進捗グラフおよび詳細レポートグラフに表示されます。
- オペレーションの適用: SNMP エージェントから返された値に適用する簡単なオペレーションを指定します。乗算には「*」、除算には「/」、パーセントを計算するには「%」を使用します。たとえば、エージェントが割り当て済みメモリをバイト単位で返す場合に KB 単位で表示するには、ドロップダウンメニューから「/」を選択し、隣のテキストフィールドに「1024」と入力することで、「/ 1024」というオペレーションを適用します。そして、[グラフタイトル] フィールドには、たとえば「Memory in kilobytes」と入力します。
上記のステップを繰り返し、この SNMP エージェントでモニターするすべてのパラメーターをテーブルに追加します。
負荷テストツリーの [Monitors] > [SNMP] ブランチで対応するノードを右クリックし、新しいモニターを検証します。

Windows パフォーマンスモニターの追加

Windows パフォーマンスモニターを追加するには、次の操作を行います (Load Test が Windows にインストールされている場合にだけ利用可能な機能です)。

負荷テストタブの [Monitors] ノードを右クリックし、ショートカットメニューの [新規 Monitor] をクリックします。[新規 Monitor] ダイアログが表示されます。
[新規モニター] ダイアログで [Windows] を選択し、[終了] をクリックします。
[ホスト] フィールドに perfmon のホスト名を入力します。
[新規] をクリックしてパラメーターを入力します。[パフォーマンスカウンターの追加] ダイアログが開きます。
次の操作を行って、新規パラメーターを入力します。
- モニターするパラメーターのパフォーマンスカウンターおよびインスタンスを選択します。選択したパラメーターの説明が [パラメーターの説明] ボックスに表示されます。
- 追加したモニターに対応するグラフのタイトルを [グラフタイトル] フィールドに入力します。このタイトルは、負荷テスト進捗グラフおよび詳細レポートグラフに表示されます。
- 必要に応じて、モニターデータに適用するオペレーションおよび値を [オペレーションの適用] サブパネルに入力します。たとえば、「/」(除算) オペレーションを選択してオペレーション値フィールドに「1024」と入力すると、元のモニター値をバイト単位からキロバイト単位に変換できます。
上記のステップを繰り返し、この perfmon でモニターするすべてのパラメーターをテーブルに追加します。
負荷テストツリーの [Monitors] > [Windows] ブランチで対応するノードを右クリックし、新しいモニターを検証します。

WebSphere モニターの追加

WebSphere モニターを追加する前に、WebSphere Administrative コンソールの [Security] > [Global security] セクションに移動し、[Enable administrative security] チェックボックスがオフになっていることを確認します。

WebSphere モニターを追加するには、次の操作を行います。

負荷テストタブの [Monitors] ノードを右クリックし、ショートカットメニューの [新規 Monitor] をクリックします。[新規 Monitor] ダイアログが表示されます。
[新規 Monitor] ダイアログで [WebSphere] を選択し、[終了] をクリックします。
プロジェクト設定パネルで [設定] をクリックします。[Configure WebSphere Agent] ダイアログが開きます。
[ホスト] にホスト名を入力し、必要に応じて [ポート] のポート番号を変更してから [次へ] をクリックします。
[Configure WebSphere Agen] パネルで、WebSphere がインストールされた場所のパスを入力または参照します。例: C:\IBM\WebSphere
[次へ] をクリックします。[Configure WebSphere Agent] ダイアログには、サーバーに必要な Jar ファイルのテーブルが表示され、適切な Jar が見つかったかどうかが示されます。
[Configure WebSphere Agent] ダイアログで [終了] をクリックします。[パラメーターの追加] ダイアログが開きます。
[パラメーターの追加] ダイアログの左側のパネルでパラメーターを選択します。[パラメーターの追加] ダイアログ右側のパネルに、表示する各パラメーターインスタンスの名前、説明、および値が表示されます。
GUI 右側の [選択] 列で、モニターするパラメーターインスタンスをオンにし、[OK] をクリックします。選択したパラメーターは、負荷テスト進捗グラフおよび詳細レポートグラフに表示されます。

WebSphJBoss モニターの追加

Jboss モニターを追加するには、次の操作を行います。

負荷テストタブの [Monitors] ノードを右クリックし、ショートカットメニューの [新規 Monitor] をクリックします。[新規 Monitor] ダイアログが表示されます。
[新規 Monitor] ダイアログで JBoss を選択し、[終了] をクリックします。
プロジェクト設定パネルで [設定] をクリックします。[Configure JBoss Agent] ダイアログが開きます。
[Configure JBoss Agent] ダイアログで、ホスト名を入力し、必要に応じてポート番号を変更して [終了] をクリックします。[パラメーターの追加] ダイアログが開きます。
[パラメーターの追加] ダイアログの左側のパネルでパラメーターを選択します。[パラメーターの追加] ダイアログ右側のパネルに、表示する各パラメーターインスタンスの名前、説明、および値が表示されます。
右側の GUI パネルの [選択] 列で、モニターするパラメーターインスタンスを確認し、[OK] をクリックします。選択したパラメーターは、負荷テスト進捗グラフおよび詳細レポートグラフに表示されます。

Tomcat モニターの追加

このモニターを使用するには、以下の Java システムプロパティを指定して Tomcat を開始する必要があります。

-Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.port=7744
-Dcom.sun.management.jmxremote.ssl=false
-Dcom.sun.management.jmxremote.authenticate=false

Com.sun.management.jmxremote.port システムプロパティで、選択したポート番号を使用します。

たとえば、Windows であれば、catalina.bat Tomcat 起動スクリプトに以下の Java システムプロパティを追加することができます。

set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=7744 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false"

Tomcat が Windows サービスとしてインストールされている場合:

Tomcat9w.exe を起動します。
Apache Tomcat の [プロパティ] ウィンドウで [Java] タブをクリックします。
Java システムプロパティを [Java オプション] セクションに追加します。各 Java システムプロパティは、新しい行に配置する必要があります。

Tomcat モニターを追加するには、次の操作を行います。

負荷テストタブの Monitors ノードを右クリックし、ショートカットメニューから [新規 Monitors] を選択します。[新規 Monitor] ダイアログが表示されます。
[New モニター] ダイアログで Tomcat を選択し、[終了] をクリックします。
プロジェクト設定パネルで [設定] をクリックします。[Configure Tomcat Agent] ダイアログが開きます。
[Configure Tomcat Agent] ダイアログで、ホスト名を入力し、必要に応じてポート番号を変更して [終了] をクリックします。[パラメーターの追加] ダイアログが開きます。
[パラメーターの追加] ダイアログで、左側の GUI パネルからパラメーターを選択します。[パラメーターの追加] ダイアログ右側のパネルに、表示する各パラメーターインスタンスの名前、説明、および値が表示されます。
右側の GUI パネルの [選択] 列で、モニターするパラメーターインスタンスを確認し、[OK] をクリックします。選択したパラメーターは、負荷テスト進捗グラフおよび詳細レポートグラフに表示されます。

rstat モニターの追加

rstat モニターを追加するには、次の操作を行います。

負荷テストタブの Monitors ノードを右クリックし、ショートカットメニューから [新規 Monitors] を選択します。[新規 Monitor] ダイアログが表示されます。
[New モニター] ダイアログで rstat を選択し、[終了] をクリックします。

rstat モニターを有効にするには、djrpc.jar ファイルと rstatcl.jar ファイルを <INSTALL>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root ディレクトリにコピーし、クラスパスに追加します。

インストール時に rstatcl.jar ファイルを <INSTALL>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root ディレクトリに追加します。

djrpc.jar ファイルを購入して、<INSTALL>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root ディレクトリにコピーする必要があります。

リモート JVM モニターの追加

このモニターを使用するには、以下の Java システムプロパティを指定して JVM を開始する必要があります。

-Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.port=7744
-Dcom.sun.management.jmxremote.ssl=false
-Dcom.sun.management.jmxremote.authenticate=false

com.sun.management.jmxremote.port システムプロパティで任意のポートを使用します。

リモート JVM モニターを追加するには、次の操作を行います。

負荷テストタブを右クリックして Monitors ノードを選択し、ショートカットメニューから [新規 Monitors] を選択します。[新規 Monitor] ダイアログが表示されます。
[New モニター] ダイアログで Remote JVM を選択し、[終了] をクリックします。
プロジェクト設定パネルで [設定] をクリックします。[Configure Remote JVM Agent] ダイアログが開きます。
[ Configure Remote JVM Agent] ダイアログでホスト名を入力し、必要に応じてポート番号を変更してから、[終了] をクリックします。[パラメーターの追加] ダイアログが開きます。
[パラメーターの追加] ダイアログの左側のパネルでパラメーターを選択します。[パラメーターの追加] ダイアログ右側のパネルに、表示する各パラメーターインスタンスの名前、説明、および値が表示されます。
右側の GUI パネルの [選択] 列で、モニターするパラメーターインスタンスを確認し、[OK] をクリックします。選択したパラメーターは、負荷テスト進捗グラフおよび詳細レポートグラフに表示されます。

カスタムモニターの追加

カスタムモニターは、JavaScript スクリプト、Jython スクリプト、または Java クラスメソッドを使用して実装できます。カスタムモニターは、上記で挙げられていないソースからデータを収集するのに便利です。

負荷テストの進捗および詳細レポートのグラフに値をプロットするには、チャンネルメソッドが java.lang.Number 型を返す必要があります。

カスタムモニターを追加するには、次の操作を行います。

負荷テストタブの Monitors ノードを右クリックし、ショートカットメニューから [新規 Monitors] を選択します。[新規 Monitor] ダイアログが表示されます。
[New モニター] ダイアログで Custom を選択し、[終了] をクリックします。
[名前] フィールドでカスタムモニターの名前を入力します。
[新規] ボタンをクリックします。[チャンネルの追加] ダイアログが開きます。
[チャンネル ID] フィールドにチャンネルの名前を入力します。入力されたカスタムモニターの名前は、チャンネル ID とともに、モニターのタイトルとなります。このタイトルは、負荷テスト進捗グラフおよび詳細レポートグラフに表示されます。
(オプション) [説明] フィールドにチャンネルの簡単な説明を入力します。
[言語] メニューから言語を選択します。
以下のどちらかの方法でスクリプトを指定します。
- [ファイル] ラジオボタンを選択し、[参照] ボタンをクリックして適切なファイルを選択します。
- [テキスト] ラジオボタンを選択し、テキストフィールドにスクリプトを入力します。
[メソッド] メニューから呼び出すメソッドを指定します。
[OK] をクリックします。GUI 右側の [チャンネル] テーブルに新規カスタムチャンネルが追加されます。

ビルトインモニターの変更

モニターを作成した後、次のビルトインモニターの Apply Operation パラメーターを設定または変更することができます。

Windows
JBoss
Tomcat
リモート JVM
SNMP

オペレーションを変更するには、モニター設定ビューのパラメーターパネルでモニターチャネルをダブルクリックし、適切なオペレーションタイプおよび値を設定します。

SOAtest and Virtualize with CTP 2022.2 (Japanese) > Using Monitors > ProjectConfiguration.png

デプロイ済みモニターの追加

Load Test に動的にモニタータイプを追加できます。デプロイされたモニターは、パフォーマンスモニターウィザードの [デプロイ済みモニタータイプ] テーブルに表示されます。

AppDynamics

AppDynamics モニターの追加

AppDynamics モニターを追加するには、次の操作を行います。

負荷テストタブの Monitors ノードを右クリックし、ショートカットメニューから [新規 Monitors] を選択します。[新規 Monitor] ダイアログが表示されます。
[新規 Monitor] ダイアログの [デプロイされたモニターのタイプ] から AppDynamicsMonitor を選択し、[完了] をクリックします。
[プロジェクト構成] パネルの右上にある [プロパティ] ボタンをクリックして、AppDynamics のプロパティを設定します。
- ホスト – AppDynamics サーバーがインストールされているホスト。
- ポート – AppDynamics が REST 呼び出しをリッスンするポート。
- ユーザー名 – REST 呼び出し認証のユーザー名。
- パスワード – REST 呼び出し認証のパスワード。
- クエリ間隔 (分) – モニター値が平均化される分単位の時間。最小値は 1 です。
[OK] をクリックして、プロパティ値をプロジェクトに保存します。
AppDynamics モニターにチャンネルを追加するには、次の操作を行います。
1. [プロジェクト構成] タブの [デプロイ済みモニター] パネルにある [新規] ボタンをクリックします。モニターチャンネル選択ダイアログが表示されます。モニターチャンネルツリーの最上位ノードは、AppDynamics によってモニターされるアプリケーションです。
2. 最上位のアプリケーションノードを展開し、チェックボックスの付いたチャンネルのノードを表示します。
3. モニター対象のアイテムがオンになっていることを確認します。
4. [OK] をクリックして、選択したノードを [デプロイ済みモニター] 構成パネルのパラメーターテーブルに追加します。選択したパラメーターは、負荷テストの進捗グラフと詳細レポートグラフに表示されます。

[プロパティ] ダイアログを開き、[OK] ボタンをクリックして、モニターチャンネルの選択のツリーをリセットします。モニターチャンネルツリーは、AppDynamics から提供されたデータに基づいて最上位のアプリケーションノードを表示します。ツリーの展開アイコン「+」をクリックすると、AppDynamics に送信されたクエリーに基づいて、子ノードが動的に構築されます。

AppDynamics モニター拡張からのデータをモニターする

AppDynamics Exchange サイトは、さまざまなモニター拡張を提供します。AppDynamics Metric Browser で利用可能なモニター拡張データが、Load test AppDynamics モニターで利用できます。

下のスクリーンショットは、AppDynamics Exchange から入手できる「Static」モニター拡張のデータを表示した AppDynamics Metric Browser ビューおよび Load Test AppDynamics モニターチャンネル選択ビューを示しています。

AppDynamics の Custom FileContentMetric:

SOAtest and Virtualize with CTP 2022.2 (Japanese) > Using Monitors > FileContentMetric.jpg

Load Test AppDynamics Monitor: の Custom FileContentMetric

Dynatrace

Dynatrace モニターの追加

Dynatrace モニターを追加するには、次の操作を行います。

負荷テストタブの Monitors ノードを右クリックし、ショートカットメニューから [新規 Monitors] を選択します。[新規 Monitor] ダイアログが表示されます。
[新規 Monitor] ダイアログの [デプロイされたモニターのタイプ] から DynatraceMonitor を選択し、[完了] をクリックします。
[プロジェクト構成] パネルの右上にある [プロパティ] ボタンをクリックして、Dynatrace のプロパティを設定します。
- ホスト – Dynatrace サーバーがインストールされているホスト。
- ポート – Dynatrace が REST 呼び出しをリッスンするポート。デフォルトのポートは 8020 です。詳細については Dynatrace のマニュアルを参照してください。
- ユーザー名 – REST 呼び出し認証のユーザー名。
- パスワード – REST 呼び出し認証のパスワード。
[OK] をクリックして、プロパティ値をプロジェクトに保存します。
Dynatrace モニターにチャンネルを追加するには、次の操作を行います。
1. [プロジェクト構成] タブの [デプロイ済みモニター] パネルにある [新規] ボタンをクリックします。モニターチャンネル選択ダイアログが表示されます。
2. 最上位のアプリケーションノードを展開し、チェックボックスの付いたチャンネルのノードを表示します。
3. モニター対象のアイテムがオンになっていることを確認します。
4. [OK] をクリックして、選択したノードを [デプロイ済みモニター] 構成パネルのパラメーターテーブルに追加します。選択したパラメーターは、負荷テストの進捗グラフと詳細レポートグラフに表示されます。

モニターチャンネル選択ビューツリーは以下のように構築されます。

レベル 1: Dynatrace ダッシュボード
- レベル 2: ダッシュボード内の Chart Dashlet
  - レベル 3: Chart Dashlet 内の Measure
    - レベル 4: Measure の Min/Max/Avg 値

既存の Line Chart タイプの Chart Dashlet をモニターするか、新しい Chart Dashlet を作成できます。Chart Dashlet に複数の Measure (データ系列) を追加できます。詳細については、Dynatrace のマニュアルを参照してください。

[プロパティ] ダイアログを開き、[OK] ボタンをクリックして、モニターチャンネルの選択のツリーをリセットします。モニターチャンネルツリーは、Dynatrace から提供されたデータに基づいて最上位のアプリケーションノードを表示します。ツリーの展開アイコン「+」をクリックすると、Dynatrace に送信されたクエリーに基づいて、子ノードが動的に構築されます。

Dynatrace の REST クエリーレスポンスサイズに関する注意事項

Chart や Dashboard の構成によっては、Dynatrace の REST レスポンスのサイズは、非常に大きくなる場合があります (100KB 以上)。

Dynatrace の REST クエリーレスポンスのサイズを最小限にするには、以下のことに気を付けます。

Load Test によってモニターされるダッシュボードのチャートで、Chart ビュー右上隅の Char コントロールパネルを以下のように設定します。
- Select Timeframe: 「last 5 minutes」に設定します。
- Select Chart Resolution: 「10s」に設定します。
上のスクリーンショットに表示されている右クリックメニューの [Apply to Dashboard] をクリックし、この設定をダッシュボード内のすべてのチャートに適用します。
Load Test Dynatrace モニターによって使用されるダッシュボードの REST クエリーレスポンスサイズを見積もるには、次の URL テンプレート (ホスト、ポート、およびダッシュボード名を環境に合わせて変更します) を使用し、ブラウザーでクエリー結果を開きます: http://dynatrace.parasoft.com:8020/rest/management/dashboard/your_dashboard_name

Dynatrace プラグインのデータをモニターする

Dynatrace の「PLUGIN CENTRAL」サイトおよび「Community Plugins and Extensions」サイトには多数のプラグインがあり、その多くを使用して Dynatrace のモニター機能を簡単に拡張できます。Chart Dashlet に Measure として追加された Dynatrace プラグインのデータは、Load Test Dynatrace モニターで利用可能です。

下のスクリーンショットは、「Community Plugins and Extensions」サイトで入手できる StockQuote サンプルモニタープラグインが Dynatrace Chart Dashlet の Measure に追加されたところと、 Load Test Dynatrace モニターチャンネル選択画面に表示されたところを示しています。

Dynatrace のカスタム StockQuote Measure:

SOAtest and Virtualize with CTP 2022.2 (Japanese) > Using Monitors > Measure.png

Load Test Dynatrace モニターのカスタム StockQuote チャンネル:

JVM スレッド

リモート JVM スレッドモニターの追加

JVM スレッドモニターを使用すると、スレッド統計を参照できるほか、Java の JMX 技術を使用して、リモート Java アプリケーションの個々のスレッドの詳細を記録できます。

このモニターを使用するには、以下の Java システムプロパティを指定して JVM を開始し、JMX モニタリングを有効化する必要があります。

-Dcom.sun.management.jmxremote 
-Dcom.sun.management.jmxremote.port=7744 
-Dcom.sun.management.jmxremote.ssl=false 
-Dcom.sun.management.jmxremote.authenticate=false

com.sun.management.jmxremote.port system システムプロパティで、選択したポート番号を使用します。

リモート JVM スレッドモニターを追加するには、次の操作を行います。

負荷テストタブの [Monitors] ノードを右クリックし、ショートカットメニューの [新規 Monitor] をクリックします。
[新規 Monitor] ダイアログの [デプロイされたモニタータイプ] テーブルから [JVMThreadsMonitor] を選択し、[終了] をクリックします。

プロジェクト設定パネルの右上隅にある [プロパティ] ボタンをクリックし、JVMThreadsMonitor プロパティを設定します。

SOAtest and Virtualize with CTP 2022.2 (Japanese) > Using Monitors > config-jvm-thread-mon.png

SOAtest and Virtualize with CTP 2022.2 (Japanese) > Using Monitors > config-jvm-thread-mon.png

ホスト: JVM が実行されているホスト名
ポート: JVM の JMX ポート (「JVX モニタリングの有効化」を参照)
スレッドフィルター: 文字列のカンマ区切りリストです。スレッド名にリスト内の文字列が含まれる場合、スレッドはモニターによって処理されます。スレッド名の比較は大文字/小文字を区別しません。(フィルターは、モニターがリモート JVM プロセスからすべての利用可能なスレッドデータを受信した後に適用されます)
スレッドダンプモード: 詳細な分析の対象とするためにダンプするスレッドの状態をカンマ区切りで記述したリストです。詳細については「Taking Selective Thread Dumps」を参照してください。

スレッドダンプディレクトリ: スレッドダンプが出力されるディレクトリのパスです。詳細については「Taking Selective Thread Dumps」を参照してください。

JVM スレッドモニターを追加したことによるパフォーマンスへの影響は、jvisualvm Java パフォーマンス診断およびモニタリングツールを使用した場合と同様です。たいていの場合、影響は無視できる程度ですが、Load Test プロジェクトに JVM スレッドモニターを適用する前後で、CPU 使用率、平均レスポンス時間、最大レスポンス時間など、AUT のキーパフォーマンス指標を使用して評価することを推奨します。

[OK] をクリックして、プロパティ値をプロジェクトに保存します。
JVM スレッドモニターにチャンネルを追加するには、次の操作を行います。
1. プロジェクト設定タブの [デプロイ済みモニター] パネルで [新規] ボタンをクリックします。モニターチャンネル選択ダイアログが表示されます。
2. モニターするチャンネルを有効化します。チャンネル選択ダイアログの説明列にチャンネルの詳細が表示されています。

SOAtest and Virtualize with CTP 2022.2 (Japanese) > Using Monitors > select-mon-channels-jvm-thread-mon.png

チャンネルの説明について

TotalThreads	フィルター済みスレッド数です。
RunningThreads	RUNNABLE ステータスのフィルター済みスレッド数です。
BlockedThreads	同期ステートメントまたはメソッドの処理を待機している BLOCKED ステータスのフィルター済みスレッド数です。
ParkedThreads	`LockSupport.park()` の呼び出しのために parked ステータスにあるフィルター済みスレッド数です。
SleepingThreads	`Thread.sleep()` メソッド内にあるフィルター済みスレッド数です。
WaitingThreads	`Object.wait()` メソッドで通知を待機しているフィルター済みスレッド数です。
NewThreads	まだ開始されていないスレッド数です。
UnknownThreads	unknown ステータスのスレッド数です。
DeadlockedThreads	1 つのロックを保持していながら、すでに他のスレッドが保持している別のロックを獲得しようとしているスレッドです。このチャンネルは、`java.util.concurrent.locks.ReentrantLock` や `java.util.concurrent.locks.ReentrantReadWriteLock` など、オブジェクトモニターおよび所有可能なシンクロナイザーの両方が関係するロックを発見します。
MonitorDeadlockedThreads	1 つの同期モニターを保持していながら、すでに他のスレッドが保持している別のモニターを獲得しようとしているスレッドです。このメソッドは、オブジェクトモニターが関係するデッドロックだけを発見します。
BlockedTime	Load Test のデータ収集間隔期間内にフィルター済みスレッドが BLOCKED ステータスだった時間の概算をミリ秒単位で表示します。
BlockedRatio	フィルター済みスレッドが BLOCKED ステータスだった時間の概算を割合で表示します。
BlockedCount	フィルター済みスレッドが BLOCKED ステータスになった回数です。
WaitedTime	フィルター済みスレッドが WAITING または TIMED_WAITING ステータスだった時間の概算をミリ秒単位で表示します。
WaitedRatio	フィルター済みスレッドが WAITING または TIMED_WAITING ステータスだった時間の概算を割合で表示します。
WaitedCount	フィルター済みスレッドが WAITING または TIMED_WAITING ステータスになった回数です。

モニターチャンネルから返されたすべてのデータは、最後の Load Test データ収集間隔に関連付けられます。

NEW、RUNNABLE、BLOCKED、WAITING、TIMED_WAITING、TERMINATED は java.lang.Thread クラスの State 列挙型のステータスです。

JVM スレッドステータスの詳細については、関連する Java クラスの Java ドキュメントを参照してください。

java.lang.management.ThreadInfo:
https://docs.oracle.com/javase/8/docs/api/java/lang/management/ThreadInfo.html
java.lang.managementThreadJMXBean:
https://docs.oracle.com/javase/8/docs/api/java/lang/management/ThreadMXBean.html

初期化時、JMX スレッドモニターは、リモート JVM でスレッド競合モニタリングが有効化されているかをチェックします。競合モニタリングが無効化されている場合、JMX スレッドモニターはモニタリングを有効化しようとします。試みが失敗した場合、BlockedTime、BlockedRatio、WaitedTime および WaitedRatio チャンネルは値としてゼロを返します。

選択的スレッドダンプの取得

JMX スレッドモニターでは、リモートアプリケーションのスレッドのダンプを選択的に取得し、後で解析するためにディスクに保存することができます。この機能を利用すると、散発的に発生する望ましくないスレッドステータスを捕捉したり、自動化された負荷テスト実行中にスレッドのステータスを記録することができます。

JMX スレッドモニターは、負荷テストが実行されているときにだけスレッドをダンプします。モニター設定ビューで [リクエストの送信] をクリックしても、スレッドダンプは取得されません。

選択的スレッドダンプを設定するには、次のモニタープロパティを指定します。

スレッドフィルター

スレッドフィルターに一致するスレッドだけかダンプされます。

スレッドダンプモード

次の値が利用可能です。

ALL: すべてのスレッドをダンプします。
NONE または空: スレッドダンプを作成しません。
DEADLOCKED: デッドロックしたスレッドをダンプします。
BLOCKED: ブロックされたステータスのスレッドをダンプします。
PARKED: park されたスレッドをダンプします。

このプロパティが設定されていない場合 (空の場合)、スレッドダンプは取得されません。

複数のスレッドステータスのダンプを設定するには、値のリストをカンマ区切りで入力します。DEADLOCKED, BLOCKED, PARKED

スレッドダンプディレクトリ

絶対パス、または次の SOAtest/LoadTest インストールディレクトリ内のディレクトリへの相対パスを入力できます。

<INSTALL>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root

このプロパティが設定されていない場合 (空の場合)、スレッドダンプは取得されません。

この設定で指定されたパスは、スレッドダンプのルートとして使用されます (「Examining Thread Dumps」を参照)。

スレッドダンプの確認

スレッドダンプディレクトリ設定で指定されたパスは、スレッドダンプのルートとして使用されます。JVM スレッドモニターは、負荷テスト実行のたびに、スレッドダンプルートの下に個々のプロジェクトスレッドダンプディレクトリを作成します。それらのプロジェクトスレッドダンプディレクトリは、次のパターンに従って命名されます。PROJECTNAME_YYYY-MM-DD_hh-mm-ss

PROJECTNAME: LoadTest プロジェクトの名前です。
YYYY: 現在年
MM: 現在月
DD: 現在日
hh: 24 時間書式の時間
mm: 分
ss: 秒

この書式によって、スレッドダンプがどの Load Test プロジェクトのものか、またいつ作成されたが明確に分かります。負荷テスト実行時にモニターがスレッドダンプ設定に一致するスレッドダンプを発見できなかった場合は、PROJECTNAME_YYYY-MM-DD_hh-mm-ss ディレクトリは作成されません。

モニターはプロジェクトスレッドダンプディレクトリ内に次の命名パターンに従ってスレッドダンプファイルを作成します。S..S_hh-mm-ss.txt

S..S: スレッドダンプが取得された負荷テスト実行開始時からの経過時間を秒単位で表します。
hh-mm-ss: スレッドダンプが取得された時点のシステム時間です。
- hh: 24 時間書式の時間
- mm: 分
- ss: 秒

各スレッドダンプファイルには、モニターが取得した 1 つ以上のスレッドスタックトレースが含まれます。スレッドスタックトレースのフォーマットは次のとおりです。

THREAD_STATE thread: THREAD_NAME
      thread_stack_entries

各 BLOCKED スレッドの後にこれをブロックしているスレッドのスタックトレースが表示されます。BLOCKED スレッドの出力のフォーマットは次のとおりです。

THREAD_STATE thread: THREAD_NAME
      thread_stack_entries
      ------------------
      Blocked by:      
      BLOCKING_THREAD_STATE thread: THREAD_NAME
            blocking_thread_stack_entries

例:

BLOCKED thread: Clinet Rec: LTPub_0.4104694862292172
    com.acme.connections.ClientComms.isDisconnecting:561
    ...
    java.util.concurrent.ThreadPoolExecutor$Worker.run:617
    java.lang.Thread.run:745
    ------------------
    Blocked by:
    PARKED thread: acme_pool-2-UserCodeRunnable-135
        sun.misc.Unsafe.park:-2
        java.util.concurrent.locks.LockSupport.parkNanos:215
        java.util.concurrent.locks.AbstractQueuedSynchronizer$ConditionObject.awaitNanos:2078
        java.util.concurrent.ThreadPoolExecutor.awaitTermination:1465
        ....

スレッドダンプと Load Test レポートのグラフポイントの対応

Load Test レポートグラフ内の特定のポイントのスレッドダンプを発見するには、次の操作を行います。

Load Test レポートグラフのポイントにマウスカーソルを位置づけます。
ツールチップに表示された経過時間またはシステム時間を参考に、一番近い経過時間またはシステム時間を持つダンプファイルを探します。

たとえば、次の画面ショットでハイライトされたグラフポイントのスレッドダンプファイルは 3_10-37-37.txt ファイルとなります。

モニターのクエリー

モニターにパラメーターを追加すると、クエリーが可能になります。

クエリーを送信するには、次の操作を行います。

クエリーを送信するモニターを表す負荷テストツリーノードを選択します。
モニター設定パネルのレスポンスビューエリアにある [リクエストの送信] ボタンをクリックします。

モニター設定パネルのレスポンスビューエリアにクエリー結果が表示されます。

モニターのステータスの検証

負荷テストツリーでは、丸印の色によって各モニターのステータスが表されます。次の色が使用されます。

白: 未チェック
緑: すべてのパラメーターが利用可能です。
黄: 一部のパラメーターが利用できないか、値が数値ではありません。
赤: モニターが利用できないか、到達できません。

1 つまたは複数のモニターの現在のステータスを確認するには、次の操作を行います。

検証するモニターを表す負荷テストツリーノード ([Monitors] ノード、[Windows] ノード、[SNMP] ノード、[カスタム] ノード、または個々のモニターを表すノード) を右クリックします。
ショートカットメニューの [検証] をクリックします。

テストスイート負荷テスト中の振る舞いをモニター

負荷テストツリーに追加したモニターは、テストスイート負荷テスト中も使用されます。

モニターを使用する負荷テストを実行している間、負荷テスト進捗パネルの [グラフ] タブには、各モニターを表す棒が追加されます。[グラフ] タブは、モニターから収集されたデータを表示します。棒の名前は、パラメーター ID の OID 番号ではなく、モニターのグラフタイトルの値に基づきます。

モニター結果へのアクセス

負荷テスト中に収集されたモニターデータは、詳細レポートに保存され、デフォルトデータ (「仮想ユーザー数」など) とともに、あるいはデフォルトデータと関連付けて参照することができます。