Linux下利用Ant調用Jmeter腳本生成HTML測試報告

今天咱們學習如何利用Ant調用Jmeter腳本，並將生成的 jtl 文件轉換爲 HTML 格式的測試報告。

準備工做

須要在Linux上提早安裝好 JDK、 Jmeter 和 Ant。

1，JDK（可參考文章：Linux下安裝JDK 1.8）
2，Jmeter（可參考文章：Linux下安裝Jmeter）
3，Ant（可參考文章：Linux下安裝Ant）

在Linux上新建如下目錄（根據本身實際狀況處理）：

[root@wintest ~]# mkdir /root/demo
[root@wintest ~]# mkdir /root/demo/jmeter_script
[root@wintest ~]# mkdir /root/demo/result
[root@wintest ~]# mkdir /root/demo/result/html
[root@wintest ~]# mkdir /root/demo/result/jtl
[root@wintest ~]# cd /root/demo
[root@wintest demo]#

其中，jmeter_script 用於存放Jmeter的測試腳本（jmx文件），result 用於存放測試結果，其子文件夾 html 和 jtl 分別用於存放生成的HTML測試報告和jtl文件。

準備一個 Jmeter 的測試腳本，並放到jmeter_script 下。此時，若是直接在 /root/demo 目錄下執行 ant 命令，會出現報錯提示 build.xml 不存在：

[root@wintest demo]# ant
Buildfile: build.xml does not exist!
Build failed
[root@wintest 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結構以下：

[root@wintest demo]# ls
build.xml  jmeter_script  result
[root@wintest demo]# tree
.
├── build.xml
├── jmeter_script
│   └── ant_jmeter_test.jmx
└── result
    ├── html
    └── jtl

4 directories, 2 files
[root@wintest 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測試報告。

[root@wintest 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
[root@wintest demo]#

將測試報告傳到Windows，在瀏覽器中查看HTML報告，以下：