Jmeter和Ant的html报告优化及Dashboard Report介绍

       通过Ant可以很方便的build执行Jmeter的jmx脚本，并且输出html报告，靠的就是Jmeter的xsl template模板，具体在build.xml是这样对jmeter-results-detail-report_21.xsl进行调用：

<target name="xslt-report" depends="_message_xalan">        <tstamp><format property="report.datestamp" pattern="yyyy/MM/dd HH:mm"/></tstamp>        <xslt            classpathref="xslt.classpath"            force="true"            in="${testpath}/report/jtl/${test}${time}.jtl"            out="${testpath}/report/html/${test}${time}.html"            style="${jmeter.home}/extras/jmeter-results-detail-report${style_version}.xsl">            <param name="showData" expression="${show-data}"/>            <param name="titleReport" expression="${report.title}"/>            <param name="dateReport" expression="${report.datestamp}"/>        </xslt></target>

但是默认调用的jmeter-results-detail-report_21.xsl报告模板是不带有90% Line时间的，以下是生成的报告样例：

我们可以动手进行一些改造，首先我们需要明白2个原理：

（1）90% Line的意思是：一组数由小到大进行排列，找到它的第90%个数；
（2）Jmeter html报告生成是使用xxx.jtl文件通过xsl模板生成的，因此要在html报告中显示90% line，就需要修改xsl模板文件（jmeter-results-detail-report_21.xsl）

下面开始改造：

1、第一步就是在jmeter-results-detail-report_21.xsl添加xsl template，可以模拟Max Time模板（对比<xsl:template name="max">），直接在max模板下新建一个line模板，如下：

<!-- New add 90% line --><xsl:template name="line">    <xsl:param name="nodes" select="/.." />    <xsl:choose>        <xsl:when test="not($nodes)">NaN</xsl:when>        <xsl:otherwise>            <xsl:for-each select="$nodes">                <xsl:sort data-type="number" />                <xsl:if test="position() = floor(last()*0.9)">                    <xsl:value-of select="number(.)" />                </xsl:if>            </xsl:for-each>        </xsl:otherwise>    </xsl:choose></xsl:template>

这里需要注意的是：

（1）与max模板的区别就是sort方面，直接用顺序<xsl:sort data-type="number" />，而max模板用的是倒序<xsl:sort data-type="number" order="descending" />。为什么不能倒序，是由下面第（2）条决定的。

（2）position() = floor(last()*0.9)，其中last()返回当前上下文中的最后一个节点位置数，乘以0.9表示找到第90%个；floor(number) 表示返回不大于number的最大整数。

（3）number(object)使对象转换成数字。

2、有了以上的的90% Line模板，我们可以直接引用了。在Summary中添加90% Line。

<xsl:template name="summary"><h2>Summary</h2><table align="center" class="details" border="0" cellpadding="5" cellspacing="2" width="95%">.........该处为一堆省略不显示的代码...........<xsl:variable name="allMaxTime"><xsl:call-template name="max"><xsl:with-param name="nodes" select="/testResults/*/@t" /></xsl:call-template></xsl:variable><!-- 以下New add 90% line --><xsl:variable name="allLineTime">    <xsl:call-template name="line">        <xsl:with-param name="nodes" select="/testResults/*/@t" />    </xsl:call-template></xsl:variable><xsl:attribute name="class"><xsl:choose><xsl:when test="$allFailureCount > 0">Failure</xsl:when></xsl:choose></xsl:attribute>.........该处为一堆省略不显示的代码...........<td align="center"><xsl:call-template name="display-time"><xsl:with-param name="value" select="$allMaxTime" /></xsl:call-template></td><!-- 以下添加 90% line 显示列--><td align="center"><xsl:call-template name="display-time"><xsl:with-param name="value" select="$allLineTime" /></xsl:call-template></td></tr></table></xsl:template>

3、在pagelist中添加90% Line

<xsl:template name="pagelist"><h2>Pages</h2><table align="center" class="details" border="0" cellpadding="5" cellspacing="2" width="95%">.........该处为一堆省略不显示的代码...........<xsl:variable name="maxTime"><xsl:call-template name="max"><xsl:with-param name="nodes" select="../*[@lb = current()/@lb]/@t" /></xsl:call-template></xsl:variable><!-- 以下添加 90% line 节点--><xsl:variable name="lineTime"><xsl:call-template name="line"><xsl:with-param name="nodes" select="../*[@lb = current()/@lb]/@t" /></xsl:call-template></xsl:variable><tr valign="top">.........该处为一堆省略不显示的代码...........<td align="right"><xsl:call-template name="display-time"><xsl:with-param name="value" select="$maxTime" /></xsl:call-template></td><!-- 以下添加 90% line 显示列--><td align="right"><xsl:call-template name="display-time"><xsl:with-param name="value" select="$lineTime" /></xsl:call-template></td>.........该处为一堆省略不显示的代码...........                        </tr></xsl:for-each></table></xsl:template>

