上一篇讲了Jmeter 接口自动化 - 脚本数据分离实例，我们知道怎么利用 Jmeter 去编写接口自动化脚本，但是接口自动化测试单有脚本是不够的，我们还需要批量跑指定接口，生成接口运行报告，定位报错接口，接口定时任务，邮件通知等功能。
批量跑指定接口：我们可以利用 ant 批量跑指定目录下的 Jmeter 脚本
生成接口运行报告：使用 Jmeter(extras 目录下) 自带的jmeter-results-detail-report_21.xsl样式文件
定位报错接口：使用扩展的jmeter-results-shanhe-me.xsl(可自行下载，我 git 地址也放了) 样式文件，输出的信息比自带的jmeter-results-detail-report_21.xsl多
接口定时任务：使用 Jenkins 的 build periodically 完成
邮件通知：使用 Jenkins 的 Extended E-mail Notification 插件
顺序从 Jmeter-》Jmeter+ant-》Jmeter+ant+Jenkins 穿插原理，逐渐过渡，二中讲的是基础 (可跳过)，三讲的是实践，遇到的问题以及扩展。
1、E:\sample 下有 sample.jmx 的脚本文件
2、追加 E:\apache-jmeter-2.13\bin 到 path 环境变量后
环境变量配置成功验证-》dos 中输入 jmeter，windows 会直接打开 jmeter
3、Dos 命令：
cd /d e:
cd sample
jmeter -n -t sample.jmx -l log.jtl
-n 这是指定 JMeter 在非用户界面模式运行
-t 包含测试计划的 JMX 文件的名字
-l 记录取样结果的 JTL 文件的名字
这里要讲两句，我们做接口自动化还好，要是用 Jmeter 做负载测试时，建议写好性能脚本后，用 NON GUI 模式进行负载测试，即非图形化界面，也就是建议使用命令行运行！因为图形化界面会消耗资源，导致负载测试结果不精确，特别是用图形化界面时还把查看结果树给打开，查看结果树输出的结果很多，所以，写完负载测试脚本后尽量把查看结果树等调试插件给禁掉。
我们启动 Jmeter3.0 以上版本，也有建议不要使用图形化界面进行负载测试的提示：
翻译：不要使用 GUI 模式进行负载测试，只用于测试创建和测试调试！
1、下载 ant 后在 window 中设置 ant 环境变量：
ANT_HOME 新建：E:\Program Files\apache-ant-1.7.1
path 追加：%ANT_HOME%\bin
环境变量配置成功验证-》dos 中输入 ant，提示：Buildfile: build.xml does not exist!
2、将 JMeter 所在目录下 extras 子目录里的 ant-JMeter-1.1.1.jar 复制到 Ant 所在目录 lib 子目录之下，这样 Ant 运行时才能找到"org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"这个类，从而成功触发 JMeter 脚本
3、jmeter 默认保存的是.csv 格式的文件，所以我们先要设置一下 bin/jmeter.properties 文件内容，保存
jmeter.save.saveservice.output_format=xml
4、主要逻辑思路：
E:\jmeter\build 下有 build_smoke_report.xml 文件
运行 E:\jmeter\script_smoke 下面的.jmx 脚本，生成.jtl 文件放入 E:\jmeter\report_smoke 文件中
然后 ant 再利用指定的.xsl 文件 (build_smoke_report.xml 定义) 去解析.jtl 文件，生成对应的 html 文件放入 E:\jmeter\report_smoke 中。
简写就是：跑完结果后，.xsl 文件把.jtl 文件转化成直观的 html 报告。
PS：XSL 是什么
XSL 是可扩展样式表语言（eXtensible Stylesheet Language）的外语缩写，是一种用于以可读格式呈现 XML（标准通用标记语言的子集）数据的语言。
易懂一点的说法：XSL 可描述如何来显示 XML 文档，XSL 之于 XML,就像 CSS 之于 HTML。
build_smoke_report.xml 文件中的内容如下：
<?xml version="1.0" encoding="UTF-8"?>
<project name="ant-jmeter-test" default="run" basedir=".">
<tstamp>
<format property="time" pattern="_yyyy_MMdd_HHmmss" />
</tstamp>
<!-- 需要改成自己本地的 Jmeter 目录-->
<property name="jmeter.home" value="E:\apache-jmeter-2.13" />
<property name="report.title" value="接口测试"/>
<!-- jmeter生成jtl格式的结果报告的路径-->
<property name="jmeter.result.jtl.dir" value="E:\jmeter\report_smoke" />
<!-- jmeter生成html格式的结果报告的路径-->
<property name="jmeter.result.html.dir" value="E:\jmeter\report_smoke" />
<property name="detail" value="_detail" />
<!-- 生成的报告的前缀-->
<property name="ReportName" value="SmokeReport" />
<property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}${time}.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="E:\jmeter\script_smoke" 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>
Dos 切换到 E:\jmeter\build 目录下运行：ant –f build_smoke_report.xml
提示：BUILD SUCCESSFUL 代表 build_smoke_report.xml 文件运行成功
E:\jmeter\script_smoke 目录下会生成.jtl 和.html 文件
1、 命令行切换到 jenkins.war 的根目录，输入 java -jar jenkins.war
2、 浏览器输入地址http://localhost:8080显示界面，安装成功
3、新建一个构建自由风格的软件项目并配置
4、设置定时任务，这里是设置每周一到周五的 8 点 30 分运行次 JOB。
定时构建语法：
- * * * * *(五颗星，中间用空格隔开）
第一颗*表示分钟，取值 0~59
第二颗*表示小时，取值 0~23
第三颗*表示一个月的第几天，取值 1~31
第四颗*表示第几月，取值 1~12
第五颗*表示一周中的第几天，取值 0~7，其中 0 和 7 代表的都是周日
4、构建->增加构建步骤->Invoke Ant->高级 (需要去 Jenkins 的系统配置->Global Tool Configuration 配置 ant 的地址)，Build File 中输入 E:\jmeter\build\build_smoke_report.xml，保存
5、立即构建，运行成功，查看 console output 控制台输入的日志
出现 BUILD SUCCESSFUL 表示编译成功，跟 dos 运行 ant –f build_smoke_report.xml 效果一样
<jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
<!-- 声明要运行的脚本"*.jmx"指包含此目录下的所有jmeter脚本-->
<testplans dir="E:\jmeter\script_smoke" includes="*.jmx" />
<property name="jmeter.save.saveservice.output_format" value="xml"/>
</jmeter>
改成
<jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
<!-- 声明要运行的脚本"*.jmx"指包含此目录下的所有jmeter脚本-->
<testplans dir="E:\jmeter\script_smoke" includes="*.jmx" />
<testplans dir="E:\jmeter\script_smoke_two" includes="*.jmx" />
<property name="jmeter.save.saveservice.output_format" value="xml"/>
</jmeter>
我这里是生成两个，一个简单的汇总报告，一个详细的报告 (用于定位接口报错)
build_smoke_report.xml 文件只利用 jmeter-results-detail-report_21.xsl 生成了一个 html 报告，想利用 jmeter-results-shanhe-me.xsl 生成第二个
添加属性值
<property name="detail" value="_detail" />
<property name="jmeter.result.jtlNamedetail" value="${jmeter.result.jtl.dir}/${ReportName}${time}.jtl" />
<property name="jmeter.result.htmlNamedetail" value="${jmeter.result.html.dir}/${ReportName}${time}${detail}.html" />
并且将
<target name="report">
<tstamp> <format property="report.datestamp" pattern="yyyy/MM/dd HH:mm" /></tstamp>
<xslt
classpathref="xslt.classpath"
force="true"
in="${jmeter.result.jtlNamedetail}"
out="${jmeter.result.htmlNamedetail}"
style="${jmeter.home}/extras/jmeter-results-shanhe-me.xsl">
<param name="dateReport" expression="${report.datestamp}"/>
</xslt>
改为
<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>
<xslt
classpathref="xslt.classpath"
force="true"
in="${jmeter.result.jtlNamedetail}"
out="${jmeter.result.htmlNamedetail}"
style="${jmeter.home}/extras/jmeter-results-shanhe-me.xsl">
<param name="dateReport" expression="${report.datestamp}"/>
</xslt>
如果知道 XML 的一些语法，应该一下就能看明白，我们只是加了一个标签，然后把里面用到的属性值定义好。好吧，不懂 XML 语法也能看懂，哈哈。
PS:
使用 jmeter-results-shanhe-me.xsl 的一些前置操作
1、下载 style 文件：jmeter.results.shanhe.me.xsl
2、把下载的文件放到 jmeter 的 extras 目录下。
3、修改 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
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
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
其实 XSL 语法跟 XML 挺像的，多看看我们可以进行定制，如定义接口排序，扩展性能指标，那样我们性能测试也能利用这个生成报告，响应时间超过 3 秒的接口标黄显示，直观显示接口响应的性能状态，主要还是看公司的业务需求。
我会把扩展后的 XSL 也放到 git 地址，有需要的可以参考。
我们会用到两个插件，可到 Jenkins 的系统管理-》管理插件-》可选插件中搜索安装
安装好 HTML Publisher plugin 之后，会在新建或者编辑项目时，在【增加构建后操作步骤】出现【Publish HTML reports】的选项
这样我们就可以在 Jenkins 中进行接口自动化测试报告的查看
安装好 Performance plugin 之后，会在新建或者编辑项目时，在【增加构建后操作步骤】出现【Publish Performance test result report】的选项
仔细的朋友可以发现，我们使用 HTML Publisher plugin 用到了 html 文件，并且目录是指定的，难道每次每次生成的接口测试结果都要被覆盖？不存在的，当一个接口变动时，可通过接口历史响应，判断接口性能变化。使用 HTML Publisher plugin 用到了 jtl 文件名字是指定的，难道也要覆盖？也不存在的，这里放一下我的解决方案。
timestamp=`date +%Y%m%d%H%M%S`
pwd
rm -f ./*.html
mkdir /jmeter/report/$timestamp
cp /jmeter/report/*.jtl /jmeter/report/$timestamp/
cp /jmeter/report/*.html /jmeter/report/$timestamp/
cp /jmeter/report/R*.html ./
rm -f /jmeter/report/latest/*.jtl
rm -f /jmeter/report/latest/*.html
cp /jmeter/report/*.jtl /jmeter/report/latest/
cd /jmeter/report/latest
mv -f *.jtl latest.jtl
rm -f /jmeter/report/*.jtl
mv -f /jmeter/report/*.html /jmeter/report/latest
思路：每次生成的两个 html 文件和 jtl 文件都放到类似 20170831102019(时间戳) 的目录下，保证每次的接口测试结果都能保存。
结果保存了，但是每次的 jtl 文件名字是不一样的，就算把 jtl 文件名字改成一致的，目录也是不同的，于是我们新建了一个 latest 目录，每次执行接口测试都保证 latest 目录的 html 和 jtl 文件是最新的，并且把 jtl 文件的名字改成 latest.jtl，完美达到我们的要求。只要思想不滑坡，办法总比困难多
。
说到这里，会有一个问题，就是 Jenkins 默认不显示 html 的 CSS 样式，所以界面很丑，如图：
网上一致的解决方法：jenkins->系统管理->脚本命令行，执行命令：
System.setProperty("hudson.model.DirectoryBrowserSupport.CSP","sandbox allow-scripts; default-src 'none';script-src 'unsafe-inline' http://code.jquery.com/jquery-2.1.0.min.js; img-src dohko.hpeswlab.net 'self' data: ; style-src 'unsafe-inline' 'self';");
或 System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")
重新运行下 job 生成 html，就会正常显示。
但是，每次重启 Jenkins，都需要再运行一次，咋搞，不太智能。
我们理解一下网上解决方法的原理，就是执行一段 Groovy script，并且要在 JOB 开始前执行，然后我们知道有个 Groovy plugin，可以执行 Groovy 脚本，那么，我们，就。。。搞起来
html 报告显示正常的结果：
1.开通 163 的 SMTP 服务，需要发一条短信，163 会给让你设置一个密码（不是你的 163 邮箱密码哦）
2.安装 Email Extension Plugin 插件
3.进入系统管理 -- 系统设置
注意自带邮箱插件->邮件通知 对应插件 E-mail Notification 的配置
扩展插件->Extended E-mail Notification 对应插件 Editable Email Notification 的配置
系统设置中邮件通知和 Extended E-mail Notification(配置项多一些) 的配置基本一致
JOB 页面使用 Extended E-mail Notification 插件的配置图：
按需整理好后会把用到的 build.xml，扩展的 xsl 和 Jenkins 中 JOB 的 config.xml 放到 git 地址
https://github.com/grizz/jmeter-master
欢迎交流指正，感谢阅读。
