14. レポート ダッシュボードの生成¶

14.1 概要¶

ダッシュボード ジェネレーターは、JMeter のモジュラー拡張です。そのデフォルトの動作は、CSV ファイルからサンプルを読み取って処理し、グラフ ビューを含む HTML ファイルを生成することです。負荷テストの終了時またはオンデマンドでレポートを生成できます。

このレポートは、次の指標を提供します。

• APDEX (アプリケーション パフォーマンス インデックス) テーブルは、許容されるしきい値と満たされるしきい値の構成可能な値に基づいて、トランザクションごとに APDEX を計算します。
• 成功したリクエストと失敗したリクエスト (Transaction Controller のサンプル結果は考慮されていません) のパーセンテージを示すリクエスト概要グラフ:

  

• 構成可能な 3 つのパーセンタイルを含む、トランザクションごとのすべてのメトリックの概要を 1 つのテーブルに提供する統計テーブル:

  

• すべてのエラーの概要と、リクエスト全体に占める割合を示すエラー テーブル:

  

• すべてのサンプラー (デフォルトではトランザクション コントローラーを除く) の上位 5 つのエラーを提供する、サンプラーごとの上位 5 つのエラー テーブル:

  

• すべてのトランザクションをチェック/チェック解除して表示/非表示にできるズーム可能なチャート:
  • 経時的な応答時間 (Transaction Controller のサンプル結果を含む) :

    

  • 一定期間にわたる応答時間のパーセンタイル (成功した応答のみ) :

    

  • アクティブなスレッドの推移:

    

  • 経時的なバイト スループット (Transaction Controller のサンプル結果を無視) :

    

  • 時間の経過に伴うレイテンシ (Transaction Controller のサンプル結果を含む) :

    

  • Connect Time Over Time (Transaction Controller のサンプル結果を含む) :

    

  • 1 秒あたりのヒット数 (トランザクション コントローラーのサンプル結果を無視):

    

  • 1 秒あたりの応答コード (トランザクション コントローラーのサンプル結果を無視):

    

  • 1 秒あたりのトランザクション数 (トランザクション コントローラーのサンプル結果を含む):

    

  • 応答時間と 1 秒あたりの要求 (トランザクション コントローラーのサンプル結果を無視):

    

  • レイテンシと 1 秒あたりのリクエスト (トランザクション コントローラーのサンプル結果は無視):

    

  • 応答時間の概要 (Transaction Controller のサンプル結果を除く) :

    

  • 応答時間のパーセンタイル (Transaction Controller のサンプル結果を含む):

    

  • 時間とスレッド (トランザクション コントローラーのサンプル結果を含む):

    

    分散モードでは、このグラフは横軸に 1 サーバーのスレッド数を示します。現在の制限です
  • 応答時間の分布 (Transaction Controller のサンプル結果を含む):

    

14.2 ダッシュボード生成の設定¶

ダッシュボードの生成では、JMeter プロパティを使用してレポートをカスタマイズします。一般的な設定に使用されるプロパティもあれば、特定のグラフ構成またはエクスポータ構成に使用されるプロパティもあります。

jmeter.reportgenerator.exporter.html.series_filter=^(検索|順序)(-成功|-失敗)?$

jmeter.save.saveservice.bytes = true
# HttpClient4 でのみ利用可能
#jmeter.save.saveservice.sent_bytes=true
jmeter.save.saveservice.label = true
jmeter.save.saveservice.latency = true
jmeter.save.saveservice.response_code = true
jmeter.save.saveservice.response_message = true
jmeter.save.saveservice.successful = true
jmeter.save.saveservice.thread_counts = true
jmeter.save.saveservice.thread_name = true
jmeter.save.saveservice.time = true
jmeter.save.saveservice.connect_time = true
jmeter.save.saveservice.assertion_results_failure_message = true
# タイムスタンプ形式には時刻と日付を含める必要があります。
# たとえば、エポックからのミリ秒単位のデフォルト:
jmeter.save.saveservice.timestamp_format = ミリ秒
# または、以下も適しています
# jmeter.save.saveservice.timestamp_format = yyyy/MM/dd HH:mm:ss
                        

jmeter.reportgenerator.

jmeter.reportgenerator.apdex_per_transaction=sample(\\d+):1000|2000;\
    samples12:3000|4000;\
    シーン01-12:5000|6000

jmeter.reportgenerator.

jmeter.reportgenerator.graph.

jmeter.reportgenerator.graph.<graph_id>.property

jmeter.reportgenerator.graph.<graph_id>.property.set_granularity=150

