レポート・カウンターの自動エクスポートの構成

コマンド・ライン・インターフェース (CLI) からテストまたはスケジュールを実行する場合、自動的にレポートをエクスポートするように、IBM® DevOps Test Performance (Test Performance) を構成することができます。

  1. Test Performanceを開きます。
  2. 「ウィンドウ (Windows)」 > 「設定」 > 「テスト」 > 「パフォーマンス・テスト・レポート」 > 「レポートのエクスポート」をクリックします。
  3. 「レポートのエクスポート」ウィンドウで、以下の操作を行います
    オプション アクション
    コマンド・ライン

    このチェック・ボックスを選択すると、コマンド・ライン・インターフェースからテストまたはスケジュールを実行すると、テストの実行完了した後にレポートがエクスポートされます。 レポートはエクスポートされた結果データディレクトリーに保存されます。 このレポートは、「テスト・ナビゲーター」ペインからアクセスできます。

    レポートはまた結果ディレクトリーに保存されます。 「結果」ディレクトリーには、ワークスペースの場所に移動するとアクセスできます。

    例: C:\Users\username\IBM\devopstest\workspace_name\project_name\Results

    「コマンド・ライン」オプションを選択すると、「単純 CSV レポートをコマンド・ラインに出力」オプションも選択できます。 これらの 2 つのオプションを選択すると、 -stdout パラメーターを使用した場合、コマンド・ライン・インターフェースでエクスポートされたデータを表示できます。 その他の場合、レポート情報は CommandLineLog.txt ファイルに出力されます。 このファイルには、以下のパスからアクセスできます。

    C:\Users\username\AppData\Local\Temp\CommandLineLog.txt
    注:
    コマンド・ラインの設定は、Test Performance の設定に優先します。

    「コマンド・ライン」オプションと「単純 CSV レポートをコマンド・ラインに出力」オプションを選択したと想定します。 次に、コマンド・ライン・インターフェースから -exportstats または -exportstatsformat のパラメーターを使用して、テストまたはスケジュールを実行します。 このシナリオでは、-exportstats パラメーターで指定されたパスにレポートがエクスポートされます。

    ワークベンチ

    Test Performanceからテストまたはスケジュールを実行したときに、テスト実行完了後にレポートをエクスポートするには、このチェックボックスを選択します。レポートはエクスポートされた結果データディレクトリーに保存されます。 このレポートは、「テスト・ナビゲーター」ペインからアクセスできます。

    レポートはまた結果ディレクトリーに保存されます。 「結果」ディレクトリーには、ワークスペースの場所に移動するとアクセスできます。

    例: C:\Users\username\IBM\devopstest\workspace_name\project_name\Results

    シンプル (各カウンター、各時間範囲に 1 つの値)

    このチェック・ボックスを選択し、ドロップダウン・リストからレポートの形式を選択して、シンプルなレポートをエクスポートします。

    ドロップダウン・リストから CSV または JSON を選択できます。

    すべての時間帯を表示する

    このチェックボックスを選択すると、すべての時間範囲のデータを含めることができます。 含まれるデフォルトの時刻範囲はEntire Runです。

    フル (各カウンター、各サンプル間隔に 1 つの値)

    このチェック・ボックスを選択し、ドロップダウン・リストからレポートの形式を選択して、結果名、ノード名、時間範囲を含む包括的なレポートをエクスポートします。 通常、特定のテスト実行のカウンターを含むカスタマイズされたレポートをエクスポートしない限り、このような詳細情報は含まれません。

    ドロップダウン・リストから CSV または JSON を選択できます。

    カウンター数があふれる場合には出力を分割

    このチェック・ボックスを選択して値を指定すると、エクスポートされたファイルのカウンター数が指定した値を超えた場合に、複数の CSV ファイルまたは JSON ファイルが作成されます。

    インスタンスごとのカウンターを含める

    各ページのカウンターの詳細データを含めるには、このチェック・ボックスを選択してください。

    各エージェントを個別にエクスポート

    このチェック・ボックスを選択すると、エクスポートされた CSV ファイルや JSON ファイルのデータを、テストの実行中に使用されたエージェント別にグループ化することができます。

    エージェントごとに 1 ファイル

    データをエージェント別にグループ化して個別の CSV または JSON ファイルにまとめるには、このチェック・ボックスを選択します。

    注:
    「エージェントごとに 1 ファイル」オプションは、「各エージェントを個別にエクスポート」オプションが選択されている場合にのみ使用可能です。
    ファイル名の形式

    エクスポートされたファイルのファイル名の形式をドロップダウン・リストから選択します。 次のオプションのいずれかをドロップダウン・リストから選択できます。

    • 9.0 より前のリリース: このオプションを選択すると、エクスポートされたレポート・ファイル名が [REPORT_NAME][AGENT_NAME][SPLIT_INDEX] という形式で保存されます。

    • 9.0 リリース: このオプションを選択すると、エクスポートされたレポート・ファイル名が[TEST_NAME][AGENT_NAME][SPLIT_INDEX]_[TIME_STAMP]_[REPORT_ID]_[EXPORT_TYPE]という形式で保存されます。

    • カスタム・パターン: このオプションを選択すると、エクスポートされたレポート・ファイルを保存したいパターンを指定できます。

    HTMLレポート

    このチェック・ボックスを選択すると、フル・レポート・データが HTML 形式でエクスポートされます。

    エグゼクティブ・サマリー・レポート

    エグゼクティブ・サマリー・レポートを HTML 形式でエクスポートするには、このチェック・ボックスを選択してください。 ドロップダウン・リストから選択したレポートでは、テストまたはスケジュールの実行状態が要約され、1 ページに HTML 形式で表示されます。 このレポートを出力できます。

    「エグゼクティブ・サマリー・レポート」「結果」ディレクトリーに保存されます。 「結果」ディレクトリーには、ワークスペースの場所に移動するとアクセスできます。

    例: C:\Users\username\IBM\devopstest\workspace_name\project_name\Results

    エクスポートするレポートの選択

    レポートを CSV、JSON、HTML のいずれかの形式でエクスポートするには、リストで必要なレポートのチェック・ボックスを選択してください。

    1 つ以上のレポートを選択した場合、各レポートは「エクスポート済み結果データ (Exported Results Data)」ディレクトリーに個別の CSV または JSON のファイルとしてエクスポートされます。 このレポートは、「テスト・ナビゲーター」ペインからアクセスできます。

    各レポートの ID を表示するには、「レポート ID の表示」チェック・ボックスを選択します。 この ID は、コマンド・ライン・インターフェースから特定のレポートをエクスポートする際に使用されます。

  4. 「適用して閉じる」をクリックします。
テスト・レポートを CSV または JSON ファイルに自動的にエクスポートするために、Test Performance を構成しました。