转载地址:http://www.cnblogs.com/puresoul/p/4808416.html
一、环境准备:
1、Jdk1.6或以上:http://www.oracle.com/technetwork/java/javase/downloads/index.html
命令行输入:java -version,出现如下提示说明安装成功
2、ANT下载:http://ant.apache.org/bindownload.cgi
命令行输入:ant -v,出现如下提示说明安装成功
3、Jmeter下载:http://jmeter.apache.org/download_jmeter.cgi
4、将 jmeter的extras目录中ant-jmeter-1.1.1.jar包拷贝至ant安装目录下的lib目录中
5、修改Jmeter的bin目录下jmeter.properties文件的配置:jmeter.save.saveservice.output_format=xml
二、Jmeter脚本:
1、如何编写脚本请参见:http://www.cnblogs.com/puresoul/p/4740436.html
2、脚本目录:D:\apache-jmeter-2.13\demo
3、脚本内容:
测试百度.jmx Google1.jmx
三、build.xml代码:
1 <?xml version="1.0" encoding="UTF-8"?> 2 3 <project name="ant-jmeter-test" default="run" basedir="."> 4 <tstamp> 5 <format property="time" pattern="yyyyMMddhhmm" /> 6 </tstamp> 7 <!-- 需要改成自己本地的 Jmeter 目录--> 8 <property name="jmeter.home" value="D:\apache-jmeter-2.13" /> 9 <!-- jmeter生成jtl格式的结果报告的路径--> 10 <property name="jmeter.result.jtl.dir" value="D:\apache-jmeter-2.13\demo\report\jtl" /> 11 <!-- jmeter生成html格式的结果报告的路径--> 12 <property name="jmeter.result.html.dir" value="D:\apache-jmeter-2.13\demo\report\html" /> 13 <!-- 生成的报告的前缀--> 14 <property name="ReportName" value="TestReport" /> 15 <property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}${time}.jtl" /> 16 <property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}${time}.html" /> 17 18 <target name="run"> 19 <antcall target="test" /> 20 <antcall target="report" /> 21 </target> 22 23 <target name="test"> 24 <taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" /> 25 <jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}"> 26 <!-- 声明要运行的脚本。"*.jmx"指包含此目录下的所有jmeter脚本--> 27 <testplans dir="D:\apache-jmeter-2.13\demo" includes="*.jmx" /> 28 29 <property name="jmeter.save.saveservice.output_format" value="xml"/> 30 31 </jmeter> 32 </target> 33 34 <target name="report"> 35 <xslt in="${jmeter.result.jtlName}" 36 out="${jmeter.result.htmlName}" 37 style="${jmeter.home}/extras/jmeter-results-detail-report_21.xsl" /> 38 <!-- 因为上面生成报告的时候,不会将相关的图片也一起拷贝至目标目录,所以,需要手动拷贝 --> 39 <copy todir="${jmeter.result.html.dir}"> 40 <fileset dir="${jmeter.home}/extras"> 41 <include name="collapse.png" /> 42 <include name="expand.png" /> 43 </fileset> 44 </copy> 45 </target> 46 </project>
四、运行脚本:
1、cmd进入脚本目录:D:\apache-jmeter-2.13\demo
2、输入:ant 或 ant run(run为build.xml中的task名),执行结果:
D:\apache-jmeter-2.13\demo>ant Buildfile: build.xml all: test: [jmeter] Executing test plan: D:\apache-jmeter-2.13\demo\Google1.jmx ==> D:\apache-jmeter-2.13\demo\report\jtl\TestReport201509141114.jtl [jmeter] Creating summariser <summary> [jmeter] Created the tree successfully using D:\apache-jmeter-2.13\demo\Google1.jmx [jmeter] Starting the test @ Mon Sep 14 23:14:32 CST 2015 (1442243672984) [jmeter] Waiting for possible shutdown message on port 4445 [jmeter] summary + 1 in 1s = 1.9/s Avg: 248 Min: 248 Max: 248 Err: 1 (100.00%) Active: 1 Started: 1 Finished: 0 [jmeter] summary + 5 in 1s = 7.8/s Avg: 119 Min: 107 Max: 137 Err: 0 (0.00%) Active: 0 Started: 1 Finished: 1 [jmeter] summary = 6 in 1.2s = 5.2/s Avg: 140 Min: 107 Max: 248 Err: 1 (16.67%) [jmeter] Tidying up ... @ Mon Sep 14 23:14:34 CST 2015 (1442243674232) [jmeter] ... end of run [jmeter] Executing test plan: D:\apache-jmeter-2.13\demo\测试百度.jmx ==> D:\apache-jmeter-2.13\demo\report\jtl\TestReport201509141114.jtl [jmeter] Creating summariser <summary> [jmeter] Created the tree successfully using D:\apache-jmeter-2.13\demo\测试百度.jmx [jmeter] Starting the test @ Mon Sep 14 23:14:35 CST 2015 (1442243675376) [jmeter] Waiting for possible shutdown message on port 4445 [jmeter] summary + 1 in 0.5s = 2.1/s Avg: 196 Min: 196 Max: 196 Err: 0 (0.00%) Active: 1 Started: 1 Finished: 0 [jmeter] summary + 5 in 1s = 8.4/s Avg: 113 Min: 107 Max: 133 Err: 0 (0.00%) Active: 0 Started: 1 Finished: 1 [jmeter] summary = 6 in 1.1s = 5.6/s Avg: 126 Min: 107 Max: 196 Err: 0 (0.00%) [jmeter] Tidying up ... @ Mon Sep 14 23:14:36 CST 2015 (1442243676535) [jmeter] ... end of run report: [xslt] Processing D:\apache-jmeter-2.13\demo\report\jtl\TestReport201509141114.jtl to D:\apache-jmeter-2.13\demo\report\html\TestReport201509141114.html [xslt] Loading stylesheet D:\apache-jmeter-2.13\extras\jmeter-results-detail-report_21.xsl [copy] Copying 2 files to D:\apache-jmeter-2.13\demo\report\html BUILD SUCCESSFUL Total time: 5 seconds
3、测试报告目录:D:\apache-jmeter-2.13\demo\report\html,其中有一个红色失败的案例是我故意设置失败,以便查看的。
四:最后,说一个我在使用过程中碰到一个问题,上面build.xml文件第29行有一句必须要加上:<property name="jmeter.save.saveservice.output_format" value="xml"/>,否则会报如下的错误:
report:
[xslt] Processing D:\Tools\apache-jmeter-2.13\demo\report\jtl\TestReport201509210923.jtl to D:\Tools\apache-jmeter-2.13\demo\report\html\TestReport201509210923.html
[xslt] Loading stylesheet D:\Tools\apache-jmeter-2.13\extras\jmeter-results-detail-report_21.xsl
[xslt] : Error! 前言中不允许有内容。
[xslt] : Error! com.sun.org.apache.xml.internal.utils.WrappedRuntimeException: 前言中不允许有内容。
[xslt] Failed to process D:\Tools\apache-jmeter-2.13\demo\report\jtl\TestReport201509210923.jtl
因为不加上这一句,生成的.jtl文件是文本文件不是xml文件,使用xsl去转换.jtl文件时就会报错。
==============================更新补充======================================
一、本文目的:
之前写了两篇文章搭建持续集成接口测试平台(Jenkins+Ant+Jmeter)和ANT批量执行Jmeter脚本,功能实现上都没有什么问题,但是最后生成的报告有一点小问题,虽然不影响使用,但总是感觉不够完美,具体问题如下:
1、Date report这里的时间没有正确显示出来
2、Summary里的字段Min Time和Max Time显示的是NaN,没有显示正确的时间。
本文主要解决上述两个问题,具体报告如何生成可参考上面提到的两篇文章。
二、Jmeter+Ant报告生成原理:
在解决问题之前,让我们先弄清楚Jmeter+Ant是生成报告的原理,知道原理后我们就可以很从容的解决问题了。另外,如果后续我们想定制报告也就很容易了。
1、在Jmeter的extras目录下,官方已经为我们提供了一个现成的实例,我们只需要在该目录下执行ant命令就可以生成一个数据文件Test.jtl和一个报告Test.html(PS:如果没有安装ant需要先去安装,不会用ant的自行百度)。
2、知道了上一步后,接下来我们研究的重点就是extras目录下的build.xml文件了,具体研究细节就不在此细说了,因为这就部分内容属于ant的范围,有需要的可以自行补充下ant的知识。
三、解决问题:
1、找到extras目录下build.xml文件内容的如下部分:它的作用就是把生成的.jtl数据文件转换为.html格式的报告
具体属性的含义:
- in:生成的.jtl文件的路径
- out:生成的.html文件的路径
- style:从.jtl转换成.html所使用的样式,这些文件也在extras目录下,这个是最重要的部分,如果我们想定制报告可以自行定义这个文件或者从网上找一些合适的文件。
- param:参数,这几个参数可以在style中使用,下面会讲到。
- path:添加jar包的路径,在下面的target中有引用到(下面第9行)。
1 <path id="xslt.classpath">//jar的路径 2 <fileset dir="${lib.dir}" includes="xalan*.jar"/> 3 <fileset dir="${lib.dir}" includes="serializer*.jar"/> 4 </path> 5 //把生成的.jtl数据文件转换成.html格式的报告 6 <target name="xslt-report" depends="_message_xalan"> 7 <tstamp><format property="report.datestamp" pattern="yyyy/MM/dd HH:mm"/></tstamp> 8 <xslt 9 classpathref="xslt.classpath" 10 force="true" 11 in="${testpath}/${test}.jtl" 12 out="${testpath}/${test}.html" 13 style="${basedir}/jmeter-results-detail-report${style_version}.xsl"> 14 <param name="showData" expression="${show-data}"/> 15 <param name="titleReport" expression="${report.title}"/> 16 <param name="dateReport" expression="${report.datestamp}"/> 17 </xslt> 18 </target>
2、通过上面的分析,style 文件是整成报告转换的关键,那我们就打开jmeter-results-detail-report_21.xsl这个文件看看,找到如下几行,这里也定义了三个参数跟build.xml文件中一样,由此可猜测,我们只要在build.xml文件中定义dateReport这个参数和值,在style中就可以按如下方式使用,经过测试证明猜测是正确的,那么第一个问题就解决了:
1 <xsl:param name="showData" select="'n'"/> 2 <xsl:param name="titleReport" select="'Load Test Results'"/> 3 <xsl:param name="dateReport" select="'date not defined'"/>
3、对于第二个问题,其实把第1步中的代码复制到我们自己的build.xml文件中后,可以一并解决这两个问题。解决第二个总是的关键代码是第9行和第10行:
classpathref="xslt.classpath"
force="true"
而第9行又引用了第1~4行
4、到此,两个问题都解决了,最终修改后的build.xml文件如下,标黄是解决总是添加的代码:
<?xml version="1.0" encoding="UTF-8"?> <project name="ant-jmeter-test" default="run" basedir="."> <!-- 需要改成自己本地的 Jmeter 目录--> <property name="jmeter.home" value="/Users/Tools/Jmeter" /> <property name="report.title" value="接口测试"/> <!-- jmeter生成jtl格式的结果报告的路径--> <property name="jmeter.result.jtl.dir" value="/Users/Desktop/jmx/report" /> <!-- jmeter生成html格式的结果报告的路径--> <property name="jmeter.result.html.dir" value="/Users/Desktop/jmx/report" /> <!-- 生成的报告的前缀--> <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}"> <!-- 声明要运行的脚本"*.jmx"指包含此目录下的所有jmeter脚本--> <testplans dir="/Users/Desktop/jmx" 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-detail-report_21.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>
5、修改后的报告:
===================以下内容为原创============================================
=============================build.xml(包括了发送邮件的配置)=====================================
ANT发送邮件需要依赖3个包,分别是:activation.jar和mail.jar,commons-email-1.2.jar 放入ant_home下的lib文件夹中。
<?xml version="1.0" encoding="UTF-8"?>
<project name="ant-jmeter-test" default="run" basedir=".">
<tstamp>
<format property="reporttime" pattern="yyyyMMddhhmm" />
</tstamp>
<!-- 需要改成自己本地的 Jmeter 目录-->
<property name="jmeter.home" value="D:\apache-jmeter-2.11_Include_Plugs" />
<property name="mail_to" value="test1@sohu.com,test2@sohu.com"/>
<property name="report.title" value="接口测试报告"/>
<property name="ComputerName" value="Lenovo-PC"/>
<!-- jmeter生成jtl格式的结果报告的路径-->
<property name="jmeter.result.jtl.dir" value="D:\123\ant_demo\Report\jtl" />
<!-- jmeter生成html格式的结果报告的路径-->
<property name="jmeter.result.html.dir" value="D:\123\ant_demo\Report\html" />
<!-- 生成的报告的前缀-->
<property name="ReportName" value="TestReport" />
<property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}${reporttime}.jtl" />
<property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}${reporttime}.html" />
<target name="run">
<antcall target="test" />
<antcall target="report" />
<antcall target="sendEmail" />
</target>
<target name="test">
<taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" />
<jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
<!-- 声明要运行的脚本"*.jmx"指包含此目录下的所有jmeter脚本-->
<testplans dir="D:\123\ant_demo" includes="*.jmx" />
<property name="jmeter.save.saveservice.output_format" value="xml"/>
</jmeter>
</target>
<target name="sendEmail">
<mail from="test@sohu.com" tolist="${mail_to}" mailhost="smtp.sohu.com" mailport="25" user="test@sohu.com" password="12345678" subject="Test Report">
<!--filesetdir="${JMeter.home}/extras/">
<includename="${ReportName}${time}.html"/>
</fileset-->
<message>
This email was sent automatically by ANT. <br />
Please check the automation test report by the link below. <br />
If there are any questions, please contact with Test. Thank you!<br /><br />
http://${ComputerName}/${ReportName}${reporttime}.html
</message>
</mail>
</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:ss" />
</tstamp>
<xslt classpathref="xslt.classpath" force="true" in="${jmeter.result.jtlName}" out="${jmeter.result.htmlName}" style="${jmeter.home}/extras/jmeter-results-detail-report_21.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>
===============================生成报告使用的命令是===============================
生成报告使用的命令是:
D:\apache-jmeter-2.11_Include_Plugs\lib\ext>java -jar CMDRunner.jar --tool Reporter --input-jtl d:/123/testwlh.jtl --plugin-type TransactionsPerSecond --generate-png report-transac
tionPerSec.png
INFO 2016-06-30 13:04:26.221 [kg.apc.j] (): Using JMeterPluginsCMD v. 1.2.0
INFO 2016-06-30 13:04:26.352 [jmeter.u] (): Setting Locale to zh_CN
INFO 2016-06-30 13:04:26.624 [kg.apc.j] (): Loading user properties from: D:\apache-jmeter-2.11_Include_Plugs\bin\user.properties
INFO 2016-06-30 13:04:26.657 [kg.apc.j] (): Loading system properties from: D:\apache-jmeter-2.11_Include_Plugs\bin\system.properties
INFO 2016-06-30 13:04:27.658 [jmeter.s] (): Testplan (JMX) version: 2.2. Testlog (JTL) version: 2.2
INFO 2016-06-30 13:04:27.674 [jmeter.s] (): Using SaveService properties file encoding UTF-8
INFO 2016-06-30 13:04:27.694 [jmeter.s] (): Using SaveService properties version 2.6
INFO 2016-06-30 13:04:27.704 [jmeter.s] (): Using SaveService properties file version 1554411
INFO 2016-06-30 13:04:27.710 [jmeter.s] (): All converter versions present and correct
INFO 2016-06-30 13:04:27.721 [jmeter.s] (): d:/123/testwlh.jtl does not appear to have a valid header. Using default configuration.
INFO 2016-06-30 13:04:27.723 [jmeter.s] (): Note: Sample TimeStamps are START times
INFO 2016-06-30 13:04:27.723 [jmeter.s] (): sampleresult.default.encoding is set to ISO-8859-1
INFO 2016-06-30 13:04:27.725 [jmeter.s] (): sampleresult.useNanoTime=true
INFO 2016-06-30 13:04:27.727 [jmeter.s] (): sampleresult.nanoThreadSleep=5000
INFO 2016-06-30 13:04:27.783 [jmeter.s] (): List of sample_variables: []
INFO 2016-06-30 13:04:27.790 [kg.apc.c] (): Saving PNG to D:\apache-jmeter-2.11_Include_Plugs\lib\ext\report-transactionPerSec.png
===========================================================================================================
testwlh.jtl是在进行检测的时候自己配置的,--plugin-type后面跟的参数是jmeter中的JMeterPlugins-Standard.jar包里的kg.apc.jmeter.vizualizers.*里面的类,规律是找到Gui结尾的类,把这个类名中的Gui去掉,就是--plugin-type后面紧跟的名字了。