jmeter.reportgenerator.exporter

jmeter.reportgenerator.exporter.<exporter_id>.property

jmeter.reportgenerator.exporter.<exporter_id>.graph_options.<graph_id>

# レポートのタイトルを変更するには、このプロパティを構成します
#jmeter.reportgenerator.report_title=Apache JMeter ダッシュボード

# 経時グラフの粒度を変更する場合は、このパラメーターを変更します。
# 粒度は 1000 (1 秒) より大きくする必要があります。そうしないと、スループット グラフが正しくなくなります
# バグ 60149 を参照
#jmeter.reportgenerator.overall_granularity=60000

 応答時間の分布の粒度を変更する場合は、このパラメーターを変更します
# デフォルトで 100 ミリ秒に設定
#jmeter.reportgenerator.graph.responseTimeDistribution.property.set_granularity=100

# APDEX 満足度しきい値をオーバーライドする場合は、このパラメーターを変更します。
jmeter.reportgenerator.apdex_satisfied_threshold=1500

# APDEX 許容しきい値をオーバーライドする場合は、このパラメーターを変更します。
jmeter.reportgenerator.apdex_tolerated_threshold=3000

# 生成された html ページの宛先ディレクトリを設定します。世代ごとに変更することをお勧めします
# これにより、-o コマンド ライン オプションで設定された値が上書きされます
# jmeter.reportgenerator.exporter.html.property.output_dir=/tmp/test-report

# どのグラフ系列がフィルタリングされているかを示します (正規表現)
# 以下の例では、検索と注文のサンプルをフィルタリングします
# パターンの最後には常に (-success|-failure)?$ を含める必要があることに注意してください
# 1 秒あたりのトランザクション数のサフィックス トランザクションに応じて「-success」または「-failure」
# 結果について
#jmeter.reportgenerator.exporter.html.series_filter=^(検索|順序)(-成功|-失敗)?$

# シリーズ フィルターがサンプル シリーズのみに適用されるかどうかを示します
jmeter.reportgenerator.exporter.html.filters_only_sample_series=true
                    

14.3 レポートの生成¶

レポートの生成は、サンプル ログ ファイルからスタンドアロン プロセスとして実行することも、負荷テストの実行後に自動的に実行することもできます。

jmeter -g <ログ ファイル> -o <出力フォルダへのパス>

jmeter -n -t <テスト JMX ファイル> -l <​​テスト ログ ファイル> -e -o <出力フォルダーへのパス>

14.3.3 GUI ツールメニューを利用した生成¶

メニュー項目Tools → Generate HTML report を使用して、HTML レポートを生成できます。

各パラメータについては、次の表を参照してください。

出力ディレクトリが定義されていない場合、コントローラーは${JMETER_HOME}/bin/report-outputを使用します。

次に、[レポートの生成] ボタンをクリックして、情報ダイアログが表示されるのを待つ だけです。

14.4 デフォルトのグラフ¶

このレポート エンジンによって提供されるすべてのグラフは、パッケージ org.apache.jmeter.report.processor.graph.implにあります。

ダッシュボード ジェネレーターには、次のグラフ クラスが用意されています。

14.5 経時的な税関グラフの生成¶

CSV の任意の sample_variable を経時的にグラフ化できます。user.properties ファイルでプロパティを設定することにより、グラフをカスタマイズできます。
ID プレフィックスcustom_を使用する必要があります。

jmeter.reportgenerator.graph.custom_<your_graph_name_id>.property.<your_option_name>

jmeter.reportgenerator.graph.custom_<your_graph_name_id>.classname=org.apache.jmeter.report.processor.graph.impl.CustomGraphConsumer

変数ts-hitをグラフ化するカスタム グラフ構成の例を次に示します。

jmeter.reportgenerator.graph.custom_testGraph.classname=org.apache.jmeter.report.processor.graph.impl.CustomGraphConsumer
jmeter.reportgenerator.graph.custom_testGraph.title=チャンクヒット
jmeter.reportgenerator.graph.custom_testGraph.property.set_Y_Axis=ヒット数
jmeter.reportgenerator.graph.custom_testGraph.set_X_Axis=経過時間
jmeter.reportgenerator.graph.custom_testGraph.property.set_granularity=60000
jmeter.reportgenerator.graph.custom_testGraph.property.set_Sample_Variable_Name=ts-hit
jmeter.reportgenerator.graph.custom_testGraph.property.set_Content_Message=ヒット数:
                        

14.6 レポートダッシュボードを改善したいですか? ¶