接口测试 学习笔记:Jmeter+ant+Jenkins 持续集成平台 (上)

大海 · March 26, 2020 · Last by 活着丶 replied at March 28, 2020 · 569 hits

背景介绍

  • 批量跑指定接口:我们可以利用ant批量跑指定目录下的Jmeter脚本
  • 生成接口运行报告:使用Jmeter(extras目录下)自带的jmeter-results-detail-report_21.xsl样式文件
  • 定位报错接口:使用扩展的jmeter-results-shanhe-me.xsl样式文件,输出的信息比自带的jmeter-results-detail-report_21.xsl多
  • 接口定时任务:使用Jenkins的build periodically完成
  • 邮件通知:使用Jenkins的Extended E-mail Notification插件

1、Jmeter

1.1、下载安装包

下载地址:https://jmeter.apache.org/download_jmeter.cgi

1.2、配置环境变量
  • JMETER_HOME 为 Jmeter安装路径;
  • CLASSPATH为 %JMETER_HOME%\lib;
  • Path为%JMETER_HOME%\bin;
1.3、安装验证

在命令窗口中输入jmeter -v回车,能出现Jmeter版本则说明配置成功

eg: jmeter -n -t sample.jmx -l log.jtl

  • -n 这是指定JMeter在非用户界面模式运行
  • -t 包含测试计划的JMX文件的名字
  • -l 记录取样结果的JTL文件的名字

2、Jmeter+ANT

2.1、下载地址

http://ant.apache.org/bindownload.cgi,下载后解压到指定位置即可。

2.2、配置环境变量

下载ant后在windows中设置ant环境变量

  • ANT_HOME 为 ant解压位置
  • CLASSPATH为 %ANT_HOME%\lib;
  • Path为%ANT_HOME%\bin;
2.3、安装验证
  • 环境变量配置成功验证->dos中输入ant,提示:Buildfile: build.xml does not exist!

  • 验证安装结果,命令行输入ant -v,出现版本信息,则安装成功。

2.4、安装路径

将JMeter所在目录下extras子目录里的ant-jmeter-1.1.1.jar复制到Ant所在目录lib子目录之下,这样Ant运行时才能找到"org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"这个类,从而成功触发JMeter脚本。

2.5、设置格式

jmeter默认保存的是.csv格式的文件,所以我们先要设置一下bin/jmeter.properties文件内容,保存jmeter.save.saveservice.output_format=xml。

2.6、主要思路

在目录D:\apache-ant-1.9.14下,我们需要先新建一个空的.xml,比如我新建为:uat_parets_build.xml。

2.7、更新路径

xml模版内容中,对应的路径和脚本,需要按照你自己的实际存放目录去更换。

<?xml version="1.0" encoding="UTF-8"?>

<project name="ant-jmeter-test" default="run" basedir=".">
<property environment="env"/>
<tstamp>
<format property="time" pattern="yyyyMMddhhmm" />
</tstamp>
<!-- 需要改成自己本地的 Jmeter 目录-->
<property name="jmeter.home" value="D:\apache-jmeter-5.2.1" />
<!-- 本地存放报告的路径-->
<property name="basedirectory" value="D:\XX_BenchmarkTesting\parents\report_csv\uat_report_parent" />
<!-- 本地存放脚本的路径-->
<property name="scriptdirectory" value="D:\XX_BenchmarkTesting\parents\scripts" />
<!-- jmeter生成jtl格式的结果报告的路径-->
<property name="jmeter.result.jtl.dir" value="D:\XX_BenchmarkTesting\parents\jtl" />
<!-- jmeter生成html格式的结果报告的路径-->
<property name="jmeter.result.html.dir" value="D:\XX_BenchmarkTesting\parents\html" />
<!-- 生成的报告的前缀-->
<property name="ReportName" value="uat_parent_TestReport" />
<property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}.jtl" />
<property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}${time}.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="D:\XX_BenchmarkTesting\parents\scripts" 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>

3、开始运行

3.1、运行脚本

D:\XX_BenchmarkTesting\parents\scripts下面的.jmx脚本,生成.jtl文件放入 D:\XX_BenchmarkTesting\parents\jtl文件夹中。

3.2、新建文件夹

jtl和html是我自己新建的2个空文件夹,专门是用于存放生成的.jtl和.html文件。

3.3、运行逻辑

然后ant再利用指定的.xsl文件(uat_parets_build.xml定义)去解析.jtl文件,生成的.html文件放在D:\XX_BenchmarkTesting\parents\html文件夹中,简写就是:跑完结果后,.xsl文件把.jtl文件转化成直观的html报告。

3.4、具体操作

CMD切换到D:\apache-ant-1.9.14目录下运行:ant -f uat_parets_build.xml,提示:BUILD SUCCESSFUL,则代表uat_parets_build.xml文件运行成功。jtl和hetml目录下,会自动生成.jtl和.html文件。

3.5、测试报告

4、优化测试报告

4.1、如何优化

自带的报告不太直观,因为用jmeter自带的测试报告得到的测试报告信息并不是很全,下面讲一下怎么优化测试报告。

4.2、下载模版

下载优化模板 jmeter-results-shanhe-me.xsl,拷贝到jmeter的extras目录中,下载style文件:jmeter.results.shanhe.me.xsl(http://shanhe.me/download.php?file=jmeter.results.shanhe.me.xsl)。

4.3、修改jmeter.properties

修改jmeter.properties文件如下部分,我这里都修改成true,这样执行完脚本后就会保存这些结果到.jtl文件里面,重启jmeter生效。

jmeter.save.saveservice.data_type=true
jmeter.save.saveservice.label=true
jmeter.save.saveservice.response_code=true
# response_data is not currently supported for CSV output
jmeter.save.saveservice.response_data=true
# Save ResponseData for failed samples
jmeter.save.saveservice.response_data.on_error=false
jmeter.save.saveservice.response_message=true
jmeter.save.saveservice.successful=true
jmeter.save.saveservice.thread_name=true
jmeter.save.saveservice.time=true
jmeter.save.saveservice.subresults=true
jmeter.save.saveservice.assertions=true
jmeter.save.saveservice.latency=true
# Only available with HttpClient4
jmeter.save.saveservice.connect_time=true
jmeter.save.saveservice.samplerData=true
jmeter.save.saveservice.responseHeaders=true
jmeter.save.saveservice.requestHeaders=true
jmeter.save.saveservice.encoding=false
jmeter.save.saveservice.bytes=true
# Only available with HttpClient4
jmeter.save.saveservice.sent_bytes=true
jmeter.save.saveservice.url=true
jmeter.save.saveservice.filename=true
jmeter.save.saveservice.hostname=true
jmeter.save.saveservice.thread_counts=true
jmeter.save.saveservice.sample_count=true
jmeter.save.saveservice.idle_time=true

4.4、替换xsl文件

接下来,我们还需要将原来.xml文件中的jmeter-results-detail-report_21.xsl,替换为jmeter-results-shanhe-me.xsl。

4.5、优化后的报告

优化后的测试报告样式如下

如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
共收到 6 条回复 时间 点赞

用maven是不是会更好

大海 #2 · March 27, 2020 作者
jacksboy 回复

大同小异,满足工作需要就行

昨天刚搭好jenkins,正好看看,先评论,后阅读😀

活着丶 回复

看完了,只是本地的,不是服务器上的,EMMMM,学不来了

大海 #5 · March 27, 2020 作者
活着丶 回复

我就是在本地,没搭在服务器上。

大海 回复

服务器上一堆问题😭

需要 Sign In 后方可回复, 如果你还没有账号请点击这里 Sign Up