1.简介
相对于 Loadrunner，Jmeter 其实也是可以有测试报告产出的，虽然一般都不用（没有 Loadrunner 的报告那么强大是一方面），但是有小伙伴们私下问，那宏哥还是顺手写一下吧，今天我们就来学习下，如何输入 HTML 格式的 JMeter 测试报告。前面已经介绍， 如果要做性能测试，需要在 GUI 上设计好你的 Test Plan，设置各种场景和负载值，包括多少个线程，多少个用户，循环多少次。设置好了保存，然后用命令行去启动性能测试，查看相关测试结果。
2.Jmeter 生成 HTML 格式报告的架构
仪表板生成引擎是基于示例操作流程的模块化功能。
下图可以表示这些过程：
在此视图中，可以看到：
- 产生样品的来源（例如 CSV 文件）。
- 一系列称为消费者的项目，对通过该项目的样本进行操作（例如，筛选，排序，计算等）。
- 执行上下文，称为样本上下文，在其中存储使用者计算的结果。
- 一组名为出口器的项目，它们使用示例上下文的内容为用户生成最终结果（例如 HTML 页面生成）。
3.具体步骤
- 打开图像（gui）界面，新建一个 Thread Group，如下图所示：
- 新建三个 Http Request，分别是百度新闻首页，和百度新闻财经，百度新闻体育，如下图所示：
百度新闻首页
百度新闻财经
百度新闻体育
- 添加一个 Assertion,选择 response assertion，如下图所示：
- 添加一个 View Results Tree.如下图所示：
- Thread Group 设置如下图所示：
这里，你在图形界面的时候，最好设置都是 1，测试通过后，再改成多个用户，然后保存本地 xx.jmx 文件
- 保存到本地，关闭 JMeter。
7.本地先在桌面创建一个文件夹 HttpReports，用来保存 HTML 报告。
- cmd 启动性能测试，如下图所示：
9.cmd 先要 cd 到 jmeter 的 bin 目录，然后输入以下命令：
jmeter -n -t D:\software\apache-jmeter-5.1.1\bin\Test Plan And Report.jmx -l C:\Users\DELL\Desktop\HttpReports\html.csv -e -o C:\Users\DELL\Desktop\HttpReports
三个路径依次是：xxx.jmx 文件路径，输出 xxx.csv 文件路径，要保存的 http report 的文件路径，运行结果如下图所示：
- 查看 HTTP 报告，在桌面的 HttpReports 文件夹，生成了多个文件，如下图所示：
11.用浏览器打开这个 html 文件，自己随便点击，看看报告，如下图所示：
4.图表信息详解
Jmeter5.0 后测试报告分为三部分，Dashboard、Charts 和 Customs Graphs，Jmeter5.0 以下版本没有第三项的。下面分开讲解。
4.1Dashboard（概览仪表盘）
①、Test and Report informations
Test and Report informations：测试和报告信息: 测试结果保存文件/测试开始时间/测试结束时间/展示过滤器。
②、APDEX (应用性能指标)
APDEX(Application Performance Index)：应用程序性能满意度的标准，范围在 0-1 之间，1 表示达到所有用户均满意，可以在配置文件设置。关于 APDEX 的相关信息，请参考这里：应用性能指标；英文原文，参考这里：Apdex-Wikipedia
③、Requests Summary
Requests Summary: 请求的通过率 (OK) 与失败率 (KO)，百分比显示。
④、Statistics
统计表在一个表中提供每个事务的所有指标的摘要，包括 3 个可配置的百分位数。Statistics: 数据分析，基本将 Summary Report 和 Aggrerate Report 的结果合并。
⑤、Errors
错误表提供了所有错误及其在总请求中所占比例的摘要。Errors: 错误情况，依据不同的错误类型，将所有错误结果展示。
⑥、Top 5 Errors by sampler
前 5 个错误（按 Sampler 列出）表为每个 Sampler（默认情况下不包括 Transaction Controller）提供前 5 个错误：Top 5 Errors by sampler：Top5 错误信息采样
4.2Charts（详细信息图表）
Charts 里如图所示分为三大块：时间维度信息 (Over Time)、吞吐量 (Thorughput)、响应时间 (Response Times)
PS： 由于详细信息图表有点多，这里我挑几个性能测试过程中比较关键的图表解析！
Over Time
①、Response Times Over Time（脚本运行期间的响应时间变化趋势图）
说明：可以根据响应时间和变化和 TPS 以及模拟的并发数变化，判断性能拐点的范围。
②、 Response Time Percentiles Over Time (successful responses)
说明：脚本运行期间成功的请求响应时间百分比分布图，可以理解为聚合报告里面不同% 的数据，图形化展示的结果。
③、Active Threads Over Time（脚本运行时间内的活动线程分布）****
** ④、 Bytes Throughput Over Time（脚本运行期间的吞吐量变化趋势图）**
说明：在容量规划、可用性测试和大文件上传下载场景中，吞吐量是很重要的一个监控和分析指标。
⑤、Latencies Over Time（脚本运行期间的响应延时变化趋势图）****
说明：在高并发场景或者强业务强数据一致性场景，延时是个很严重的影响因素。
⑥Connect Time Over Time（脚本运行时间内平均连接时间）
Throughput
①、Hits Per Second (excluding embedded resources) 每秒点击数曲线
②、Codes Per Second (excluding embedded resources) 每秒状态码分布曲线
③、Transactions Per Second 每秒事物数曲线
说明：每秒事务数，即 TPS，是性能测试中很重要的一个指标，它是用来衡量系统处理能力的一个重要指标。
④、Total Transactions Per Second 每秒通过事务总数 ****
** ⑤、 Response Time Vs Request 响应时间中值与每秒请求数关系曲线 **
⑥、Latency Vs Request 延迟时间中值与每秒请求数关系曲线
Response Times
①、 **Response Time Percentiles（响应时间百分比分布曲线图）**
说明：即响应时间在某个范围内的请求在所有请求数中所占的比率，相比于平均响应时间，这个值更适合用来衡量系统的稳定性。
②、Response Time Overview 响应时间概述柱状图
③、Time Vs Threads（平均响应时间和线程数的对应变化曲线）
说明：可以通过这个对应的变化曲线来作为确定性能拐点的一个参考值。
④、Response Time Distribution 响应时间分布图
4.3Customs Graphs
因为宏哥这里没有设置所以是空的，你可以根据自己需求定制自己的，具体的步骤请参考：https://jmeter.apache.org/usermanual/generating-dashboard.html#top
5.小结
1.在输入命令运行的时候，宏哥遇到了找不到测试计划（An error occurred: Unknown arg: Plan），宏哥第一感觉就是测试计划的名字中间有空格（其他可能情况：特殊字符、路径错误、中文等等吧）去掉后就可以运行了。
2.运行过程和制作会遇到 4445 端口是否允许通过防火墙或者安全性提示的信息，允许通过就可以了。
3.自定义配置
JMeter3.0 在 bin 目录新增了 reportgenerator.properties 文件保存了所有关于图形化 HTML 报告生成模块的默认配置，要变更配置，建议不要直接编辑该文件，而是推荐在 user.properties 中去配置和覆盖。
①、总体配置
总体配置都是以 jmeter.reportgenerator.为前缀，如：jmeter.reportgenerator.overall_granularity=60000
overall_granularity：定义采样点粒度，默认为 60000ms，通常在稳定性以外的测试中，我们可能需要定义更细的粒度，比如 1000ms，我们可以在 user.properties 文件末尾添加如下配置：
Change this parameter if you want to change the granularity of over time graphs.
jmeter.reportgenerator.overall_granularity=6000
report_title:定义报告的标题，我们可能需要将标题定义为实际测试项名称
apdex_satisfied_threshold：定义 Apdex 评估中满意的阈值 (单位 ms)
apdex_tolerated_threshold: 定义 Apdex 评估中可容忍的阈值
Apdext = (Satisfied Count + Tolerating Count / 2) / Total Samples
另外，在 jmeter.properties 中，有关于集合报告中的三个百分位的默认值：
aggregate_rpt_pct1 : Defaults to 90
aggregate_rpt_pct2 : Defaults to 95
aggregate_rpt_pct3 : Defaults to 99
可以在 user.properties 中对其进行覆盖，如：aggregate_rpt_pct1 = 70，效果如下：
②、图表配置
每个图表配置都是以 jmeter.reportgenerator.graph.<图表名称>.为前缀。
classname 图表的实现类，如果有自己定制的实现，将该配置的值写为自定义实现类的类名
property.set_granularity 设置图标的采样点粒度，不配置时默认使用总体配置中的粒度设置
③、输出配置
输出配置都以 jmeter.reportgenerator.exporter 为前缀。
property.output_dir 配置默认的报告输出路径。在命令行可以用-o 选项来设置特定的路径覆盖该配置。
html.series_filter 用于过滤展示内容。如在 user.properties 添加如下配置：
jmeter.reportgenerator.exporter.html.series_filter=(Login)(-success|-failure)?
则最后的报告只展示名为 Login 这个取样器的数据。该配置包含两部分，(-success|-failure)?是 Transactions per second 图表所依赖的配置。前面部分接受一个正则表达式用来过滤。
④、报告定制
JMeter 的 HTML 报告生成时是使用了固定的模板，模板文件路径为./bin/report-template。
进入该目录可以看到报告的每个页面都有一个.fmkr 模板文件，包括 index.html.fmkr 和./content/pages 路径下的几个文件。通过查看这些模板文件，就可以知道怎样去进行报告的轻度定制，比如将一些文本修改得更易懂，或者修改为中文等
⑤、页面的 title
默认为"Apache JMeter Dashboard"
可以由 reportgenerator.properties 中的 jmeter.reportgenerator.report_title 来统一定义，这种方式就是所有页面的 title 都使用同一个。
也可以直接修改对应的.fmkr 文件中的 title 标签中双引号内的值，如
图表的名称
当前版本下，各图表的名称是直接在模板文件中定义，要修改也是直接修改模板文件中对应元素的值即可
如要修改 Transactions Per Second 图表的名称，可以直接在./content/pages/Throughput.html.fmkr 文件中修改，效果如下图
