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報告，如下：