好了，这样就算修改完了，只要不出现手抖犯的错误，下面我们就能在报告中看到90% Line时间的列了，而且显示的时间跟Jmeter中聚合报告显示的是基本吻合的。

        通过以上的过程，我们发现还可继续扩展在html报告中显示95%，99%等时间及其他指标。

        讲完了Ant通过xls模板生成的报告，我们再来说说Jmeter自带的功能，从Jmeter3.0开始就有了强大的CSV生成Html报告的功能（很多人都不知道），生成报告的方法也很简单：

在jmeter.properties或者user.properties确认如下配置项：

jmeter.save.saveservice.data_type=truejmeter.save.saveservice.label=truejmeter.save.saveservice.response_code=truejmeter.save.saveservice.response_data.on_error=truejmeter.save.saveservice.response_message=truejmeter.save.saveservice.successful=truejmeter.save.saveservice.thread_name=truejmeter.save.saveservice.time=truejmeter.save.saveservice.subresults=truejmeter.save.saveservice.assertions=truejmeter.save.saveservice.latency=truejmeter.save.saveservice.connect_time=truejmeter.save.saveservice.bytes=truejmeter.save.saveservice.sent_bytes=truejmeter.save.saveservice.thread_counts=truejmeter.save.saveservice.idle_time=true# Timestamp format - this only affects CSV output files# legitimate values: none, ms, or a format suitable for SimpleDateFormatjmeter.save.saveservice.timestamp_format=msjmeter.save.saveservice.timestamp_format=yyyy/MM/dd HH:mm:ss.SSS

如果希望在Errors报告中展示更详细数据，需要确保如下配置：

jmeter.save.saveservice.assertion_results_failure_message = true

如果使用了事务控制器(Transaction Controller)，确认Generate parent sample为未勾选状态。

以下是生成报告的方式：

a. 在压力测试结束时报告
基本命令格式：

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

样例：

jmeter -n -t F:\PerformanceTest\TestCase\script\rfApp接口.jmx -l testLogFile -e -o ./output

b. 使用已有的压力测试CSV日志文件生成报告
基本命令格式：

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

样例：

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

当然也可以把相关命令放到bat或sh中做成批处理直接执行（CSV文件带上时间后缀，避免冲突），可以用相对路径来调用jmx脚本，并输出相对路径的CSV文件和html报告文件（需要说明一下html报告的文件夹不能先创建，否则报冲突，测试前可以加个清空文件夹的动作或者加个时间后缀让目录唯一）。

如以下命令（用以上xls报告一样的脚本测试）：

@echo offset a=%time:~0,2%%time:~3,2%%time:~6,2%set b=0%time:~1,1%%time:~3,2%%time:~6,2%if %time:~0,2% leq 9 (set c=%b%)else set c=%a%jmeterHome3.1\bin\jmeter -n -t rfApp接口.jmx -l DashReport\log-%Date:~0,4%%Date:~5,2%%Date:~8,2%%c%.csv -e -o DashReport\htmlReport-%Date:~5,2%%Date:~8,2%%c%pause

产生的文件：

顺便再提供一份Linux版的Shell命令以供参考：

#!/bin/bashCur_Dir=$(cd "$(dirname "$0")"; pwd)$Cur_Dir/jmeterHome3.2/bin/jmeter -n -t $Cur_Dir/rfAppTest.jmx -l $Cur_Dir/DashReport/log-$(date -d "today" +"%Y%m%d%H%M%S").csv -e -o $Cur_Dir/DashReport/htmlReport-$(date -d "today" +"%m%d%H%M%S")

最后上一下我生成的报告，看着还是比较高大上的：

最后再提供一下Jmeter生成html报告的命令参数说明：

• -h 帮助 -> 打印出有用的信息并退出
• -n 非 GUI 模式 -> 在非 GUI 模式下运行 JMeter
• -t 测试文件 -> 要运行的 JMeter 测试脚本文件
• -l 日志文件 -> 记录结果的文件
• -r 远程执行 -> 启动all远程服务
• -R 远程执行 -> 启动指定远程服务
• -H 代理主机 -> 设置 JMeter 使用的代理主机
• -P 代理端口 -> 设置 JMeter 使用的代理主机的端口号
• -e 测试结束后，生成测试报告
• -o 指定测试报告的存放位置