14. 生成报告仪表板¶

14.1 概述¶

仪表板生成器是 JMeter 的模块化扩展。它的默认行为是从 CSV 文件中读取和处理样本以生成包含图形视图的 HTML 文件。它可以在负载测试结束时或按需生成报告。

此报告提供以下指标：

• APDEX（应用程序性能指数）表，根据可容忍和满足阈值的可配置值计算每个事务的 APDEX
• 显示成功和失败请求（不考虑事务控制器示例结果）百分比的请求摘要图：

  

• 一个统计表，在一个表中提供每个事务的所有指标的摘要，包括 3 个可配置的百分位数：

  

• 一个错误表，提供所有错误的摘要及其在总请求中的比例：

  

• Sampler 的前 5 个错误表为每个 Sampler（默认情况下不包括事务控制器）提供前 5 个错误：

  

• 可缩放图表，您可以在其中选中/取消选中每笔交易以显示/隐藏它：
  • 随时间变化的响应时间（包括事务控制器示例结果）：

    

  • 响应时间百分比随时间变化（仅限成功响应）：

    

  • 随着时间的推移活动线程：

    

  • 随时间推移的字节吞吐量（忽略事务控制器示例结果）：

    

  • 随时间推移的延迟（包括事务控制器示例结果）：

    

  • 随时间变化的连接时间（包括事务控制器示例结果）：

    

  • 每秒点击次数（忽略事务控制器示例结果）：

    

  • 每秒响应代码（忽略事务控制器示例结果）：

    

  • 每秒事务数（包括事务控制器示例结果）：

    

  • 响应时间与每秒请求（忽略事务控制器示例结果）：

    

  • 延迟与每秒请求（忽略事务控制器示例结果）：

    

  • 响应时间概览（不包括事务控制器示例结果）：

    

  • 响应时间百分位数（包括事务控制器示例结果）：

    

  • 时间与线程（包括事务控制器示例结果）：

    

    在分布式模式下，此图显示了一个水平轴，表示 1 个服务器的线程数。这是当前的限制
  • 响应时间分布（包括事务控制器示例结果）：

    

14.2 配置仪表板生成¶

仪表板生成使用 JMeter 属性来自定义报告。一些属性用于常规设置，而其他属性用于特定的图形配置或导出器配置。

jmeter.reportgenerator.exporter.html.series_filter=^(Search|Order)(-success|-failure)?$

jmeter.save.saveservice.bytes = true
# Only available with 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
# the timestamp format must include the time and should include the date.
# For example the default, which is milliseconds since the epoch:
jmeter.save.saveservice.timestamp_format = ms
# Or the following would also be suitable
# 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;\
    scenar01-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)?$
# Transactions per second 以“-success”或“-failure”为后缀的交易数，具体取决于
# 关于结果
#jmeter.reportgenerator.exporter.html.series_filter=^(Search|Order)(-success|-failure)?$

# 指示系列过滤器是否仅适用于样本系列
jmeter.reportgenerator.exporter.html.filters_only_sample_series=true
                    

14.3 生成报告¶

报告生成可以作为来自示例日志文件的独立过程完成，也可以在运行负载测试后自动完成。

jmeter -g <log file> -o <Path to output folder>

jmeter -n -t <test JMX file> -l <test log file> -e -o <Path to output folder>

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=Chunk Hit
jmeter.reportgenerator.graph.custom_testGraph.property.set_Y_Axis=Number of Hits
jmeter.reportgenerator.graph.custom_testGraph.set_X_Axis=Over Time
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=Number of Hits :
                        

14.6 想要改进报告仪表板？¶