Linux下利用Ant调用Jmeter脚本生成HTML测试报告
今天我们学习如何利用Ant调用Jmeter脚本,并将生成的 jtl
文件转换为 HTML
格式的测试报告。
准备工作
需要在Linux上提前安装好 Jmeter
和 Ant
。
1,Jmeter(可参考文章:Linux下安装Jmeter)
2,Ant(可参考文章:Linux下安装Ant)
在Linux上新建以下目录(根据自己实际情况处理):
[ ~]# mkdir /root/demo [ ~]# mkdir /root/demo/jmeter_script [ ~]# mkdir /root/demo/result [ ~]# mkdir /root/demo/result/html [ ~]# mkdir /root/demo/result/jtl [ ~]# cd /root/demo [ demo]#
其中,
jmeter_script
用于存放Jmeter的测试脚本(jmx
文件),result
用于存放测试结果,其子文件夹HTML
和jtl
分别用于存放生成的HTML测试报告和jtl文件。
准备一个 Jmeter
的测试脚本,并放到jmeter_script
下。此时,如果直接在 /root/demo
目录下执行 Ant
命令,会出现报错提示 build.xml
不存在:
[ demo]# ant Buildfile: build.xml does not exist! Build failed [ demo]#
build.xml
是 Ant
的构建文件,可以自己编写一个,或者去网上找一个下来自己进行修改,以下是我这里的 build.xml
内容:
<?xml version="1.0" encoding="utf8"?> <project name="ant-jmeter-test" default="run" basedir="."> <tstamp> <format property="time" pattern="yyyyMMddHHmm" /> </tstamp> <!-- 需要改成自己本地的jmeter目录--> <property name="jmeter.home" value="/root/SoftWare/Jmeter/apache-jmeter-5.1.1" /> <!-- jmeter生成的jtl格式的结果报告的路径--> <property name="jmeter.result.jtl.dir" value="/root/demo/result/jtl" /> <!-- jmeter生成的html格式的结果报告的路径--> <property name="jmeter.result.html.dir" value="/root/demo/result/html" /> <!-- ?生成的报告的前缀--> <property name="ReportName" value="TestReport" /> <property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}.jtl" /> <property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}.html" /> <target name="run"> <antcall target="test" /> <antcall target="report" /> </target> <target name="test"> <taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" /> <jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}" jmeterlogfile="/root/demo/jmeter.log"> <!-- 声明要运行的脚本"*.jmx"指包含此目录下的所有jmeter脚本--> <testplans dir="/root/demo/jmeter_script" includes="*.jmx" /> <property name="jmeter.save.saveservice.output_format" value="xml"/> </jmeter> </target> <path id="xslt.classpath"> <fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/> <fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/> </path> <target name="report"> <tstamp> <format property="report.datestamp" pattern="yyyy/MM/dd HH:mm" /> </tstamp> <xslt classpathref="xslt.classpath" force="true" in="${jmeter.result.jtlName}" out="${jmeter.result.htmlName}" style="${jmeter.home}/extras/jmeter.results.shanhe.me.xsl"> <param name="dateReport" expression="${report.datestamp}"/> </xslt> <!-- 拷贝报告所需的图片资源至目标目录 --> <copy todir="${jmeter.result.html.dir}"> <fileset dir="${jmeter.home}/extras"> <include name="collapse.png" /> <include name="expand.png" /> </fileset> </copy> </target> </project>
上面使用了一个网上的Jmeter报告模板文件:jmeter.results.shanhe.me.xsl,需要下载该文件并放到Jmeter所在目录下 extras
子目录中。
最终,我们的demo结构如下:
[ demo]# ls build.xml jmeter_script result [ demo]# tree . ├── build.xml ├── jmeter_script │?? └── ant_jmeter_test.jmx └── result ├── html └── jtl 4 directories, 2 files [ demo]#
另外,我们还需要将安装Jmeter所在目录下 extras
子目录(/root/SoftWare/Jmeter/apache-jmeter-5.1.1/extras
)的 ant-jmeter-1.1.1.jar
复制到ant所在目录下 lib
子目录(/root/SoftWare/Ant/apache-ant-1.9.14/lib
)下,这样ant在执行时才能正常触发Jmeter的jmx脚本文件,命令如下:cp /root/SoftWare/Jmeter/apache-jmeter-5.1.1/extras/ant-jmeter-1.1.1.jar /root/SoftWare/Ant/apache-ant-1.9.14/lib
修改Jmeter配置文件
接着,我们还需要修改下Jmeter所在目录下 bin
子目录(/root/SoftWare/Jmeter/apache-jmeter-5.1.1/bin
)下的 jmeter.properties
,修改如下:
将一些参数设置为 true
,可以保存这些结果到 jtl
文件,如果有需要也可以全部设置为 true
来试试。
为了防止出现响应乱码,最好将这里编码设置为 UTF-8
。
Ant构建生成测试报告
以上配置完成后,现在我们只需要执行Ant构建,便可以得到测试结果了。因为在安装Ant时已经配置了环境变量,所以只需要在项目下输入 Ant
,就可以得到jtl文件及转换后的HTML测试报告。
[ demo]# ant Buildfile: /root/demo/build.xml run: test: [jmeter] Executing test plan: /root/demo/jmeter_script/ant_jmeter_test.jmx ==> /root/demo/result/jtl/TestReport.jtl [jmeter] Creating summariser <summary> [jmeter] Created the tree successfully using /root/demo/jmeter_script/ant_jmeter_test.jmx [jmeter] Starting the test @ Mon Jan 20 23:02:29 CST 2020 (1579532549840) [jmeter] Waiting for possible Shutdown/StopTestNow/HeapDump/ThreadDump message on port 4445 [jmeter] summary + 1 in 00:00:00 = 2.6/s Avg: 100 Min: 100 Max: 100 Err: 0 (0.00%) Active: 1 Started: 1 Finished: 0 [jmeter] summary = 1 in 00:00:00 = 2.5/s Avg: 100 Min: 100 Max: 100 Err: 0 (0.00%) [jmeter] Tidying up ... @ Mon Jan 20 23:02:31 CST 2020 (1579532551078) [jmeter] ... end of run report: [xslt] Processing /root/demo/result/jtl/TestReport.jtl to /root/demo/result/html/TestReport.html [xslt] Loading stylesheet /root/SoftWare/Jmeter/apache-jmeter-5.1.1/extras/jmeter.results.shanhe.me.xsl BUILD SUCCESSFUL Total time: 5 seconds [ demo]#
将测试报告传到Windows,在浏览器中查看HTML报告,如下: