Jmeter 使用笔记之 html 报告扩展（一）

题记：在用 loadrunner 的时候可以生成一个 HTML 的报告，并且里面包含各种图表，各种详细的数据。而在使用 Jmeter 测试完后并不能直接生成 Html 的报告（无论是用 GUI 还是命令行启动）。

经过查找资料发现 Jmeter 的 extras 目录下有生成 HTML 的 xsl 样式表，其实 Jenkins+ant+Jmeter 生成的 HTML 报告也是调用了这里的样式表生成的，于是

通过 xsltproc report.jtl > test.html，或者 ant 也可以。这个命令把Jmeter 的结果文件转换为 HTML 的报告。结果如下：



这里虽然能生成 HTML 报告了，但是这个报告太弱了，基本不能用，包含的参数太少。所以需要对这个报告进行扩展。因为 Jmeter 本身的聚合报告的数据还是比较全的，

因此打算按照那个报告的值进行扩展。

xsltproc，xlst介绍

XSL 指扩展样式表语言（EXtensible Stylesheet Language），把 XML 转换为HTML 用的就是 xls 编写的样式表，所以如果要扩展这个报告，首先要对 xls

熟悉，才能更改和扩展样式表。可以在http://www.w3school.com.cn/xsl/index.asp这里进行此语言的学习。

xsltproc 是一个快速 XSLT 引擎,它可以将通过 XSL 层叠样式表把 XML 转换为相应格式的文件，比如：HTML,XHTML,PDF

比如将 XML 转换为 HTML，使用格式如下：

xsltproc xsl-html.xsl hoto.xml -o html.html （这里还可以直接把样式表文件写入 jtl 文件的 href 属性中，直观的告诉这个 XML 用哪个样式表）

xls 中查找 XML 用的 xpath，因此还需要对 xpath 熟悉，xsltproc 这个引擎用的是 xpath1.0 版本，因此在样式表中使用 xpath 是不能使用 xpath2.0 的函数

和一些属性。

个人对 xpath 还算熟悉，但是对 xls 一点也不熟悉，没办法为了能够扩展报告，直接学习 xls 和 xpath。（关于 xls 会再写一遍博客介绍，顺便把使用过程中

的问题和经验汇总）

如果直接使用 ant 和 Jmeter 集成后也是可以直接生成的，但是 ant 转换 HTML 的引擎也是只支持 xpath1.0，后来经过了解大部分的引擎都不支持xpath2.0，所以

期中不能使用 xpath2.0 的函数。

90%Line 时间

为了能够显示 90%Line 的时间，首先要对这个指标熟悉，这个指标值得是一组数据，在 90% 的位置的数据的时间，所以我们扩展的时候只要知道了 90%

位置的索引，那么就能取得这个值了。

以下是部分关键代码

<xsl:variable name="allMedianTime">
                <xsl:call-template name="LineTime">
                    <xsl:with-param name="nodes" select="/testResults/*/@t" />
                    <xsl:with-param name="position" select="ceiling($allCount * 0.9)" />
                </xsl:call-template>
            </xsl:variable>

这里主要是获得时间元素的集合，以及 90%line 的位置，有了这两个参数后就可以进行后续的扩展了，扩展后的效果图如下：

因为 90%Line 和 95%Line,99%Line 计算原理都是一致的，因此只要计算出一个值其他的值也很好计算

QPS 扩展

Jmeter 的具合报告有 Throughput 这个值，这个在 loadrunner 中是表示为吞吐量的，这里可以表示 QPS 或者 TPS（在使用了事务的情况下），个人把这个称为 QPS，因为更直观。

和 %90Line 同样的道理，首先必须知道这个值是怎么计算出来，经过查找资料和官网的比较，发现这个值是通过如下的公式计算出来的：

官网的截图：

Throughput = (number of requests) / (total time)

total time = 测试结束时间 - 测试开始时间

测试结束时间 = MAX(请求开始时间 + Elapsed Time)

测试开始时间 = MIN(请求开始时间)

知道了公式，那么计算就容易了，以下是关键代码：

<xsl:variable name="nodeThroughput">
                <xsl:call-template name="throughput">
                    <xsl:with-param name="nodes" select="/testResults/*/@ts" />
                    <xsl:with-param name="count" select="$allCount" />
                </xsl:call-template>
            </xsl:variable>

扩展后的结果如下：

吞吐量扩展

在 loadrunner 中吞吐量就是 Throughput，在 Jmeter 的聚合报告中最后一列的值就是 loadrunner 中的 Throughput，为了便于区分，我把这里的值称为Throughput，

也就是吞吐量。

经过查找资料发现吞吐量的计算和 QPS 的计算公式是一样的，因为也就是如下的公式：

Throughput = (请求的总字节数) / (total time)

这里的 total time 计算和 QPS 是一样的，而总字节数直接把所有请求的加起来即可，关键代码如下：

<xsl:variable name="nodeKB">
                <xsl:call-template name="throughput">
                    <xsl:with-param name="nodes" select="/testResults/*/@ts" />
                    <xsl:with-param name="count" select="sum(/testResults/*/@by) div 1024" />
                </xsl:call-template>
            </xsl:variable>

因为这里显示的字节，最后的结果我打算以 KB 的单位显示，因此这里需要除以1024，扩展后的结果如下

TPS扩展

TPS 在 Jmeter 中虽然某些情况和 QPS 是一致的，但是还是有不一致的地方，因此这里也需要扩展，这样的结果看着更清晰明了。

首先和其他的参数扩展一样，需要知道计算公式，这里的计算公式和 QPS 也是一样的，只是数据的集合不一样，以下是扩展后的效果。



在扩展的过程中进一步发现 Jmeter 的聚合结果中最后的”总体“一行在某些情况下计算的数值是不准确的。如果脚本中不包含事务，那么这里的结果是准确的，如果都包含事务并且把

Generate parent sample 选中后这里的结果也是准确的，在脚本中有事务并且没有选中 Generate parent sample，或者有些有事务有些没有时，这时的结果就不准确了，因为查看计算

方式发现它把所有的请求都算进去了。

比如，一个 jtl 文件中即包含 HTTP 请求也包含事务，因为事务只是对之前请求的一个统计，本身是不发送请求的，所以计算总的吞吐量、QPS，TPS 时是不能这么算的。

所以在扩展的过程中分成了两个样式表，一个样式表处理包含事务，或者没有事务的情况，这时的结果以 QPS 衡量；一个样式表处理全都是事务的情况，这时候的结果以 TPS 衡量，这样

就准确了。

测试

扩展了好几个指标，这些指标的正确性如何呢？需要在多种情况下进行测试，经过测试后各个指标都是正确的。但是还没有在大的数据量级别下测试，如果测试后发现哪里会有问题，会及时

更改。

切记：由于样式表中是按照 lb 进行请求区分的，因此这里的 lable 不能重复，本身也不应该重复，包括 Jmeter 的聚合报告都是以 lable 进行区分的

PS：在扩展过程中的难点一是公式如何计算的，二是xls这个 指扩展样式表语言不是很熟悉，本身也有很多限制，会在下个博客中说明。但是用过后感觉还是很不错的既熟悉了 xpath 还熟悉了 xls。

三是需要对 Jmeter 的测试结果文件每个字段戴表什么意思熟悉，这样才能定制更多的指标，这个也会在单独的博客中说明

OneAPM Mobile Insight以真实用户体验为度量标准进行 Crash 分析，监控网络请求及网络错误，提升用户留存。访问 OneAPM 官方网站感受更多应用性能优化体验，想阅读更多技术文章，请访问 OneAPM 官方技术博客。

本文转自 OneAPM 官方博客