首页 > 代码库 > 六:Listener

六:Listener

参考:http://jmeter.apache.org/usermanual/listeners.html

Listener是用来展示Sampler结果的元件。

结果可以被展示在树、表格、图表或者简单写入到一个log文件。

看所有Sampler的具体内容,可使用的Listeners:"View Results Tree" 或者 "View Results in table"。

如果Sample很多的话,Listener可能会用掉很多内存。如果想最小化使用的内存量,可以使用 Simple Data Writer,并且使用CSV格式。

输出到文件

不同的Listener以不同的方式来展示响应信息。然而,不同的listener写入到输出文件的数据是相同的。

技术分享

1. 输出文件路径

Filename:可以输入相对路径,也可以输入绝对路径。

相对路径是相对于当前工作路径,一般默认是“Jmeter安装路径\bin\”。比如,直接在Filename中输入log,则“Jmeter安装路径\bin\”下会出现一个文件为log。

相对路径也可以是相对于当前测试计划的路径。如果filename以“~/”开始,说明是相对于JMX文件位置的路径。比如输入”~/log“,当前测试计划路径为“E:\TestPlan3.jmx”,则输出文件路径为“E:\log”。

如果想使用除了“~/”的前缀,可以在jmeter.properties中定义。比如下面定义为“#/”,则filename输入“#/log”即可。

# Prefix used to identify filenames that are relative to the current base
#jmeter.save.saveservice.base_prefix=~/
jmeter.save.saveservice.base_prefix=#/

2. 输出文件类型

在jmeter.properties中可以直接定义输出的文件默认类型。

# legitimate values: xml, csv, db.  Only xml and csv are currently supported.
#jmeter.save.saveservice.output_format=csv

也可以点击 Configure按钮,直接勾选中“Save As XML”保存文件为XML类型。

技术分享

CSV文件比XML文件小很多,所以如果产生很多sample的话,建议使用CSV。

如果想输出最多的信息,我们需要选择保存文件为xml,并且在Test Plan中勾上 “Functional Test Mode”。

“Functional Test Mode”不勾上的话,默认存储:time stamp, the data type, the thread name, the label, the response time, message, code, a success indicator。

“Functional Test Mode”勾上的话,所有的信息,包括整个响应数据都会被存储下来。参见XML中 responseData。

3. 输出文件的内容

点击Configure,可以配置需要输出的内容。

带有(CSV)后缀的项,只能应用于CSV格式的文件。

带有(XML)后缀的项,只能应用于XML格式的文件。

Sample Result Save Configuration默认选中项参见jmeter.properties的配置。

技术分享

查看文件

1. CSV格式的文件

CSV显示的列取决于Configure中选中的项。显示顺序如下:

timeStamp - 以milliseconds 为单位,显示自从 1/1/1970以来的时间段
elapsed - 以 milliseconds为单位
label - sampler 标记,一般就是Sampler 名
responseCode - 比如 200, 404
responseMessage - 比如 OK
threadName
dataType - 比如 text
success - true 或者 false
failureMessage - 如果有的话就显示
bytes - sample的字节数
sentBytes - sample发送的字节数
grpThreads -  该 thread group active的线程数
allThreads - 所有组的所有active的线程数
URL
Filename - 使用 Save Response to File 时,文件名
latency - 从第一次 response开始的时间
connect - 从建立连接开始的时间
encoding
SampleCount -  sample 数 (一般是1 ,除非合计了多个sample)
ErrorCount - errors数 (一般是0或1,除非合计了多个sample)
Hostname - 发送 sample的机器名
IdleTime - 以 milliseconds为单位显示 Idle 时间(一般是0)
Variables- 如果定义变量的话,这里就显示变量

2. XML格式的文件

示例如下:

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

     ………… 

    <sample t="0" lt="0" ts="1144372616082" s="true" lb="Example Sampler"  rc="200" rm="OK" tn="Listen 1-1" dt="text" de="ISO-8859-1" by="10">
        <responseHeader class="java.lang.String"></responseHeader>
        <requestHeader class="java.lang.String"></requestHeader>
        <responseData class="java.lang.String">Listen 1-1</responseData>
        <responseFile class="java.lang.String">Mixed2.unknown</responseFile>
        <samplerData class="java.lang.String">ssssss</samplerData>
    </sample> 

</testResults>

每个属性的含义如下:

技术分享

保存Response数据

XML格式的输出文件可以保存Response数据。勾上“Save Response Data(XML)”即可。

然而,这种方式会造成日志文件很大,而且文件必须被编码。同时,这种方式会造成图片不能被保存,只有TEXT格式的sample response可以被保存成功。

想要解决这个问题,我们可以使用 Listener–> Save Responses to a file。使用这个监听之后,系统会对监听范围内的每次请求保存一个html文件。默认保存在“jmeter安装路径/bin/”下。

直接打开已存在的结果文件

如果之前测试已经存在一个CSV或者XML文件,可以直接在Listener中打开。

任选一个Listener,点击filename后的Browse按钮,找到要打开的文件,点击打开即可。

需要注意的是,在加载新的文件时,jmeter并不会清空任何当前数据,而是进行合并。所以如果想清空之前的数据,必须手动清空。

六:Listener