「[[マイクロソフト系技術情報 Wiki>http://techinfoofmicrosofttech.osscons.jp/]]」は、「[[Open棟梁Project>https://github.com/OpenTouryoProject/]]」,「[[OSSコンソーシアム .NET開発基盤部会>https://www.osscons.jp/dotNetDevelopmentInfrastructure/]]」によって運営されています。
-[[戻る>JmeterによるWebアプリの負荷テスト]]
* 目次 [#h4c20eca]
#contents
*概要 [#w92cb6d0]
負荷テスト結果のレポーティング方法
*リスナーの設定 [#ke454a78]
ここでは、[[各種レポーティング用のリスナー>Jmeter用語#h6cb67cf]]の設定を行うが、~
-リソースの消費量が大きい、~
[[機能テスト、デバッグ・検証用のリスナー>Jmeter用語#ke3512f6]]の設定を変更し、
-また、[[負荷テストのレポート用のリスナー>Jmeter用語#nce1569e]]を追加する。
**リスナーの変更 [#e8691ab1]
[[スクリプトのデバッグ時>JmeterによるWebアプリの負荷テスト#p9714be2]]に追加した[[リスナー>Jmeter用語#ke3512f6]]の設定を変更する。
***[[「結果を表で表示」リスナー>Jmeter用語#ke3512f6]] [#t8786394]
無効化する。
***[[「結果をツリーで表示」リスナー>Jmeter用語#ke3512f6]] [#m8b7bd3e]
「エラーログ(XML)」の出力を構成する。
-ファイル名~
time関数を使用して、以下のように指定（フルパス）。
"...\XXXXシナリオ・エラーログ_&{__time(YMDHMS)}.jlt"
-「エラーログのみ」にチェックを入れる。
-config（[[Sample Result Save Configurationの出力項目>#y3f415ef]]を設定）
--configボタンを押下して、
--XMLで保存するように変更して（[Save as XML]チェック・ボックスにチェックを入れる）、
--全列にチェックを入れる。
**リスナーの追加 [#g3030b7d]
「テスト計画」以下に[[負荷テストのレポート用のリスナー>Jmeter用語#nce1569e]]を追加。
***[[「統計レポート」リスナー>Jmeter用語#nce1569e]] [#v86e3616]
「テスト計画」以下に[[「統計レポート」リスナー>Jmeter用語#nce1569e]]を追加し、~
「統計ログ(CSV)」の出力を構成する。
-ファイル名~
time関数を使用して、以下のように指定（フルパス）。
"...\XXXXシナリオ・統計レポート_&{__time(YMDHMS)}.jlt"
-config（[[Sample Result Save Configurationの出力項目>#y3f415ef]]を設定）
--configボタンを押下して、
--CSVで保存するように変更して（[Save as XML]チェック・ボックスのチェックを外す）、
--全列にチェックを入れる。
*出力項目 [#l05a3785]
**[[「Sample Result Save Configuration」リスナー>Jmeter用語#ke3512f6]] [#y3f415ef]
***保存フォーマットの設定 [#l78c2c48]
|項番|統計ログ(CSV)|エラーログ(XML)|チェック項目名|プロパティ名|説明|h
|1||◯|Save as XML|jmeter.save.saveservice.output_format|xml、csv、dbからフォーマットを指定。&br;現在、xmlとcsvのみがサポート。|
|2|◯||Save Field Names (CSV)|jmeter.save.saveservice.print_field_names|CSVヘッダのフィールド名。&br;※ CSV形式のみ。|
|3|◯||－|jmeter.save.saveservice.default_delimiter|CSVの区切り文字。&br;※ CSV形式のみ。|
|4|◯||－|jmeter.save.saveservice.timestamp_format|タイムスタンプ形式&br;none, ms, yyyy/MM/dd HH:mm:ss.SSS&br;※ CSV形式のみ。|
***保存フィールドの設定 [#z04245c5]
当該フィールドを保存する場合はtrue。保存しない場合はfalse。
-GUI（Sample Result Save Configurationダイアログ）表示あり
|項番|統計ログ(CSV)|エラーログ(XML)|チェック項目名|プロパティ名|説明|[[CSV Log format>http://jmeter.apache.org/usermanual/listeners.html#csvlogformat]]|[[XML Log format>http://jmeter.apache.org/usermanual/listeners.html#xmlformat2.1]]|h
|2|◯|◯|Save Time Stamp|sampleresult.timestamp.start|サンプラーを実行した時刻|>|timeStamp|
|3|◯|◯|Save Elapsed Time|jmeter.save.saveservice.time|レスポンス時間|>|elapsed|
|4|◯|◯|Save Label|jmeter.save.saveservice.label|サンプラーのラベル|>|label|
|5|◯|◯|Save Response Code|jmeter.save.saveservice.response_code|HTTP レスポンスステータスコード|>|responseCode|
|6|◯|◯|Save Response Message|jmeter.save.saveservice.response_message|HTTP レスポンスステータスコードに対応するメッセージ|>|responseMessage|
|7|◯|◯|Save Thread Name|jmeter.save.saveservice.thread_name|スレッド名|>|threadName|
|8|◯|◯|Save Data Type|jmeter.save.saveservice.data_type|レスポンス・データのタイプ|>|dataType|
|9|◯|◯|Save Success|jmeter.save.saveservice.assertion_results|真または偽&br;※ none, first, all|>|success|
|10|◯|◯|Save Assertion Failure Message|jmeter.save.saveservice.assertion_results_failure_message|※ CSV形式のみ。|>|failureMessage|
|11|◯|◯|Save received byte count|jmeter.save.saveservice.bytes|サンプルの受信バイト数|>|bytes|
|12|◯|◯|Save sent byte count|jmeter.save.saveservice.sent_bytes|サンプルの送信バイト数|>|sentBytes|
|13|◯|◯|Save Active Thread Counts|jmeter.save.saveservice.thread_counts|スレッドグループ内のアクティブなスレッド数と&br;テスト計画内のアクティブなスレッド数|>|grpThreads, allThreads|
|14||◯|Save URL|jmeter.save.saveservice.url|URL|>|URL|
|15||◯|Save Response Filename|jmeter.save.saveservice.filename|ファイル名|>|Filename|
|16|◯|◯|Save Latency|jmeter.save.saveservice.latency|レイテンシ|>|latency|
|17|◯|◯|Save Connect Time|jmeter.save.saveservice.connect_time|接続を確立する時刻|>|connect|
|18|||Save Encoding|jmeter.save.saveservice.encoding|エンコーディング|>|encoding|
|19|||Save Sample and Error Counts|jmeter.save.saveservice.sample_count|サンプル数とエラー数|>|SampleCount, ErrorCount|
|20|||Save Hostname|jmeter.save.saveservice.hostname|サンプルが生成された場所（ホスト名）|>|Hostname|
|21|◯|◯|Save Idle Time|jmeter.save.saveservice.idle_time|サンプリングに費やされなかった時間|>|IdleTime|
|22||◯|Save Request Headers (XML)|jmeter.save.saveservice.requestHeaders|Request Header|CSV形式ではサポートされない|[[12.5 XML Log format 2.1>http://jmeter.apache.org/usermanual/listeners.html#xmlformat2.1]]|
|23||◯|Save Request Data (XML)|jmeter.save.saveservice.samplerData|Sampler Data|~|~|
|24||◯|Save Response Headers (XML)|jmeter.save.saveservice.responseHeaders|Response Header|~|~|
|25||◯|Save Response Data (XML)|jmeter.save.saveservice.response_data|Response Data|~|~|
|26||◯|Save Sub Results (XML)|jmeter.save.saveservice.subresults|Transaction Controllerの結果|~|~|
|27||◯|Save Assertion Results (XML)|jmeter.save.saveservice.assertions|Assertion結果|~|~|
-GUI（Sample Result Save Configurationダイアログ）表示なし
|項番|プロパティ名|説明|[[CSV Log format>http://jmeter.apache.org/usermanual/listeners.html#csvlogformat]]|[[XML Log format>http://jmeter.apache.org/usermanual/listeners.html#xmlformat2.1]]|h
|1|jmeter.save.saveservice.response_data.on_error|Save ResponseData for failed samples|||
|2|sample_variables|JMeter変数名のオプションリスト|Variables||
**[[「統計レポート」リスナー>Jmeter用語#nce1569e]] [#w0c54656]
統計ログ(CSV)をベースに生成される。
|項番|項目名|説明|h
|1|Label|サンプルのラベル。&br;"ラベルにグループ名を含める？" が選択されると、スレッドグループの名前が接頭辞として追加される。&br;これにより、必要に応じて異なるスレッドグループの同一ラベルを個別に照合することができる。|
|2|# Samples|ラベルのサンプル数。|
|3|Average|ラベルのレスポンス時間の平均値|
|4|Median|ラベルのレスポンス時間の中央値|
|5|90% Line|ラベルのレスポンス時間の90%パーセンタイル（90%に位置する値）|
|6|95% Line|ラベルのレスポンス時間の95%パーセンタイル（95%に位置する値）|
|7|99% Line|ラベルのレスポンス時間の99%パーセンタイル（99%に位置する値）|
|8|Min|ラベルのレスポンス時間の最短時間|
|9|Max|ラベルのレスポンス時間の最長時間|
|10|Error %|ラベルのレスポンスのエラーの割合|
|11|Throughput|ラベルのリクエスト数 / (秒 or 分 or 時間)。&br;時間単位は、表示されたレートが少なくとも1.0になるように選択される。&br;CSVファイルに保存されると、秒が選択される。|
|12|Received KB/sec|ラベルの受け取ったキロバイト/秒で測定されたスループット|
|13|Sent KB/sec|ラベルの送信されたキロバイト/秒で測定されたスループット|
*レポーティング [#b6974cf9]
**ダッシュボード・レポートの生成 [#v3b84c91]
テストの成功を確認するための簡易確認用のHTMLレポートを生成する機能。
***生成方法 [#g58e5efb]
-以下のコマンドで統計ログ(CSV)をベースに生成される。
jmeter -g "XXXXシナリオ・統計レポート_XXXX.jlt" -o 出力先フォルダ
-横軸の長さは、の以下のプロパティを設定する。
-以下のプロパティを設定する。~
http://jmeter.apache.org/usermanual/generating-dashboard.html#configuration
***レポート [#k53064d4]
-
-
-
***レポート種類 [#k53064d4]
http://jmeter.apache.org/usermanual/generating-dashboard.html#overview
**リスナーにロード [#wb1232f0]
出力ファイルのデータは、[[ワークベンチ>Jmeter用語#e79d0c85]]の適切なリスナーにロードして分析する。
***[[「Response Time Graph」リスナー>Jmeter用語#nce1569e]] [#g540a843]
統計ログ(CSV)をベースに生成される。
-統計ログ(CSV)のファイルパスを指定する。
-Intervalを指定して、[Apply interval]ボタンを押下する。
-サンプラーのラベルを[[正規表現>Jmeterの正規表現]]で記入して、[Apply filter]ボタンを押下する。
-[Display Graph]ボタン ---> [Save Graph]ボタンを押下する。
***・・・ [#n654c045]
**Excelでグラフを生成 [#b7c32acf]
統計ログ(CSV)をベースに生成される。
|項番|グラフ名|縦軸|横軸|h
|1|多重度（仮想ユーザ数）の推移|grpThreads or allThreads|timeStamp|
|2|エラー件数の推移|success=false|timeStamp|
|3|レスポンス時間の推移|elapsed|timeStamp|
*参考 [#f138906c]
**Apache JMeter - User's Manual [#a1a4920d]
***Listeners [#m71d982d]
-12.1 Default Configuration~
http://jmeter.apache.org/usermanual/listeners.html#defaults
-12.1.2 Sample Result Save Configuration~
http://jmeter.apache.org/usermanual/listeners.html#sample_configuration
***Generating Dashboard Report [#abeb6068]
http://jmeter.apache.org/usermanual/generating-dashboard.html
----
Tags: [[:テスト]], [[:ツール類]]
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
