英文文档地址：http://jmeter.apache.org/usermanual/component_reference.html

目录：

18 导言

少数测试元件使用JMeter属性来控制它们的行为。这些属性通常在类被加载时解析。这通常发生在测试计划执行前，所以不能通过__setProperty()函数来改变设置。

18.1 取样器

取样器执行JMeter实际的工作。每个取样器（ 测试活动 除外）生成一个或多个样本结果。样本结果具有各种属性（成功/失败，经过时间，数据大小等），并且可以在各种监听器中查看。

FTP请求

此控制器允许您将FTP“检索文件”或“上传文件”的请求发送到FTP服务器。如果要将多个请求发送到同一FTP服务器，请考虑使用FTP默认请求配置元件，这样您就不必为每个FTP请求生成控制器输入同样的信息。下载文件时，它可以存储在磁盘（本地文件）或响应数据中，或两者都存储。

延迟设置为登录所需的时间。

FTP请求控制面板的截图

参数

另请参阅：

• 断言
• FTP默认请求
• 创建FTP测试计划

【返回目录】

HTTP请求

此取样器允许您将HTTP/HTTPS请求发送到Web服务器。它还允许您控制JMeter解析HTML文件是否包含图像和其他内含的资源，并发送HTTP请求以检索它们。以下类型的内含的资源将被检索：

• 图片
• 小程序
• 样式表（CSS）和从这些文件引用的资源
• 外部脚本
• frames，iframes
• 背景图像（body，table，TD，TR）
• 背景声音

默认解析器是org.apache.jmeter.protocol.http.parser.LagartoBasedHtmlParser。可以通过“ htmlparser.className” 属性来变更 - 详细信息请参阅jmeter.properties。

如果要将多个请求发送到同一Web服务器，请考虑使用HTTP请求默认值配置元件，这样您就不必为每个HTTP请求输入相同的信息。

或者，您可能希望使用JMeter的HTTP代理服务器来创建它们，而不是手动添加HTTP请求。如果您有大量或者包含许多参数的HTTP请求，这可以节省您的时间。

有两种不同的测试元件用于定义取样器：

AJP/1.3 取样器

使用Tomcat mod_jk协议（在AJP模式下不需要Apache httpd就可以测试Tomcat）。AJP取样器不支持多文件上传；只有第一个文件会被上传。

HTTP请求

这有一个实现下拉框，它选择要使用的HTTP协议实现：

• Java

使用JVM提供的HTTP实现。与HttpClient实现相比，它有一些限制 - 见下文。

• HTTPClient4

使用Apache HttpComponents HttpClient 4.x。

• 空值

不设置HTTP取样器的实现方式，所以依赖于HTTP请求默认值（如果存在）或根据jmeter.properties中定义的jmeter.httpsampler属性。

Java HTTP实现有一些限制：

• 无法控制连接的重用方式。当JMeter释放连接时，它可能会也可能不会被同一个线程重用。
• 此API最适合单线程使用 - 各种设置通过系统属性来定义，因此适用于所有连接。
• 不支持Kerberos身份验证。
• 不支持使用Keystore Config进行基于客户端的证书测试。
• 重试机制更方便控制。
• 不支持虚拟主机。
• 仅支持以下方法：GET，POST，HEAD，OPTIONS，PUT，DELETE和TRACE。
• 通过DNS缓存管理器能够更好地控制DNS缓存

注意：FILE协议仅用于测试目的。无论使用哪个HTTP取样器，它都由相同的代码处理。

如果请求需要服务器或代理登录授权（即浏览器将创建弹出对话框），则还必须添加HTTP授权管理器配置元件。对于正常登录（即用户在表单中输入登录信息），您需要确定表单提交按钮的作用，并使用适当的方法（通常是POST）和表单定义中的相应的参数创建HTTP请求。如果页面使用HTTP，则可以使用JMeter代理捕获登录序列。

每个线程使用单独的SSL上下文。如果要共用一个SSL上下文（不是浏览器的标准行为），请设置JMeter属性：

https.sessioncontext.shared=true

默认情况下，从5.0版开始，SSL线程在线程组迭代期间保留，并在每次测试迭代时重置。如果在您的测试计划中同一个用户迭代多次，那么您应该将其设置为false。

httpclient.reset_state_on_thread_group_iteration=true

注意：这不适用于Java HTTP实现。

JMeter默认SSL协议级别为TLS。如果服务器需要不同的级别，例如SSLv3，可以修改JMeter属性，例如：

https.default.protocol=SSLv3

JMeter还允许修改https.socket.protocols属性来启用其他协议。

如果请求使用cookies，那么您还需要一个HTTP Cookie管理器。您可以将这些元件添加到线程组或HTTP请求下。如果您有多个需要授权或使用cookies的HTTP请求，请将元件添加到线程组下。这样，所有HTTP请求控制器将共享相同的授权管理器和Cookie管理器。

如果请求使用“URL重写”技术来保持会话，请参阅 6.1使用URL重写处理用户会话获取其他配置步骤。

HTTP请求控制面板的截图

HTTP请求高级配置字段

参数

"Redirect requested but followRedirects is disabled"

使用自动重定向时，仅对初始URL发送cookies。这可能会导致重定向到本地服务器的网站出现意外行为。例如，如果www.example.com重定向到www.example.co.uk。在这种情况下，服务器可能会返回两个URL的cookies，但JMeter只会接收最后一个主机的cookies，即www.example.co.uk。如果测试计划中的下一个请求使用www.example.com，而不是www.example.co.uk，它将无法获得正确的cookies。同样的，只对初始请求发送信息头，对于重定向则不发送。通常只是手动创建的测试计划会出现这个问题，因为使用记录器创建的测试计划将从重定向的URL继续下去。

参数处理： 对于POST和PUT方法，如果没有要发送的文件，并且省略了参数的名称，则通过连接参数的所有值来创建消息体。注意这些值的连接不会添加任何行尾字符。在值字段中可以使用__char()函数来添加它们。这允许发送任意消息体。如果设置了编码标志，则对值进行编码。另请参阅上面的MIME类型，了解如何控制请求的content-type信息头。
对于其他方法，如果缺少参数的名称，则忽略该参数。这允许使用由变量定义的可选参数。

当请求只有未命名的参数（或根本没有参数）时，您可以选择切换到消息体数据选项卡。此选项在以下情况（以及其他情况）中很有用：

• GWT RPC HTTP请求
• JSON REST HTTP请求
• XML REST HTTP请求
• SOAP HTTP请求

注意一旦离开树节点，除非清除消息体数据标签下的数据，否则无法切换回参数标签。

在消息体数据模式下，除了最后一行之外，每行发送时都将附加CRLF。要在最后一行数据之后发送CRLF，只需确保其后面有空行。（空行虽然看不到，但是可以通过观察光标是否可以放在后续行上看出。）

图1 - 带有一个未命名参数的HTTP请求

图2 - 确认要切换的对话框

图3 - 使用消息体数据的HTTP请求

方法的处理： GET，DELETE，POST，PUT和PATCH请求方法的工作方式类似，除了3.1版本外，只有POST方法支持multipart请求或文件上传。PUT和PATCH方法的消息体必须提供以下之一：

• 将消息体定义为具有空参数名称字段的文件；在这种情况下，MIME类型用作Content-Type
• 将消息体定义为没有名称的参数值
• 使用“ 消息体数据”标签

GET，DELETE和POST方法有一种额外的参数传递方式，就是通过使用参数标签。 GET，DELETE，PUT和PATCH需要Content-Type。如果不使用文件，添加一个信息头管理器到取样器并在那里定义Content-Type。

JMeter扫描内含资源的响应。它使用HTTPResponse.parsers属性，它是一个解析器的ID列表，例如htmlParser，cssParser和wmlParser。对于找到的每个id，JMeter会检查另外两个属性：

• id.types - 内容类型列表
• id.className - 用于提取内含资源的解析器

有关设置的详细信息，请参阅jmeter.properties文件。如果未设置HTTPResponse.parser属性，则JMeter将恢复为先前的行为，即仅扫描text/html响应。

模拟慢速连接：

HttpClient4和Java 取样器支持慢速连接的模拟；请参阅jmeter.properties中的以下条目：

# Define characters per second > 0 to emulate slow connections
#httpclient.socket.http.cps=0
#httpclient.socket.https.cps=0

然而Java取样器仅支持慢速HTTPS连接。

响应大小计算

Java实现不包括传输的开销，例如在响应消息体中的信息头部分。
HttpClient4实现包含整个响应消息体的开销，所以该值可能比在响应内容中包含的字节数更大。

重试处理 默认情况下，HttpClient4和Java实现的重试设置为0，这意味着不会尝试重试。
对于HttpClient4，可以通过设置相关的JMeter属性来设置重试次数，例如：

httpclient4.retrycount=3

使用HC4实现，默认情况下将在幂等的Http方法上进行重试。如果要重试所有方法，请设置属性

java httpclient4.request_sent_retry_enabled=true

注意Java实现在默认情况下也不会重试，您可以通过设置更改它

http.java.sampler.retries=3

注意：证书不符合算法约束 如果您在具有SSL证书（本身或其信任链中的 SSL 证书）的网站上运行HTTPS请求，该证书使用MD2的签名算法（例如md2WithRSAEncryption）或大小小于1024位，您可能会遇到以下错误：java.security.cert.CertificateException: Certificates does not conform to algorithm constraints 。

此错误与Java 8中增强的安全性有关。

要允许您执行HTTPS请求，可以通过编辑Java的jdk.certpath.disabledAlgorithms属性来降低Java安装的安全性等级。根据您的情况，删除MD2值或取消大小约束。

此属性在此文件中：

JAVA_HOME/jre/lib/security/java.security

有关详细信息，请参阅 Bug56357。

另请参阅：

• 断言
• 构建Web测试计划
• 构建高级Web测试计划
• HTTP授权管理器
• HTTP Cookie管理器
• HTTP信息头管理器
• HTML链接解析器
• HTTP代理服务器
• HTTP请求默认值
• HTTP请求和会话ID：URL重写

【返回目录】

JDBC请求

此取样器允许您将JDBC请求（SQL查询）发送到数据库。

在使用之前，您需要设置JDBC Connection Configuration配置元件。

如果提供了“变量名称”列表，则对于Select语句返回的每一行，将使用相应列和对应的行数的值设置变量（如果提供变量名称）。例如，如果Select语句返回2行3列，并且变量列表是A,,C，则将设置以下变量：

A_#=2（行数）
A_1=第1列，第1行
A_2=第1列，第2行
C_#=2（行数）
C_1=第3列，第1行
C_2=第3列，第2行

如果Select语句返回零行，则A_#和C_#变量将设置为0，并且不会设置其他变量。

必要时清除旧变量 - 例如，如果第一个select检索到6行而第二个select仅返回3行，则额外的第4行，第5行和第6行的变量将被删除。

延迟时间设置为获取连接所花费的时间。

JDBC请求控制面板的截图

参数

"Dbl-Quote: "" and Comma: ,"

columnValue = vars.getObject("resultObject").get(0).get("Column Name")；

另请参阅：

• 构建数据库测试计划
• JDBC Connection Configuration

当前版本的JMeter使用UTF-8作为字符编码。以前使用平台默认值。

确保变量名称在测试计划中是唯一的。

【返回目录】

Java请求

此取样器允许您控制实现org.apache.jmeter.protocol.java.sampler.JavaSamplerClient接口的java类 。通过编写您自己的此接口实现，您可以用JMeter来控制多个线程，输入参数控制和数据收集。

下拉菜单提供了JMeter在其classpath中找到的所有此类实现的列表。可以在下面的表中指定参数 - 由您的实现定义。JMeter提供了两个简单示例（JavaTest和SleepTest）。

JavaTest示例取样器对检查测试计划非常有用，因为它允许在几乎所有的字段设置值。这些可以被断言等使用。这些字段允许使用变量，因此可以很容易地看到这些变量的值。

Java 请求的控制面板的截图

如果teardownTest方法未被AbstractJavaSamplerClient的子类覆盖，则不会调用其teardownTest方法。这降低了JMeter内存要求。不会对现有的测试计划产生任何影响。

添加/删除按钮目前不起任何作用。

参数

以下参数适用于SleepTest和JavaTest实现：

参数

totalSleepTime = SleepTime + (System.currentTimeMillis() % SleepMask)

以下参数适用于JavaTest实现：

参数

【返回目录】

LDAP请求

此取样器允许您向LDAP服务器发送不同的LDAP请求（添加，修改，删除和搜索）。

如果要将多个请求发送到同一LDAP服务器，请考虑使用LDAP默认请求配置元件，这样您就不必为每个LDAP请求输入相同的信息。

登录配置元件也使用同样的方法发送用户名和密码。

LDAP请求控制面板的屏截图

创建测试LDAP服务器的测试用例有两种方法。

1. 内置测试用例。
2. 用户定义的测试用例。

测试LDAP有四种测试方案。测试方案如下：

1. 添加测试

   1. 内置测试：

      这将在LDAP服务器中添加预定义的条目并计算执行时间。执行测试后，将从LDAP服务器中删除创建的条目。

   2. 用户定义的测试：

      这将在LDAP服务器中添加条目。用户必须输入表中的所有属性。从表中收集条目以进行添加。计算执行时间。测试后不会删除创建的条目。

2. 修改测试

   1. 内置测试：

      这将首先创建预定义的条目，然后修改LDAP服务器中创建的条目。并计算执行时间。执行测试后，将从LDAP服务器中删除创建的条目。

   2. 用户定义的测试：

      这将修改LDAP服务器中的条目。用户必须输入表中的所有属性。从表中收集条目以进行修改。计算执行时间。该条目不会从LDAP服务器中删除。

3. 搜索测试

   1. 内置测试：

      这将首先创建条目，如果属性可用则执行搜索。计算搜索查询的执行时间。在执行结束时，将从LDAP服务器中删除创建的条目。

   2. 用户定义的测试：

      这将搜索搜索库（同样，由用户定义）中的用户定义条目（搜索过滤）。这些条目应该在LDAP服务器中可用。计算执行时间。

4. 删除测试

   1. 内置测试：

      这将首先创建预定义的条目，然后将从LDAP服务器中删除。计算执行时间。

   2. 用户定义的测试：

      这将删除LDAP服务器中的用户定义条目。这些条目应该在LDAP服务器中可用。计算执行时间。

参数

另请参阅：

• 构建LDAP测试计划
• LDAP默认请求

【返回目录】

LDAP扩展请求

此取样器可以将所有8个不同的LDAP请求发送到LDAP服务器。它是LDAP取样器的扩展版本，因此配置起来比较困难，但可以更接近真实的LDAP会话。

如果要将多个请求发送到同一LDAP服务器，请考虑使用LDAP扩展请求默认值配置元件，这样您就不必为每个LDAP请求输入相同的信息。

LDAP扩展请求控制面板的截图

定义了九个测试操作。这些操作如下：

线程绑定

任何LDAP请求都是LDAP会话的一部分，因此首先要做的是启动与LDAP服务器的会话。使用线程绑定启动此会话，这相当于LDAP的“bind”操作。要求用户提供username（专有名称）和password，用于启动会话。如果未指定密码或密码错误，则会启动匿名会话。注意，省略密码不会使此测试失败，错误密码才会。（注意，它在测试计划中是没有加密存储的）

参数

线程解绑

这只是结束会话的操作。它等于LDAP“unbind”操作。

参数

单绑定/解绑

这是LDAP“bind”和“unbind”操作的组合。它可用于任何用户的身份认证请求/密码检查。它将打开一个新会话，只是为了检查用户/密码组合的有效性，并再次结束会话。

参数

重命名条目

这是LDAP“moddn”操作。它可用于重命名条目，也可用于将条目或完整子树移动到LDAP树中的其他位置。

参数

添加测试

这是LDAP“add”操作。它可用于将任何类型的对象添加到LDAP服务器。

参数

删除测试

这是LDAP“delete”操作，它可用于从LDAP树中删除对象。

参数

搜索测试

这是LDAP“search”操作，用于定义搜索。

参数

修改测试

这是LDAP“modify”操作。它可以用于修改对象。也可用于添加，删除或替换属性的值。

参数

比较

这是LDAP“compare”操作。它可用于将给定属性的值与某个已知值进行比较。实际上，这主要用于检查某个人是否是某个组的成员。在这种情况下，您可以将用户的DN作为给定值与groupOfNames对象的“member”属性中的值进行比较。如果比较操作失败，则测试失败并返回错误代码49。

参数

另请参阅：

• 构建LDAP测试计划
• LDAP扩展请求默认值

【返回目录】

Access Log Sampler

AccessLogSampler旨在读取访问日志并生成http请求。对于那些不熟悉访问日志的人来说，它是Web服务器记录它接受的每个请求的日志。这意味着所有图像，CSS文件，JavaScript文件，html文件，......

Tomcat的访问日志使用通用格式。这意味着使用通用日志格式的任何Web服务器都可以使用AccessLogSampler。使用通用日志格式的服务器包括：Tomcat，Resin，Weblogic和SunOne。常见的日志格式如下所示：

127.0.0.1 - - [21/Oct/2003:05:37:21 -0500] "GET /index.jsp?%2Findex.jsp= HTTP/1.1" 200 8343

解析器的当前实现仅查看包含HTTP协议方法的引号内的文本（GET，PUT，POST，DELETE，...）。其他所有都被剥离并忽略。例如，解析器完全忽略响应代码。

对于将来，过滤出响应代码不是200的条目可能会更好。扩展取样器应该相当简单。您必须实现两个接口：

• org.apache.jmeter.protocol.http.util.accesslog.LogParser
• org.apache.jmeter.protocol.http.util.accesslog.Generator

AccessLogSampler的当前实现使用生成器来创建新的HTTP取样器。服务器名称，端口和获取图像由AccessLogSampler设置。然后，使用整数1调用解析器，告诉它解析1个条目。之后，调用HTTPSampler.sample()来发出请求。

samp = (HTTPSampler) GENERATOR.generateRequest();
samp.setDomain(this.getDomain());
samp.setPort(this.getPort());
samp.setImageParser(this.isImageParser());
PARSER.parse(1);
res = samp.sample();
res.setSampleLabel(samp.toString());

LogParser中所需的方法是：

• setGenerator(Generator)
• parse(int)

实现Generator接口的类应该为所有方法提供具体的实现。有关如何实现任一接口的示例，请参阅 StandardGenerator和TCLogParser。

Access Log Sampler控制面板的截图

（Beta代码）

参数

TCLogParser为每个线程独立处理访问日志。SharedTCLogParser和OrderPreservingLogParser共享访问文件，即每个线程获取日志中的下一个条目。

SessionFilter旨在跨线程处理cookies。它不会过滤掉任何条目，但会修改cookie管理器，以便一次一个线程处理给定IP的cookies。如果两个线程尝试处理来自相同客户端IP地址的样本，则将强制一个线程等待直到另一个线程完成。

LogFilter旨在允许通过文件名和正则表达式来过滤访问日志条目，以及允许替换文件扩展名。但是，目前无法通过GUI进行配置，因此无法真正使用它。

【返回目录】

BeanShell取样器

此取样器允许您使用BeanShell脚本语言编写取样器。

有关使用BeanShell的完整详细信息，请参阅BeanShell网站。

强烈建议迁移到JSR223 Sampler+Groovy以提高性能，支持新的Java功能且减少BeanShell库的维护。

测试元件支持ThreadListener和TestListener接口方法。这些必须在初始化文件中定义。有关定义的示例，请参阅文件BeanShellListeners.bshrc。

BeanShell取样器还支持Interruptible接口。interrupt()方法可以在脚本或初始化文件中定义。

BeanShell 取样器控制面板的截图

参数

注意每个取样器实例都有自己的BeanShell解释器，而取样器只能被单个线程调用

如果定义了“beanshell.sampler.init”属性，则将其作为源文件的名称传递给解析器。这可以用于定义常用方法和变量。bin目录中有一个示例init文件：BeanShellSampler.bshrc。

如果提供了脚本文件，将使用该脚本文件，否则将使用脚本。

在将脚本字段传递给解释器之前，JMeter处理函数和变量的引用，因此引用只会被解析一次。脚本文件中的变量和函数引用将逐字传递给解释器，这可能会导致语法错误。为了使用运行时变量，请使用适当的props方法，例如props.get("START.HMS"); props.put("PROP1","1234");
BeanShell目前不支持Java 5语法，例如泛型和增强的for循环。

在调用脚本之前，BeanShell解释器会设置一些变量：

参数字段的内容放入变量“Parameters”中。该字符串也使用单个空格作为分隔符拆分为单独的标记，并将结果列表存储在字符串数组bsh.args中。

可设置的BeanShell变量的完整列表如下：

• log - 日志记录器

• Label - 取样器标签

• FileName - 文件名（如果有）

• Parameters - 参数字段中的文本

• bsh.args - 参数，按上面描述的拆分

• SampleResult - 指向当前SampleResult的指针

• ResponseCode - 默认为200

• ResponseMessage - 默认为“OK”

• IsSuccess - 默认为true

• ctx - JMeter上下文

• vars - JMeter变量 - 例如：

  vars.get("VAR1");
  vars.put("VAR2","value");
  vars.remove("VAR3");
  vars.putObject("OBJ1",new Object());
  

• props - JMeter属性（java.util.Properties类） - 例如：

  props.get("START.HMS");
  props.put("PROP1","1234");
  

脚本完成后，控制权返回给取样器，并将以下脚本变量的内容复制到SampleResult中的相应变量中：

• ResponseCode - 例如200
• ResponseMessage - 例如“OK”
• IsSuccess - true或false

SampleResult和ResponseData根据脚本的返回值来设置。如果脚本返回null，则可以使用方法SampleResult.setResponseData(data)直接设置响应，其中data是String或byte数组。data类型默认为“text”，但可以通过SampleResult.setDataType(SampleResult.BINARY)方法设置为二进制值 。

SampleResult变量给予脚本对SampleResult内所有字段和方法完全的访问权限。例如，脚本可以访问setStopThread(boolean)和setStopTest(boolean)方法。这是一个简单的（不是很有用）示例脚本：

if (bsh.args[0].equalsIgnoreCase("StopThread")) {
    log.info("Stop Thread detected!");
    SampleResult.setStopThread(true);
}
return "Data from sample with Label "+Label;
//or
SampleResult.setResponseData("My data");
return null;

另一个例子： 确保在jmeter.properties中定义属性beanshell.sampler.init=BeanShellSampler.bshrc。以下脚本将显示ResponseData字段中所有变量的值：

return getVariables();

有关各种类可用方法的详细信息（JMeterVariables，SampleResult等），请查阅Javadoc或源代码。但要注意，滥用任何方法都可能导致难以发现的细微错误。

【返回目录】

JRS223取样器

JSR223取样器允许使用JSR223脚本代码来执行一个样本或创建/更新变量所需的一些计算。

如果您不想在运行此取样器时生成SampleResult，请调用以下方法：

   SampleResult.setIgnore();

JSR223测试元件具有可以显著提高性能的功能（编译）。要利用这个特性，请：

• 使用脚本文件而不是内联它们。如果ScriptEngine上有此功能，JMeter将编译并缓存它们。

• 或者使用脚本文本并检查Cache compiled script if available属性。

  使用此功能时，请确保您的脚本代码不直接在代码中使用JMeter变量而是使用脚本参数，因为缓存只会缓存第一次替换。

  要从缓存和编译中受益，用于脚本编写的语言引擎必须实现JSR223Compilable接口（Groovy就是其中之一，java，beanshell和javascript都不是）

  当使用Groovy作为脚本语言并且不检查Cache compiled script if available时（建议使用缓存），由于版本2.4.6中的Groovy内存泄漏问题，您应该设置JVM属性-Dgroovy.use.classvalue=true，请参阅：

  • GROOVY-7683
  • GROOVY-7591
  • JDK-8136353

缓存大小由以下JMeter属性（jmeter.properties）控制：

jsr223.compiled_scripts_cache_size=100

与BeanShell取样器不同，解释器不会在调用之间保存。

如果脚本引擎支持此功能，使用脚本文件或脚本文本+检查Cache compiled script if available的JSR223测试元件将执行编译，这可以实现性能的显著提升。

JSR223取样器控制面板的截图

在将脚本字段传递给解释器之前，JMeter处理函数和变量的引用，因此引用只会被解析一次。脚本文件中的变量和函数引用将逐字传递给解释器，这可能会导致语法错误。为了使用运行时变量，请使用适当的props方法，例如

 props.get("START.HMS");
 props.put("PROP1","1234");

参数

如果提供了脚本文件，则使用该脚本文件，否则使用脚本。

在调用脚本之前，会设置一些变量。请注意，这些是JSR223变量 - 即它们可以直接在脚本中使用。

• log - 日志记录器

• Label - 取样器标签

• FileName - 文件名（如果有）

• Parameters - 参数字段中的文本

• args - 参数，按照上面描述的拆分

• SampleResult - 指向当前SampleResult的指针

• sampler - （Sampler） - 指向当前取样器的指针

• ctx - JMeter上下文

• vars - JMeter变量 - 例如：

  vars.get("VAR1");
  vars.put("VAR2","value");
  vars.remove("VAR3");
  vars.putObject("OBJ1",new Object());
  

• props - JMeter属性（java.util.Properties类） - 例如：

  props.get("START.HMS");
  props.put("PROP1","1234");
  

• OUT - System.out - 例如OUT.println("message")

SampleResult和ResponseData根据脚本的返回值来设置。如果脚本返回null，则可以使用SampleResult.setResponseData(data)方法直接设置响应 ，其中data是String或byte数组。data类型默认为“text”，但可以通过SampleResult.setDataType(SampleResult.BINARY)方法设置为二进制值 。

SampleResult变量给予脚本对SampleResult内所有字段和方法完全的访问权限。例如，脚本可以访问setStopThread(boolean)和setStopTest(boolean)方法。

与BeanShell取样器不同，JSR223取样器不通过脚本变量设置ResponseCode，ResponseMessage和样本status。目前改变这些的唯一方法是通过SampleResult方法：

• SampleResult.setSuccessful(true/false)
• SampleResult.setResponseCode("code")
• SampleResult.setResponseMessage("message")

【返回目录】

TCP取样器

TCP取样器打开与指定服务器的TCP/IP连接。然后发送文本，并等待响应。

如果选中“Re-use connection”，则在同一线程中的取样器之间共享连接，前提是使用完全相同的主机名称和端口。不同的主机/端口组合将使用不同的连接，不同的线程也是如此。如果同时选中“ Re-use connection ”和“Close connection”，则运行取样器后将关闭套接字。在下一个取样器上，将创建另一个套接字。您可能希望在每个线程循环结束时关闭套接字。

如果检测到错误 - 或未选中“Re-use connection” - 则关闭套接字。下一个样本将打开另一个套接字。

以下属性可用于控制其操作：

• tcp.status.prefix

  状态码之前的文本

• tcp.status.suffix

  状态码之后的文本

• tcp.status.properties

  用于将状态代码转换为消息的属性文件的名称

• tcp.handler

  TCP Handler类的名称（默认TCPClientImpl） - 仅在GUI上未指定时使用

处理连接的类由GUI定义，如果未定义，取tcp.handler属性的值。如果还是取不到，则在

org.apache.jmeter.protocol.tcp.sampler包中搜索该类。

用户可以提供自己的实现。该类必须扩展org.apache.jmeter.protocol.tcp.sampler.TCPClient。

目前提供以下实现。

• TCPClientImpl
• BinaryTCPClientImpl
• LengthPrefixedBinaryTCPClientImpl

实现的行为如下：

• TCPClientImpl

  这种实现是相当基础的。读取响应时，如果配置了tcp.eolByte属性，则读取直到行字节结束，否则直到输入流结束。您可以通过设置tcp.charset来控制字符集编码，默认为平台默认编码。

• BinaryTCPClientImpl

  此实现将GUI输入（必须是十六进制编码的字符串）转换为二进制，并在读取响应时执行相反的操作。读取响应时，如果配置了tcp.BinaryTCPClient.eomByte属性，则读取直到消息字节结束，否则直到输入流结束。

• LengthPrefixedBinaryTCPClientImpl

  此实现通过在二进制消息数据前加二进制长度字节来扩展BinaryTCPClientImpl。长度前缀默认为2个字节。可以通过设置属性tcp.binarylength.prefix.length来变更。

• 超时处理

  如果设置了超时，则读取将在超时后终止。因此，如果您使用的是eolByte/eomByte，请确保超时设置的足够长，否则将过早终止读取。

• 响应处理

  如果定义了tcp.status.prefix，则会在响应消息中从此开始搜索文本，直到后缀结束。如果找到任何此类文本，则用于设置响应代码。然后从属性文件（如果提供）中获取响应消息。

  使用前缀（prefix）和后缀（suffix）

  例如，如果prefix = “ [“和suffix =“]”，则下面的响应：

  [J28] XI123,23,GBP,CR

  将获取到响应代码为J28。

  “400”-“499”和“500”-“599” 范围内的响应代码目前被视为失败; 其他的视为成功。【这需要进行配置！】

提供的TCP实现不使用登录名/密码。

在测试运行结束时断开套接字。

TCP取样器控制面板的截图

参数

【返回目录】

JMS发布

JMS发布将消息发布到给定目标（主题/队列）。对于那些不熟悉JMS的人来说，它是用于消息传递的J2EE规范。市场上有许多JMS服务器，还有一些是开源的。

JMeter不包含任何JMS实现jar；必须从JMS提供方下载并放入lib目录

JMS发布控制面板的截图

参数

对于MapMessage类型，JMeter将源文件读取为文本行。每行必须有3个字段，用逗号分隔。这些字段是：

• 条目名称
• 对象类名，例如“String”（如果未指定，则假定为java.lang包）
• 对象字符串值

valueOf(String)

name,String,Example
size,Integer,1234

对象消息的实现和工作方式如下：

• 将包含对象及其依赖项的JAR放在jmeter_home/lib/文件夹中
• 使用XStream将对象序列化为XML
• 将结果放在以.txt或.obj为后缀的文件中，或将XML内容直接放在文本区域中

请注意，如果消息位于文件中，则在使用文本区域时将不会替换属性。

下表显示了在配置JMS时可能有用的一些值：

【返回目录】

JMS订阅

JMS订阅将订阅给定目标（主题或队列）中的消息。对于那些不熟悉JMS的人来说，它是用于消息传递的J2EE规范。市场上有许多JMS服务器，还有一些是开源的。

JMeter不包含任何JMS实现jar；必须从JMS提供方下载并放入lib目录

JMS订阅控制面板的截图

参数

【返回目录】

JMS点到点

此取样器通过点到点连接（队列）发送并可选地接收JMS消息。与发布/订阅消息不同，它通常用于处理事务。

request_only通常用于对JMS系统产生负载。 request_reply这个模式将等待此服务发送的回复队列的响应，所以可以用于测试处理发送到请求队列消息的JMS服务的响应时间。
browse返回当前队列深度，即队列中的消息数。
read从队列中读取消息（如果有的话）。
clear清除队列，即从队列中删除所有消息。

JMeter在创建队列连接时使用java.naming.security.[principal|credentials]属性 - 如果存在。如果不需要此行为，请设置JMeter属性JMSSampler.useSecurity.properties=false

JMeter不包含任何JMS实现jar；必须从JMS提供方下载并放入lib目录

JMS点到点控制面板的截图

参数

【返回目录】

JUnit请求

当前实现支持标准JUnit约定和扩展。它还包括oneTimeSetUp和oneTimeTearDown等扩展。取样器的工作方式与Java请求类似，但 存在一些差异。

• 与使用JMeter的测试接口不同，它会扫描jar文件以寻找扩展JUnitTestCase类的类。这包括任何类或子类。
• JUnit测试jar文件应该放在jmeter/lib/junit而不是/lib目录中。您还可以使用“user.classpath”属性指定查找TestCase类的位置。
• JUnit取样器不像Java请求那样使用名称/值对进行配置。取样器假定setUp和tearDown将正确配置测试。
• 取样器仅测量测试方法的经过时间，不包括setUp和tearDown。
• 每次调用测试方法时，JMeter都会将结果传递给监听器。
• 支持oneTimeSetUp和oneTimeTearDown作为方法完成。由于JMeter是多线程的，我们不能像Maven那样调用oneTimeSetUp/oneTimeTearDown。
• 取样器将意外异常报告为错误。标准JUnit测试运行与JMeter实现之间存在一些重要差异。JMeter不是为每个测试创建一个新的类实例，而是为每个取样器创建一个实例并重用它。这可以通过复选框“Create a new instance per sample”进行更改。

取样器的当前实现将尝试首先使用字符串构造函数创建实例。如果测试类没有声明字符串构造函数，则取样器将查找空构造函数。示例如下：

JUnit构造函数

空构造函数：

public class myTestCase {
      public myTestCase() {}
    }

字符串构造函数：

public class myTestCase {
      public myTestCase(String text) {
          super(text);
      }
    }

默认情况下，JMeter将为成功/失败代码和消息提供一些默认值。用户应定义一组唯一的成功和失败代码，并在所有测试中统一使用它们。

一般准则

如果使用setUp和tearDown，请确保将方法声明为public。如果不这样做，测试可能无法正常运行。
以下是编写JUnit测试的一般准则，能使它们在JMeter下运行良好。由于JMeter运行多线程，因此记住某些事情非常重要。

• 编写的setUp和tearDown方法应是线程安全的。这通常意味着避免使用静态成员。
• 使测试方法成为离散的工作单元，而不是长的动作序列。通过将测试方法保持为离散操作，可以更轻松地组合测试方法以创建新的测试计划。
• 避免使测试方法相互依赖。由于JMeter允许对测试方法进行任意排序，因此运行行为与默认的JUnit行为不同。
• 如果测试方法是可配置的，请注意存储属性的位置。建议从Jar文件中读取属性。
• 每个取样器都会创建一个测试类的实例，因此编写测试时，应在oneTimeSetUp和oneTimeTearDown中进行初始化等配置。

JUnit请求控制面板的截图

参数

识别以下JUnit4注释：

• @Test

用于查找测试方法和类。支持“expected”和“timeout”属性。

• @Before

在JUnit3中当做setUp()对待

• @After

在JUnit3中当做tearDown()对待

• @BeforeClass，@AfterClass

作为测试方法处理，因此可以根据需要独立运行

注意，当前版本JMeter直接运行测试方法，而不是将其留给JUnit。这是为了可以从采样时间中排除setUp/tearDown方法。因此，取样器时间排除了调用setUp/tearDown方法及基于其注释的替代方法所花费的时间。

【返回目录】

邮件阅读者取样器

邮件阅读者取样器可以使用POP3(S)或IMAP(S)协议读取（可选删除）邮件消息。

邮件阅读者取样器控制面板的截图

参数

您可以通过向user.properties添加此处描述的任何属性来传递与邮件相关的环境属性。

消息存储为主取样器的子样本。多部分消息按部分存储为消息的子样本。

关于file协议的特殊处理： JavaMail中file提供者可用于从文件中读取原始邮件。server字段用于指定路径的父folder。应使用名称n.msg存储单个消息文件，其中n为消息编号。或者，server字段可以是包含单个消息的文件的名称。此实现非常基础，主要用于调试目的。

【返回目录】

测试活动（Flow Control Action）

测试活动取样器是一个适用于条件控制器的取样器。测试元件不是生成样本，而是暂停或停止所选目标。

此取样器也可以与事务控制器结合使用，因为它允许包含暂停而无需生成样本。对于可变延迟，将暂停时间设置为零，并将定时器添加为子级。

完成正在进行的任何样本后 ，“stop”操作将停止线程或测试。“Stop Now”操作将停止测试，而无需等待样本完成; 它会中断任何活动样本。如果某些线程未能在5秒的时间限制内停止，则将在GUI模式下显示一条消息。您可以使用Stop命令尝试停止线程，如果不能停止，可以手动退出JMeter。在CLI模式下，如果某些线程未能在5秒的时间限制内停止，JMeter将退出。

可以使用JMeter属性jmeterengine.threadstop.wait更改等待时间。以毫秒为单位。

测试活动控制面板的截图

参数

【返回目录】

SMTP取样器

SMTP取样器可以使用SMTP/SMTPS协议发送邮件。可以为连接（SSL和TLS）以及用户身份认证设置安全协议。如果使用安全协议，则将对服务器证书进行验证。
有两种方法可以处理此验证：

• Trust all certificates

这将忽略证书链验证

• Use a local truststore

使用此选项，将根据本地信任库文件验证证书链。

SMTP取样器控制面板的截图

参数

【返回目录】

OS进程取样器

OS进程取样器是一个可用于在本地计算机上执行命令的取样器。
它应该允许执行可以从命令行运行的任何命令。
可以启用返回代码的验证，并可以指定预期的返回代码。

注意OS shell通常提供命令行解析。这在操作系统之间有所不同，但通常shell会按照空格拆分参数。一些shell扩展了通配符文件名；另一些没有。操作系统之间的引用机制也各不相同。取样器故意不进行任何解析或引用处理。必须以可执行文件期望的形式提供命令及其参数。这意味着取样器设置将无法在操作系统之间移植。

许多操作系统都有一些内置命令，这些命令不作为单独的可执行文件提供。例如，WindowsDIR命令是命令解释器（CMD.EXE）的一部分。这些内置函数不能作为独立程序运行，但必须作为参数提供给相应的命令解释器。

例如，Windows命令行：DIR C:\TEMP需要指定如下：

• 命令：

CMD

• 参数1：

/C

• 参数2：

DIR

• 参数3：

C:\TEMP

OS进程取样器控制面板的截图

参数

【返回目录】

MongoDB脚本（已弃用）

略

【返回目录】

18.2 逻辑控制器

逻辑控制器决定取样器的处理顺序。

简单控制器

简单逻辑控制器允许您组织取样器和其他逻辑控制器。与其他逻辑控制器不同，该控制器不提供超出存储设备的功能。

简单控制器控制面板的截图

参数

使用简单控制器

下载此示例（参见图6）。在此示例中，我们创建了一个测试计划，该计划发送两个Ant HTTP请求和两个Log4J HTTP请求。我们通过把Ant和Log4J请求放在简单逻辑控制器中将它们分组。请记住，简单逻辑控制器对JMeter如何处理您添加到其中的控制器没有影响。因此，在此示例中，JMeter按以下顺序发送请求：Ant Home Page，Ant News Page，Log4J Home Page， Log4J History Page。

注意，File Reporter配置为将结果存储在当前目录中名为“simple-test.dat”的文件中。

图6 - 简单控制器示例

【返回目录】

循环控制器

如果将生成器或逻辑控制器添加到循环控制器，除了为线程组指定的循环次数外，JMeter还将循环它们一定次数。例如，如果将一个HTTP请求添加到循环计数为2的循环控制器，并将线程组循环计数配置为3，则JMeter将发送总共2 * 3 = 6个 HTTP请求。

JMeter将循环索引公开为名为__jm__<Name of your element>__idx的变量。因此，例如，假设您的循环控制器名称为LC，那么您可以通过${__jm__LC__idx}访问循环索引。索引从0开始

循环控制器控制面板的截图

参数

循环示例

下载此示例（参见图4）。在此示例中，我们创建了一个测试计划，该计划发送一个HTTP请求1次，并发送另一个HTTP请求5次。

图4 - 循环控制器示例

我们为单个线程配置了线程组，并将循环次数配置为1。我们使用循环控制器，而不是让线程组控制循环。您可以看到我们向线程组添加了一个HTTP请求，并向循环控制器添加了另一个HTTP请求。我们将循环控制器循环次数配置为5。

JMeter将按以下顺序发送请求：Home Page，News Page，News Page，News Page，News Page，和News Page。

注意，File Reporter配置为将结果存储在当前目录中名为“loop-test.dat”的文件中。

【返回目录】

仅一次控制器

仅一次逻辑控制器告诉JMeter每个线程只处理一次其内部的控制器，并在测试计划之后的迭代期间执行其后的所有请求。

仅一次控制器现在将始终在任何循环父控制器的第一次迭代期间执行。因此，如果将仅一次控制器放置在指定循环5次的循环控制器下，那么仅一次控制器将仅在循环控制器第一次迭代时执行（即每5次）。

注意这意味着如果将它置于一个线程组（每个线程每次测试只运行一次），那么仅一次控制器仍然会像预期的那样运行，但现在用户可以更灵活地使用仅一次控制器。

对于需要登录的测试，请考虑将登录请求放在此控制器中，因为每个线程只需登录一次即可建立会话。

仅一次控制器控制面板的截图

参数

仅一次示例

下载此示例（参见图5）。在此示例中，我们创建了一个测试计划，其中包含两个发送HTTP请求的线程。每个线程向Home Page发送一次请求，然后向Bug Page发送三次请求。虽然我们将线程组配置为迭代三次，但每个JMeter线程只向Home Page发送一次请求，因为此请求位于仅一次控制器内。

图5 - 仅一次控制器示例

每个JMeter线程将按以下顺序发送请求：Home Page，Bug Page，Bug Page，Bug Page。

注意，File Reporter配置为将结果存储在当前目录中名为“loop-test.dat”的文件中。

【返回目录】

交替控制器

如果将生成器或逻辑控制器添加到交替控制器，则JMeter每次循环迭代时将在每个其他控制器之间交替进行。

交替控制器控制面板的截图

参数

简单交替示例

下载此示例（参见图1）。在此示例中，我们将线程组配置为具有两个线程且循环次数为5，每个线程总共10个请求。请参阅下表，了解JMeter发送HTTP请求的顺序。

图1 - 交替控制器示例1

循环迭代	每个JMeter线程发送这些HTTP请求
1	News Page
1	Log Page
2	FAQ Page
2	Log Page
3	Gump Page
3	Log Page
4	因为控制器中没有更多请求，JMeter重新开始并发送第一个HTTP请求，即News Page
4	Log Page
5	FAQ Page
5	Log Page

有用的交替示例

下载另一个示例（参见图2）。在此示例中，我们将线程组配置为具有1个线程且循环次数为8。请注意，测试计划有一个外部交替控制器，其下有两个交替控制器。

图2 - 交替控制器示例2

外部交替控制器在两个内部控制器之间交替。然后，每个内部交替控制器在每个HTTP请求之间交替。每个JMeter线程将按以下顺序发送请求： Home Page，Interleaved，Bug Page，Interleaved，CVS Page，Interleaved，和FAQ Page，Interleaved。

注意，File Reporter配置为将结果存储在当前目录中名为“interleave-test2.dat”的文件中。

图3 - 交替控制器示例3

如果主交替控制器下的两个交替控制器是简单控制器，那么顺序将是：Home Page，CVS Page，Interleaved，Bug Page，FAQ Page，Interleaved。

但是，如果在主交替控制器上选中了“忽略子控制器块”，那么顺序将是：Home Page，Interleaved，Bug Page，Interleaved，CVS Page，Interleaved，和FAQ Page，Interleaved。

【返回目录】

随机控制器

随机逻辑控制器的作用类似于交替控制器，不同之处在于它通过其子控制器和取样器时不是按排列顺序，而是在每次通过时随机选取一个。

多个控制器之间的交互可以产生复杂的行为。随机控制器尤其如此。请在假设任何给定的交互产生的结果之前进行实验

随机控制器控制面板的截图

参数

【返回目录】

随机顺序控制器

随机顺序控制器很像简单控制器，因为它的每个子元件最多只执行一次，但节点的执行顺序是随机的。

随机顺序控制器控制面板的截图

参数

【返回目录】

吞吐量控制器

吞吐量控制器允许用户控制执行的频率。有两种模式：

• Percent executions
• Total executions

Percent executions

使控制器对测试计划执行一定比例的迭代。

Total executions

使控制器在执行了一定数量的执行后停止执行。

与仅一次控制器一样，当父循环控制器重新启动时，此设置将被重置。

该控制器的命名不太好，因为它不控制吞吐量。有关可用于调整吞吐量的元件，请参阅常数吞吐量定时器。

吞吐量控制器控制面板的截图

当与其他控制器结合使用时，吞吐量控制器会产生非常复杂的行为 - 特别是父项是交替或随机控制器的情况（也非常有用）。

参数

【返回目录】

Runtime控制器

Runtime控制器控制其子节点运行多长时间。控制器将运行其子项，直到超出配置的Runtime(s)。

Runtime控制器控制面板的截图

参数

【返回目录】

如果（If）控制器

If控制器允许用户控制其下方的测试元件（其子元件）是否运行。

默认情况下，条件仅在初始条目时计算一次，但您可以选择对控制器中包含的每个可运行元件进行计算。

If控制器将在内部使用javascript来计算条件，但这会导致性能下降。

If控制器使用javascript

更好的选项（默认选项）是使用Interpret Condition as Variable Expression?，然后在条件字段中，您有2个选项：

• 选项1：使用包含true或false的变量

  如果要测试最后一个样本是否成功，可以使用${JMeterThread.last_sample_ok}

  
  If控制器使用变量

• 选项2：使用函数（建议使用${__jexl3()}）来计算表达式，表达式必须返回true或false

  
  If控制器使用表达式

例如，以前可以使用条件：${__jexl3(${VAR} == 23)}并将其评估为true/false，然后将结果传递给JavaScript，然后返回true/false。如果选择了Variable Expression选项，则会计算表达式并与“true” 进行比较，而无需使用JavaScript。

要测试变量是否未定义（或为null），请执行以下操作，假设变量名为myVar，表达式如下：

   "${myVar}" == "\${myVar}"

或使用：

   "${myVar}" != "\${myVar}"

测试变量是否已定义且不为null。

IF控制器控制面板的截图

参数

示例（JavaScript）

- ${COUNT} < 10 - "${VAR}" == "abcd"

如果解析代码时出错，则假定条件判断为false，并在jmeter.log中记录消息。

注意，性能测试中建议避免使用JavaScript模式。

使用__groovy时请注意不要在字符串中使用变量替换，因为使用更改脚本的变量会无法缓存。应该使用vars.get("myVar")获取变量。 请参阅下面的Groovy示例。

示例（变量表达式）

- ${__groovy(vars.get("myVar") != "Invalid" )} (Groovy检查myVar是否不等于Invalid) - ${__groovy(vars.get("myInt").toInteger() <=4 )} (Groovy 检查myInt是否小于或等于4) - ${__groovy(vars.get("myMissing") != null )} (Groovy 检查myMissing变量是否没有设置) - ${__jexl3(${COUNT} < 10)} - ${RESULT} - ${JMeterThread.last_sample_ok} (检查最后一个样本是否成功)

【返回目录】

While控制器

While控制器运行其子项，直到条件为“false”时停止。

JMeter将循环索引公开为名为__jm__<Name of your element>__idx的变量。因此，例如，如果您的While控制器名为WC，那么您可以通过${__jm__WC__idx}访问循环索引。索引从0开始

可能的条件值：

• 空白 - 当循环中的最后一个样本失败时退出循环
• LAST - 当循环中的最后一个样本失败时退出循环。如果循环之前的最后一个样本失败，不进入循环。
• 其他 - 当条件等于字符串“false” 时退出（或不进入）循环

条件可以是最终计算为字符串“false”的任何变量或函数。这允许根据需要使用__jexl3，__groovy函数，属性或变量。

请注意，条件被评估两次，一次是在开始采样子项之前，一次是在子项采样结束时，因此将非幂等函数放入Condition（如__counter）可能会产生问题。

例如：

• ${VAR} - 其他测试元件将VAR 设置为false
• ${__jexl3(${C}==10)}
• ${__jexl3("${VAR2}"=="abcd")}
• ${_P(property)} - 其他某个地方将属性设置为"false"

While控制器控制面板的截图

参数

【返回目录】

Switch控制器

Switch控制器的作用类似于交替控制器，它在每次迭代时运行一个子元件，但控制器运行顺序不是按排列顺序，而是按switch value定义。

switch value也可以是名称。

如果switch value超出范围，它将运行第0个元件，这是数字情况的默认值。如果value为空字符串，它也是运行第0个元件。

如果value为非数字（且非空），则Switch控制器将查找具有相同名称的元件（要考虑大小写）。如果没有匹配的名称，则选择名为“default”（要考虑大小写）的元件。如果没有默认值，则不选择任何元件，并且控制器不会进行任何操作。

Switch控制器控制面板的截图

参数

【返回目录】

ForEach控制器

ForEach控制器循环遍历一组相关变量的值。将取样器（或控制器）添加到ForEach控制器时，每个取样器（或控制器）执行一次或多次，在每个循环期间变量会有新值。输入应包含多个变量，每个变量都用下划线和数字扩展。每个这样的变量都必须有一个值。因此，例如当输入变量的名称为inputVar时，应该定义以下变量：

• inputVar_1 = wendy
• inputVar_2 = charles
• inputVar_3 = peter
• inputVar_4 = john

注意：“_”分隔符现在是可选的。

当返回变量以“returnVar” 给出时，ForEach控制器下的取样器和控制器的集合将连续执行4次，返回变量具有相应的上述值，并且可以在取样器中使用。

JMeter将循环索引公开为名为__jm__<Name of your element>__idx的变量。因此，例如，如果您的循环控制器名为FEC，那么您可以通过${__jm__FEC__idx}访问循环索引。索引从0开始

它特别适合与正则表达式后置处理器一起运行。这可以从先前请求的结果数据中“创建”必要的输入变量。通过省略“_”分隔符，可以使用ForEach控制器通过输入变量refName_g循环遍历组，并且还可以使用形如refName_${C}_g的输入变量循环遍历所有匹配中的所有组，其中C是计数器变量。

如果inputVar_1值为null，ForEach控制器不会执行任何取样。如果正则表达式没有返回匹配，则会出现这种情况。

ForEach控制器控制面板的截图

参数

ForEach示例

下载此示例（参见图7）。在此示例中，我们创建了一个测试计划，该计划仅发送一次特定的HTTP请求，并将另一个HTTP请求发送到页面上可找到的每个链接。

图7 - ForEach控制器示例

我们为单个线程配置了线程组，并将循环次数配置为1。您可以看到我们向线程组添加了一个HTTP请求，并向ForEach控制器添加了另一个HTTP请求。

在第一个HTTP请求之后，添加了一个正则表达式提取器，它从返回页面中提取所有html链接并将它们放在inputVar变量中

在ForEach循环中，添加了一个HTTP取样器，它请求从第一个返回的HTML页面中提取的所有链接。

ForEach示例

这是您可以下载的另一个示例。这有两个正则表达式和ForEach控制器。第一个正则有匹配，第二个没有匹配，因此第二个ForEach控制器不运行任何样本

图8 - ForEach控制器示例2

线程组设置一个线程，循环次数为2。

Sample 1使用JavaTest取样器返回字符串“a b c d”。

正则表达式提取器使用表达式(\w)\s匹配一个字母后跟一个空格，并返回字母（而不是空格）。所有匹配都以字符串“inputVar” 为前缀。

ForEach控制器提取包含前缀“inputVar_” 的所有变量，并执行其样本，传递变量“returnVar”中的值。在这种情况下，它将依次将变量设置为值“a” “b”和“c”。

For 1是另一个Java取样，使用返回变量“returnVar”作为样本标签的一部分，同时作为采样数据。

Sample 2，Regex 2和For 2几乎相同，只是正则表达式变成“(\w)\sx”，这显然无法获得任何匹配。因此For 2样本将不会运行。

【返回目录】

模块控制器

模块控制器提供了一种在运行时将测试计划片段替换为当前测试计划的机制。

测试计划片段由控制器和其中包含的所有测试元件（取样器等）组成。片段可以位于任何线程组中。如果片段位于线程组中，则可以禁用其控制器以防止片段在模块控制器以外运行。或者，您可以将片段存储在虚拟线程组中，并禁用整个线程组。

可以有多个片段，每个片段下面都有不同系列的取样器。然后，只需在模块控制器的下拉框中选择适当的控制器即可在这些多个测试用例之间轻松切换。这为快速轻松地运行许多备用测试计划提供了便利。

片段名称由控制器名称及其所有父名称组成。例如：

Test Plan / Protocol: JDBC / Control / Interleave Controller (Module1)

模块控制器使用的任何片段都必须具有唯一的名称，因为该名称用于在重新加载测试计划时查找目标控制器。因此，最好确保控制器名称不是默认值 - 如上例所示 - 否则在新元件添加到测试计划时可能会意外创建副本。

模块控制器控制面板的截图

参数

【返回目录】

Include控制器

Include控制器旨在使用外部JMX文件。要使用它，在测试计划下创建一个测试片段，并在其下面添加任何所需的取样器，控制器等。然后保存测试计划。该文件现在可以作为其他测试计划的一部分包含在内。

为方便起见，还可以在外部JMX文件中添加线程组以进行调试。模块控制器可用于引用试验片段。该线程组在include进程中将被忽略。

如果测试使用Cookie管理器或用户定义的变量，则应将这些变量放在顶级测试计划中，而不是include的文件中，否则无法保证它们正常工作。

此元件不支持文件名字段中的变量/函数。
但是，如果定义了属性includecontroller.prefix，则内容将用于路径名称的前缀。

使用Include控制器并包含相同的JMX文件时，请确保Include控制器命名不同以避免遇到已知问题Bug 50898。

如果在prefix+Filename给定的位置找不到该文件，则控制器会尝试打开相对于JMX启动目录下的Filename。

Include控制器控制面板的截图

参数

【返回目录】

事务控制器

事务控制器生成一个额外的样本，用于测量执行嵌套测试元件所花费的总时间。

注意：如果选中“Include duration of timer and pre-post processors in generated sample”复选框，则时间包括控制器范围内的所有处理，而不仅仅是样本执行时间。

有两种操作模式：

• 嵌套样本后添加额外的样本
• 添加额外的样本作为嵌套样本的父级

生成的采样时间包括嵌套取样器的所有时间，默认情况下（从2.11开始）不包括定时器和前置/后置处理器执行时间，除非选中“Include duration of timer and pre-post processors in generated sample”复选框。根据时钟精度，它可能略长于各个取样器加定时器的总和。在控制器记录开始时间之后但在第一个样本开始之前，时钟开始滴答。在最后也一样。

仅当所有子样本都成功时，生成的样本才被视为成功。

在父模式下，仍可以在查看结果树监听器中看到各个样本，但不再在其他监听器中显示为单独的条目。此外，子样本不会出现在CSV日志文件中，但可以保存到XML文件中。

在父模式下，可以将断言（等）添加到事务控制器中。但是，默认情况下，它们将同时应用于单个样本和整个事务样本。要限制断言的范围，请使用简单控制器来包含样本，并将断言添加到简单控制器。父模式控制器当前不能正确支持任何类型的嵌套事务控制器。

事务控制器控制面板的截图

参数

【返回目录】

录制控制器

记录控制器是指示代理服务器录制样本位置的占位符。在测试运行期间，它没有任何效果，类似于简单控制器。但在使用HTTP代理服务器录制时，所有录制的样本将默认保存在录制控制器下。

录制控制器控制面板的截图

参数

【返回目录】

临界部分控制器

临界部分控制器确保其子元件（取样器/控制器等）将仅由一个线程执行，在执行控制器的子节点之前将执行命名锁定。

临界部分控制器控制面板的截图

下图显示了使用临界部分控制器的示例，如下图所示2个临界部分控制器用来确保：

• DS2-${__threadNum}一次只能由一个线程执行

• DS4-${__threadNum}一次只能由一个线程执行

  
  使用临界部分控制器的测试计划

参数

临界部分控制器仅在一个JVM中获取锁，因此如果使用分布式测试，请确保您的用例不依赖于所有JVM阻塞的所有线程。

【返回目录】

18.3 监听器

除了“监听”测试结果之外，大多数监听器扮演多种角色。它们还提供查看，保存和读取已保存测试结果的方法。

注意，监听器在找到它们的范围的最后处理。

测试结果的保存和读取是通用功能。各种监听器都有一个面板，用户可以指定要写入（或读取）结果的文件。默认情况下，结果存储为XML文件，通常带有“.jtl”扩展名。存储为CSV是最有效的选项，但不如XML（另一个可用选项）详细。

监听器不处理在CLI模式下的取样数据，但是，如果配置了输出文件，原始数据将被保存。为了分析CLI运行生成的数据，您需要将文件加载到相应的监听器中。

要读取现有结果并显示它们，请使用文件面板的浏览按钮打开该文件。

如果要在加载新文件之前清除所有当前数据，请在加载文件之前使用菜单项“运行”→“清除” （Ctrl+Shift+E） 或“运行”→“清除全部” （Ctrl+E） 。

可以从XML或CSV格式文件中读取结果。从CSV结果文件中读取时，标题（如果存在）用于确定存在哪些字段。为了正确解析无标题的CSV文件，必须在jmeter.properties中设置相应的属性。

JMeter编写的XML文件在头文件中声明版本1.0，而实际文件使用1.1规则序列化。（这样做是出于历史兼容性原因；请参阅Bug 59973和Bug 58679）这会导致严格的XML解析器失败。考虑使用非严格的XML解析器来读取JTL文件。

文件名可以包含函数和/或变量引用。但是，变量引用在客户端 - 服务器模式下不起作用（函数可以正常工作）。这是因为文件是在客户端上创建的，而客户端不在本地运行测试，因此不会设置变量。

如果有大量样本，监听器会使用大量内存。目前大多数监听器都在其范围内拷贝每个样本的副本，下列监听器除外：

• 简单数据写入器
• BeanShell/JSR223监听器
• 邮件观察器
• 汇总报告

以下监听器不再需要保存每个样本的副本。相反，聚合具有相同经过时间的样本。现在需要更少的内存，特别是如果大多数样本只需要一两秒钟。

• 聚合报告
• 汇总图

要最小化所需的内存量，请使用简单数据写入器，并使用CSV格式。

JMeter变量可以保存到输出文件中。这只能使用属性指定。有关详细信息， 请参阅监听器样本变量

有关设置要保存的默认项的完整详细信息，请参阅监听器默认配置文档。有关输出文件内容的详细信息，请参阅CSV日志格式或XML日志格式。

jmeter.properties中的条目用于定义默认值；可以使用“配置”按钮为单个监听器重写这些内容，如下所示。jmeter.properties中的设置也适用于使用命令行标志-l添加的监听器。

下图显示了结果文件配置面板的示例

结果文件配置面板

参数

样本结果保存配置

监听器可以通过配置弹窗将不同的选项保存到结果日志文件（JTL），如下所示。默认值的定义如监听器默认配置文档中所述。后面带有（CSV）的选项仅适用于CSV格式；带有（XML）的选项仅适用于XML格式。目前CSV格式无法用于保存包含换行符的任何选项。

注意，cookie、方法和查询字符串将保存为“Sampler Data”选项的一部分。

样本结果保存配置控制面板的截图

【返回目录】

图形结果

在压力测试期间不得使用图形结果，因为它消耗了大量资源（内存和CPU）。仅用于功能测试或测试计划调试和验证期间。

图形结果监听器生成一个简单的图形，用于绘制所有取样时间。沿着图的底部，以毫秒为单位显示当前样本（黑色），所有样本的当前平均值（蓝色），当前标准差（红色）和当前吞吐量（绿色）。

吞吐量数字表示服务器处理的实际请求数/分钟数。此计算包括您添加到测试中的任何延迟以及JMeter自身的内部处理时间。像这样进行计算的优点是这个数字代表了一些真实的东西 - 你的服务器实际上每分钟处理了多少请求，你可以增加线程数和/或减少延迟来发现服务器的最大吞吐量。然而，如果您的计算考虑了延迟和JMeter的处理时间，那么您可能不清楚从该数字可以得出什么结论。

图形结果控制面板的截图

下表简要介绍了图表中的项目。关于统计术语的确切含义的更多细节可以在网上找到 - 例如维基百科 - 或者查阅统计书。

• 数据 - 绘制实际数据值
• 平均值 - 绘制平均值
• 中值 - 绘制中位数（中间值）
• 偏离 - 绘制标准差（衡量变化的一种方法）
• 吞吐量 - 绘制每单位时间的样本数

显示屏底部的各个数字是当前值。“最新样本”是当前经过的采样时间，在图表上显示为“数据”。

图表左上角显示的值是响应时间第90百分位数的最大值。

【返回目录】

断言结果

在压力测试期间不得使用断言结果，因为它消耗了大量资源（内存和CPU）。仅用于功能测试或测试计划调试和验证期间。

断言结果可视化器显示每个样本的标签。它还报告了作为测试计划一部分的任何断言的失败。

断言结果控制面板的截图

另请参阅：

• 响应断言

【返回目录】

查看结果树

在压力测试期间不得使用查看结果树，因为它消耗了大量资源（内存和CPU）。仅用于功能测试或测试计划调试和验证期间。

查看结果树是一个显示所有样本响应的树，允许您查看任何样本的响应。除了显示响应之外，您还可以看到获得此响应所花费的时间以及一些响应代码。注意请求面板仅显示JMeter添加的信息头。它不显示可由HTTP协议实现添加的任何信息头（例如Host）。

有几种方法可以查看响应，可以通过左侧面板底部的下拉框进行选择。

Match count: 74
Match[1]=#functions
Match[2]=#what_can_do
Match[3]=#where
Match[4]=#how
Match[5]=#function_helper
Match[6]=#functions
Match[7]=#__regexFunction
Match[8]=#__regexFunction_parms
Match[9]=#__counter
… and so on …

Match count: 26
Match[1][0]=JMeter - Apache JMeter
Match[1][1]=JMeter
Match[2][0]=JMeter" title="JMeter" border="0"/>
Match[2][1]=JMeter
Match[3][0]=JMeterCommitters">Contributors
Match[3][1]=JMeterCommitters
… and so on …

image/
audio/
video/

Scroll automatically?选项允许在树选择中显示最后一个节点

从版本3.2开始，视图中的条目数限制为属性view.results.tree.max_results的值，默认为500个条目。通过将属性设置为0可以恢复旧行为。请注意，这可能会占用大量内存。

通过“查找”选项，大多数视图还允许查找显示的数据；查询结果将在上面板中高亮显示。例如，下面的控制面板截图显示了查找“Java”的一个结果。注意搜索仅对可见文本进行操作，因此在搜索文本和HTML视图时可能会得到不同的结果。
注意：正则表达式使用Java引擎（不是正则表达式提取器或Regexp Tester视图使用的ORO引擎）。

如果未提供content-type，则内容将不会显示在任何响应数据面板中。在这种情况下，您可以使用保存响应到文件来保存数据。注意，响应数据在样本结果中仍然可用，因此可使用后置处理器进行访问。

如果响应数据大于200K，则不会显示。要更改此限制，请设置JMeter属性view.results.tree.max_size。您还可以使用保存响应到文件来保存整个响应。

可以创建其他渲染器。该类必须实现接口org.apache.jmeter.visualizers.ResultRenderer和/或扩展抽象类org.apache.jmeter.visualizers.SamplerResultTab，并且编译的代码必须可用于JMeter（例如，通过将其添加到lib/ext目录）。

查看结果树控制面板的截图

上图控制面板是HTML显示的示例。 图9（下图）是XML显示的示例。 图9a（下图）是Regexp tester显示的示例。 图9b（下图）是Document显示的示例。

图9 - XML样本显示

图9a - Regexp Tester样本显示

图9b - Document（此处为PDF）样本显示

【返回目录】

聚合报告

聚合报告为测试中的每个不同命名的请求创建一个表行。对于每个请求，它总计响应信息并提供请求计数，最小值，最大值，平均值，异常率，近似吞吐量（请求/秒）和每秒千字节吞吐量。测试完成后，吞吐量是整个测试期间的实际吞吐量。

吞吐量是从取样器目标（例如，HTTP样本的远程服务器）的角度计算的。JMeter考虑了生成请求的总时间。如果其他取样器和定时器位于同一线程中，则会增加总时间，从而降低吞吐量值。因此，具有不同名称的两个相同的取样器将具有两个具有相同名称的取样器的吞吐量的一半。正确选择取样器名称以从聚合报告中获得最佳结果非常重要。

计算中位数和90％线（第90百分位数）值需要额外的内存。JMeter现在将相同经过时间的样本相结合，因此使用的内存更少。但是，对于花费时间超过几秒的样本，或者另一种可能性是很少的样本具有相同的时间，在这种情况下需要更多的内存。注意您可以使用此监听器在测试结束后重新加载CSV或XML结果文件，这是避免性能影响的推荐方法。请参阅汇总报告了解类似的监听器，它不存储单个样本，因此需要恒定的内存。

从JMeter 2.12开始，您可以通过设置属性来配置要计算的3个百分位值：

• aggregate_rpt_pct1：默认为第90百分位数
• aggregate_rpt_pct2：默认为第95百分位数
• aggregate_rpt_pct3：默认为第99百分位数

• Label - 样本的标签。如果选择“在标签中包含组名称？”，则会添加线程组的名称作为前缀。这允许来自不同线程组的相同标签根据需要被单独整理。
• # 样本 - 具有相同标签的样本数
• 平均值 - 一组结果的平均时间
• 中位数 - 中位数是一组结果中间的时间。50％的样本不超过这个时间；其余的至少花了这么长时间。
• 90％百分位 - 90％的样本不超过这个时间。剩下的样本至少花了这么长时间。（第90百分位数）
• 95％百分位 - 95％的样本不超过这个时间。剩下的样本至少花了这么长时间。（第95百分位数）
• 99％百分位 - 99％的样本不超过这个时间。剩下的样本至少花了这么长时间。（第99百分位数）
• 最小值 - 具有相同标签的样本的最短时间
• 最大值 - 具有相同标签的样本的最长时间
• 异常 ％ - 异常请求的百分比
• 吞吐量 - 吞吐量以每秒/分钟/小时的请求来衡量。时间的单位会自动选择，使显示的速率至少为1.0。当吞吐量保存到CSV文件时，它以请求/秒表示，即30.0请求/分钟保存为0.5。
• 接收 KB/sec - 以每秒收到的千字节为单位测量的吞吐量
• 发送 KB/sec - 以每秒发送的千字节为单位测量的吞吐量

时间以毫秒为单位。

聚合报告控制面板的截图

下图显示了选择“在标签中包含组名称？”复选框的示例。

“在标签中包含组名称？”样本显示

【返回目录】

用表格查看结果

此可视化工具为每个样本结果创建一行。像查看结果树一样，此可视化工具使用大量内存。

默认情况下，它只显示主（父）样本；它不显示子样本。JMeter有一个“Child Samples?”复选框。如果选择此选项，则显示子样本而不是主样本。

用表格查看结果控制面板的截图

【返回目录】

简单数据写入器

此监听器可以将结果记录到文件中，但不能记录到UI。它旨在通过消除GUI开销来提供记录数据的有效方法。在CLI模式下运行时，-l标志可用于创建数据文件。要保存的字段由JMeter属性定义。有关详细信息，请参阅jmeter.properties文件。

简单数据写入器控制面板的截图

【返回目录】

汇总图

汇总图与聚合报告类似。主要区别在于汇总图提供了一种生成条形图并将图形保存为PNG文件的简便方法。

汇总图控制面板的截图

下图显示了绘制此图表的设置示例。

汇总图设置

注意：所有这些参数都不会保存在JMeter JMX脚本中。

参数

【返回目录】

响应时间图

响应时间图绘制了一个折线图，显示了测试期间每个标记请求的响应时间的演变。如果对于相同的时间戳存在许多样本，则显示平均值。

响应时间图控制面板的截图

下图显示了绘制此图表的设置示例。

响应时间图设置

注意：所有这些参数都保存在JMeter .jmx文件中。

参数

【返回目录】

邮件观察仪

如果测试运行从服务器收到太多失败的响应，可以设置使用邮件观察仪发送电子邮件。

邮件观察仪控制面板的截图

参数

【返回目录】

BeanShell监听器

BeanShell监听器允许使用BeanShell处理样本以保存等。

有关使用BeanShell的完整详细信息，请参阅BeanShell网站。

强烈建议迁移到JSR223监听器 + Groovy，以提高性能，支持新的Java功能并减少BeanShell库的维护。

测试元件支持ThreadListener和TestListener方法。这些应该在初始化文件中定义。有关定义的示例，请参阅文件BeanShellListeners.bshrc。

BeanShell监听器控制面板的截图

参数

在调用脚本之前，在BeanShell解释器中设置了一些变量：

• log - （日志记录器） - 可用于写入日志文件

• ctx - （JMeter上下文） - 允许访问上下文

• vars - (JMeter变量) - 提供对变量的读/写访问：

      vars.get(key);
      vars.put(key,val);
      vars.putObject("OBJ1",new Object());
  

• props - （JMeter属性 - 类java.util.Properties） - 例如props.get("START.HMS"); props.put("PROP1","1234");

• sampleResult，prev - （SampleResult） - 提供对前一个SampleResult的访问

• sampleEvent（SampleEvent）可以访问当前取样事件

有关上述每个变量的所有可用方法的详细信息，请查看Javadoc。

如果定义了属性beanshell.listener.init，则用于加载初始化文件，该文件可用于定义在BeanShell脚本中使用的方法等。

【返回目录】

汇总报告

汇总报告为测试中的每个不同命名的请求创建一个表行。这与聚合报告类似，只是它使用更少的内存。

吞吐量是从取样器目标（例如，HTTP样本的远程服务器）的角度计算的。JMeter考虑了生成请求的总时间。如果其他取样器和定时器位于同一线程中，则会增加总时间，从而降低吞吐量值。因此，具有不同名称的两个相同的取样器将具有两个具有相同名称的取样器的吞吐量的一半。正确选择取样器标签以从报告中获得最佳结果非常重要。

• Label - 样本的标签。如果选择“在标签中包含组名称？”，则会添加线程组的名称作为前缀。这允许来自不同线程组的相同标签根据需要被单独整理。
• # 样本 - 具有相同标签的样本数
• 平均值 - 一组结果的平均经过时间
• 最小值 - 具有相同标签样本的最短经过时间
• 最大值 - 具有相同标签样本的最长经过时间
• 标准偏差 - 样本经过时间的标准偏差
• 异常 ％ - 异常请求的百分比
• 吞吐量 - 吞吐量以每秒/分钟/小时的请求来衡量。自动选择时间单位，使显示的速率至少为1.0。当吞吐量保存到CSV文件时，它以请求/秒表示，即30.0请求/分钟保存为0.5。
• 接收 KB/sec - 以千字节/秒为单位测量的吞吐量
• 发送 KB/sec - 以千字节/秒为单位测量的吞吐量
• 平均字节数 - 样本响应的平均大小（以byte为单位）。

时间以毫秒为单位。

汇总报告控制面板的截图

下图显示了选择“包含组名称”复选框的示例。

“包含组名称”样本显示

【返回目录】

保存响应到文件

该测试元件可以放置在测试计划的任何位置。对于其范围内的每个样本，它都会创建响应数据的文件。这个的主要用途是创建功能测试，但在响应太大而无法在查看结果树监听器中显示的情况下，它也很有用 。文件名是根据指定的前缀和数字（除非禁用此参数，请参见下文）创建的。如果文档类型已知，则从文档类型创建文件扩展名。如果未知，则文件扩展名设置为“unknown”。如果禁用编号，并且禁用添加后缀，则将文件前缀作为整个文件名。这允许在需要时生成固定文件名。生成的文件名存储在样本响应中，如果需要，可以保存在测试日志输出文件中。

首先保存当前样本，然后保存任何子样本。如果提供了变量名称，则文件名将按子样本的显示顺序保存。见下文。

保存响应到文件控制面板的截图

参数

【返回目录】

JSR223监听器

JSR223 监听器允许将JSR223脚本代码应用于样本结果。

参数

在调用脚本之前，会设置一些变量。请注意，这些是JSR223变量 - 即它们可以直接在脚本中使用。

• log

  （Logger） - 可用于写入日志文件

• Label

  标签字符串

• FileName

  脚本文件名（如果有）

• Parameters

  参数（作为字符串）

• ARGS

  作为字符串数组的参数（在空格上拆分）

• CTX

  （JMeterContext） - 允许访问上下文

• vars

  （JMeterVariables） - 提供对变量的读/写访问权限：

  vars.get(key);
  vars.put(key,val);
  vars.putObject("OBJ1",new Object());
  vars.getObject("OBJ2");
  

• props

  （JMeterProperties - 类java.util.Properties） - 例如props.get("START.HMS"); props.put("PROP1","1234");

• sampleResult，prev

  （SampleResult） - 允许访问SampleResult

• sampleEvent

  （SampleEvent） - 提供对SampleEvent的访问

• sampler

  （取样器） - 允许访问最后一个取样器

• OUT

  System.out - 例如OUT.println("message")

有关上述每个变量的所有可用方法的详细信息，请查看Javadoc

【返回目录】

生成概要结果

该测试元件可以放置在测试计划的任何位置。生成到目前为止测试运行的摘要到日志文件和/或标准输出。显示运行和差异总计。在适当的时间边界上每n秒（默认为30秒）生成输出，以便同步多个同时运行的测试。有关汇总器配置项，请参阅jmeter.properties文件：

# Define the following property to automatically start a summariser with that name
# (applies to CLI mode only)
#summariser.name=summary
#
# interval between summaries (in seconds) default 3 minutes
#summariser.interval=30
#
# Write messages to log file
#summariser.log=true
#
# Write messages to System.out
#summariser.out=true

该元件主要用于批处理（CLI）运行。输出如下所示：

label +     16 in 0:00:12 =    1.3/s Avg:  1608 Min:  1163 Max:  2009 Err:     0 (0.00%) Active: 5 Started: 5 Finished: 0
label +     82 in 0:00:30 =    2.7/s Avg:  1518 Min:  1003 Max:  2020 Err:     0 (0.00%) Active: 5 Started: 5 Finished: 0
label =     98 in 0:00:42 =    2.3/s Avg:  1533 Min:  1003 Max:  2020 Err:     0 (0.00%)
label +     85 in 0:00:30 =    2.8/s Avg:  1505 Min:  1008 Max:  2005 Err:     0 (0.00%) Active: 5 Started: 5 Finished: 0
label =    183 in 0:01:13 =    2.5/s Avg:  1520 Min:  1003 Max:  2020 Err:     0 (0.00%)
label +     79 in 0:00:30 =    2.7/s Avg:  1578 Min:  1089 Max:  2012 Err:     0 (0.00%) Active: 5 Started: 5 Finished: 0
label =    262 in 0:01:43 =    2.6/s Avg:  1538 Min:  1003 Max:  2020 Err:     0 (0.00%)
label +     80 in 0:00:30 =    2.7/s Avg:  1531 Min:  1013 Max:  2014 Err:     0 (0.00%) Active: 5 Started: 5 Finished: 0
label =    342 in 0:02:12 =    2.6/s Avg:  1536 Min:  1003 Max:  2020 Err:     0 (0.00%)
label +     83 in 0:00:31 =    2.7/s Avg:  1512 Min:  1003 Max:  1982 Err:     0 (0.00%) Active: 5 Started: 5 Finished: 0
label =    425 in 0:02:43 =    2.6/s Avg:  1531 Min:  1003 Max:  2020 Err:     0 (0.00%)
label +     83 in 0:00:29 =    2.8/s Avg:  1487 Min:  1023 Max:  2013 Err:     0 (0.00%) Active: 5 Started: 5 Finished: 0
label =    508 in 0:03:12 =    2.6/s Avg:  1524 Min:  1003 Max:  2020 Err:     0 (0.00%)
label +     78 in 0:00:30 =    2.6/s Avg:  1594 Min:  1013 Max:  2016 Err:     0 (0.00%) Active: 5 Started: 5 Finished: 0
label =    586 in 0:03:43 =    2.6/s Avg:  1533 Min:  1003 Max:  2020 Err:     0 (0.00%)
label +     80 in 0:00:30 =    2.7/s Avg:  1516 Min:  1013 Max:  2005 Err:     0 (0.00%) Active: 5 Started: 5 Finished: 0
label =    666 in 0:04:12 =    2.6/s Avg:  1531 Min:  1003 Max:  2020 Err:     0 (0.00%)
label +     86 in 0:00:30 =    2.9/s Avg:  1449 Min:  1004 Max:  2017 Err:     0 (0.00%) Active: 5 Started: 5 Finished: 0
label =    752 in 0:04:43 =    2.7/s Avg:  1522 Min:  1003 Max:  2020 Err:     0 (0.00%)
label +     65 in 0:00:24 =    2.7/s Avg:  1579 Min:  1007 Max:  2003 Err:     0 (0.00%) Active: 0 Started: 5 Finished: 5
label =    817 in 0:05:07 =    2.7/s Avg:  1526 Min:  1003 Max:  2020 Err:     0 (0.00%)

“label”是元件的名称。“+”意味着该行是一个变化行，即显示了从上次输出之后的变化。
“=”表示该行是一个总计行，即其示出了运行总数。
JMeter日志文件中的条目还包括时间戳。例如“817 in 0:05:07 = 2.7/s”表示在5分7秒内记录了817个样本，并且每秒处理2.7个样本。
Avg（平均值），Min（最小值）和Max（最大值）时间以毫秒为单位。
“Err”表示异常数量（也显示为百分比）。
最后两行将出现在测试结束时。它们不会与适当的时间边界同步。注意初始和最终变化量可能小于设置的间隔（在上面的示例中，是30秒）。第一个变化量通常较低，因为JMeter与间隔边界同步。最后的变化量将更低，因为测试通常不会在精确的间隔边界上完成。

标签用于将样本结果在一起分组。因此，如果您有多个线程组并希望对它���进行汇总，那么请使用相同的标签 - 或将汇总器添加到测试计划中（因此所有线程组都在范围内）。可以通过使用合适的标签并将摘要器添加到测试计划的适当部分来实现不同的概要分组。

在CLI模式，默认情况下会配置名为“summariser”的生成概要结果监听器，如果您已在测试计划中添加了一个，请确保命名不同，否则将在此标签（概要）下累积结果，从而导致错误的结果（样本总和+位于生成摘要结果监听器父级下面的样本数）。 这不是一个bug，而是一个允许跨线程组进行汇总的设计选择。

生成摘要结果控制面板的截图

参数

【返回目录】

比较断言可视化器

比较断言可视化器显示任何比较断言元件的结果。

比较断言可视化器控制面板的截图

参数

【返回目录】

后端监听器

后端监听器是一个异步监听器，允许您插入BackendListenerClient的自定义实现。默认情况下，提供Graphite实现。

后端监听器控制面板的屏幕截图

参数

以下参数适用于GraphiteBackendListenerClient实现：

参数

有关更多详细信息，请参阅实时结果。

Grafana仪表板

从JMeter 3.2开始，添加了一个允许使用自定义模式直接在InfluxDB中编写的新实现，它被称为InfluxdbBackendListenerClient。以下参数适用于InfluxdbBackendListenerClient实现：

参数

有关更多详细信息，另请参阅实时结果和Grafana中的Influxdb注释。

【返回目录】

18.4 配置元件

配置元件可用于设置默认值和变量，供后续取样器使用。注意这些元件在它们范围开始处处理，即在相同范围内的任何取样器之前处理。

CSV 数据文件设置

CSV 数据文件设置用于从文件中读取行，并将它们拆分为变量。它比__CSVRead()和__StringFromFile()函数更容易使用。它非常适合处理大量变量，对于使用“随机”和唯一值进行测试也很有用。

在运行时生成唯一的随机值在CPU和内存消耗方面是很大的，因此最好在测试之前创建数据。如有必要，文件中的“随机”数据可以与运行时参数一起使用，以便在每次运行中创建不同的值集 - 例如使用级联 - 这比在运行时生成所有内容消耗的资源小得多。

JMeter允许引用值；这允许值包含分隔符。如果启用“是否允许带引号”，则可以用双引号括起值。双引号在引用时会被删除。要在引用字段中包含双引号，请使用两个双引号。例如：

1,"2,3","4""5" =>
1
2,3
4"5

JMeter支持带具有定义列名称的标题行的CSV文件。要启用此功能，请将“变量名称”字段留空。还必须提供正确的分隔符。

JMeter支持包含新行的带引号数据的CSV文件。

默认情况下，文件只打开一次，每个线程将使用文件中的不同行。但是，行传递给线程的顺序取决于它们执行的顺序，这可能在迭代之间有所不同。在每次测试迭代开始时读取行。在第一次迭代中解析文件名和模式。

有关其他选项，请参阅下面的共享模式说明。如果您希望每个线程都有自己的一组值，那么您将需要创建一组文件，每个线程对应一个。例如test1.csv，test2.csv，...，testn.csv。使用文件名test${__threadNum}.csv并将“线程共享模式”设置为“当前线程”。

CSV 数据文件变量在每次测试迭代开始时定义。由于这是在配置处理完成之后，它们不能用于某些配置选项 - 例如JDBC配置 - 在配置时处理它们的内容（参见Bug 40394）。但是变量在HTTP授权管理器中起作用，如用户名等。因为是在运行时处理。

作为一种特殊情况，分隔符字段中的字符串“ \t”（不带引号）被视为制表符（Tab）。

到达文件结尾（EOF）并且循环选项为true时，将再次从文件的第一行开始读取。

如果再次循环选项为false，并且停止线程为false，则在到达文件末尾时，所有变量都将设置为<EOF>。可以通过设置JMeter属性csvdataset.eofstring来更改此值。

如果再次循环选项为false，并且止线程为true，则到达EOF将导致线程停止。

CSV 数据文件设置控制面板的截图

参数

【返回目录】

FTP请求默认值

FTP请求默认值控制面板的截图

【返回目录】

DNS缓存管理器

当用户从不同的IP接收内容时，DNS缓存管理器元件允许测试在负载平衡器（CDN等）后面有多个服务器的应用程序。默认情况下，JMeter使用JVM DNS缓存。这就是集群中只有一台服务器接收负载的原因。DNS缓存管理器在每次迭代时分别解析每个线程的名称，并将解析结果保存到其内部DNS缓存中，该缓存独立于JVM和系统DNS缓存。

静态主机的映射可用于模拟/etc/hosts文件之类的。这些条目将优先于自定义解析程序。如果要使用此映射，则必须启用Use custom DNS resolver。

静态主机表的用法

比如，您有一个测试服务器，您希望使用名称来访问，该名称尚未在您的DNS服务器中设置。在我们的例子中，服务器名称是www.example.com，您希望通过服务器的IP地址a123.another.example.org来访问。

您可以更改工作站并在/etc/hosts文件中添加条目- 或者等效于在您的操作系统中，在DNS缓存管理器的静态主机表中添加条目。

您可以在第一列（Host）中键入www.example.com， 在第二列（Hostname or IP address）中键入a123.another.example.org。正如第二列的名称所暗示的那样，您甚至可以使用测试服务器的IP地址。

将使用自定义DNS解析程序查找测试服务器的IP地址。如果没有给出，将使用系统DNS解析器。

现在，您可以在HTTPClient4取样器中使用www.example.com，并且对于a123.another.example.org的所有请求，使用www.example.com设置的信息头。

DNS缓存管理器控制面板的截图

DNS缓存管理器设计用于在线程组或测试计划的根节点中使用。不要将其作为特定HTTP取样器的子元件

DNS缓存管理器仅适用于使用HTTPClient4实现的HTTP请求。

参数

【返回目录】

HTTP授权管理器

授权管理器允许您为使用服务器身份认证限制的网页指定一个或多个用户登录。当您使用浏览器访问受限页面时，您会看到此类型的身份认证，并且浏览器会显示登录对话框。JMeter在遇到此类页面时会传输登录信息。

授权信息头可能不会显示在树视图监听器“请求”选项卡中。Java实现会执行抢先认证，但在JMeter获取信息头时它不会返回授权信息头。HttpComponents（HC 4.5.X）实现从3.2版本之后默认执行抢先认证，并且显示信息头。要禁用此功能，请按下面方式设置值，在这种情况下，只有响应质询时会执行身份认证。

在jmeter.properties文件中设置httpclient4.auth.preemptive=false

注意：以上设置仅适用于HttpClient取样器。

在查找URL匹配时，JMeter依次检查每个条目，并在找到第一个匹配时停止。因此，最明确的URL应首先出现在列表中，然后是不太明确的URL。重复的网址将被忽略。如果要为不同的线程使用不同的用户名/密码，可以使用变量。这些可以通过CSV数据文件设置元件（举例）进行设置。

HTTP授权管理器控制面板的截图

如果取样器范围内有多个授权管理器，目前是无法指定要使用哪个的。

参数

Realm仅适用于HttpClient取样器。

Kerberos配置：

要配置Kerberos，您需要设置至少两个JVM系统属性：

• -Djava.security.krb5.conf=krb5.conf
• -Djava.security.auth.login.config=jaas.conf

您还可以在文件bin/system.properties中配置这两个属性。查看位于JMeterbin文件夹中的两个示例配置文件（krb5.conf和jaas.conf），以获取对更多文档的引用，并调整它们以匹配您的Kerberos配置。

SPNEGO默认禁用证书授权。可以通过将属性kerberos.spnego.delegate_cred设置为true来启用它。

为Kerberos SPNEGO授权生成SPN时，IE和Firefox将省略URL中的端口号。如果端口号与标准端口号不同（80和443），Chrome有一个选项（--enable-auth-negotiate-port）可以包含端口号。可以通过设置以下JMeter属性来模拟该行为。

在jmeter.properties或user.properties中，设置：

• kerberos.spnego.strip_port=false

控制：

• 添加按钮 - 向授权表添加条目。
• 删除按钮 - 删除当前选定的表条目。
• 载入按钮 - 加载以前保存的授权表，并将条目添加到现有授权表条目中。
• 保存测试计划按钮 - 将当前授权表保存到文件中。

保存测试计划时，JMeter会自动保存所有授权表条目 - 包括任何未加密的密码。

授权示例

下载此示例。在此示例中，我们在本地服务器上创建了一个测试计划，该服务器发送3个HTTP请求，两个需要登录，另一个对所有人开放。请参见图10，了解我们的测试计划的组成。在我们的服务器上，我们有一个名为“secret” 的受限目录，其中包含两个文件“index.html”和“index2.html”。我们创建了一个名为“kevin” 的登录ID ，其密码为“spot”。因此，在我们的授权管理器中，我们为受限目录创建了一个带用户名和密码的条目（参见图11）。名为“SecretPage1”和“SecretPage2” 的两个HTTP请求发送到”/secret/index.html“和”/secret/index2.html“。另一个名为”NoSecretPage“的HTTP 请求发送到”/index.html“ 。

图10 - 测试计划

图11 - 授权管理器控制面板

当我们运行测试计划时，JMeter在授权表中查找它请求的URL。如果基本URL与URL匹配，则JMeter会将此信息与请求一起传递。

您可以下载测试计划，但由于它是作为本地服务器的测试而构建的，因此您将无法运行它。但是，您可以将其用作构建自己的测试计划的参考。

【返回目录】

HTTP缓存管理器

HTTP缓存管理器用于向其范围内的HTTP请求添加缓存功能，以模拟浏览器缓存功能。每个虚拟用户线程都有自己的缓存。默认情况下，缓存管理器将使用LRU算法在每个虚拟用户线程的缓存中存储多达5000个项目。使用属性“maxSize”修改此值。注意，此值增加越多，HTTP缓存管理器消耗的内存也越多，因此请务必相应地调整-XmxJVM选项。

如果样本成功（即响应代码为2xx），则会为URL保存Last-Modified和Etag（以及相关的Expired）值。在执行下一个样本之前，取样器会检查缓存中是否有条目，如果是，则为请求设置If-Last-Modified和If-None-Match条件信息头。

此外，如果选择“Use Cache-Control/Expires header”选项，则会根据当前时间检查Cache-Control/Expires值。如果请求是GET请求，并且时间戳是将来的，则取样器会立即返回，而不从远程服务器请求URL。这旨在模拟浏览器行为。请注意，如果Cache-Control信息头为“no-cache”，则响应将作为预过期存储在缓存中，因此将生成条件GET请求。如果Cache-Control有任何其他值，则“max-age“到期选项将会执行以计算条目生存期，如果丢失则将使用expire信息，如果还缺失条目将按照RFC 2616第13.2.4节中的规定使用Last-Modified时间和响应日期进行缓存。

如果请求的文档在缓存后没有更改，则响应正文将为空。同样，如果Expires日期是将来。这可能会导致断言出现问题。

HTTP缓存管理器控制面板的截图

参数

【返回目录】

HTTP Cookie管理器

Cookie管理器元件有两个功能： 首先，它像Web浏览器一样存储和发送Cookie。如果您有HTTP请求并且响应包含cookie，则Cookie管理器会自动存储该cookie，并将其用于之后对该特定网站的所有请求。每个JMeter线程都有自己的“cookie存储区”。因此，如果您正在测试使用cookie存储会话信息的网站，则每个JMeter线程都将拥有自己的会话。注意这样的Cookie不会显示在Cookie管理器显示屏上，但可以使用“查看结果树监听器”查看它们。

JMeter检查收到的cookie是否对URL有效。这意味着不存储跨域cookie。如果您有窃听行为或希望使用跨域cookie，请定义JMeter属性“CookieManager.check.cookies=false”。

收到的Cookie可以存储为JMeter线程变量。要将cookie保存为变量，请定义属性“CookieManager.save.cookies=true”。此外，cookie名称在存储之前以“COOKIE_” 为前缀（这可以避免意外损坏局部变量）。要恢复原始行为，请定义属性“CookieManager.name.prefix=”（一个或多个空格）。如果启用，名称为TEST的cookie的值可以被${COOKIE_TEST}引用。

其次，您可以手动将Cookie添加到Cookie管理器。但是，如果这样做，cookie将被所有JMeter线程共享。

注意，此类Cookie创建时的过期时间过长

默认情况下，将忽略具值为null的Cookie 。这可以通过设置JMeter属性来更改：CookieManager.delete_null_cookies=false。注意这也适用于手动定义的cookie - 任何这样的cookie将在更新时不再显示。另请注意，所有cookie名称必须是唯一的 - 如果第二个cookie使用相同的名称定义，则它将替换第一个cookie。

HTTP Cookie管理器的控制面板的截图

如果取样器范围内有多个Cookie管理器，目前无法指定要使用哪个Cookie管理器。此外，存储在一个cookie管理器中的cookie不可用于任何其他管理器，因此请谨慎使用多个Cookie管理器。

参数

【返回目录】

HTTP请求默认值

此元件允许您设置HTTP请求控制器使用的默认值。例如，如果要创建具有25个HTTP请求控制器的测试计划并且所有请求都发送到同一服务器，则可以添加单个HTTP请求默认值元件，并填写“服务器名称或IP”字段。然后，当您添加25个HTTP请求控制器时，请将“服务器名称或IP”字段留空。控制器将从HTTP请求默认值元件继承此字段值。

所有端口的值也同样处理；未指定端口的取样器将使用HTTP请求默认值里的端口号（如果提供了端口）。

HTTP请求默认值控制面板的截图

HTTP请求高级配置字段

参数

注意：单选按钮只有两种状态 - 开或关。这使得无法一致地覆盖设置 - 关闭意味着关闭，还是意味着使用当前默认设置？JMeter使用后者（否则默认值根本不起作用）。因此，如果按钮关闭，则后面的元件可以将其设置为打开，但如果按钮处于打开状态，则后面的元件无法将其设置为关闭。

【返回目录】

HTTP信息头管理器

信息头管理器允许您添加或覆盖HTTP请求信息头。

JMeter现在支持多个信息头管理器。合并信息头条目以形成取样器的列表。如果要合并的条目与现有信息头名称匹配，则它将替换先前的条目。这允许您设置一组默认信息头，并对特定取样器应用调整。注意信息头的空值不会删除现有信息头，只是替换其值。

HTTP信息头管理器控制面板的截图

参数

信息头管理器示例

下载此示例。在此示例中，我们创建了一个测试计划，告诉JMeter覆盖默认的“User-Agent”请求信息头，并使用特定的Internet Explorer代理字符串。（见图12和13）。

图12 - 测试计划

图13 - 信息头管理器控制面板

【返回目录】

Java默认请求

Java默认请求组件允许您为Java测试设置默认值。请参阅Java请求。

Java默认请求控制面板的截图

【返回目录】

JDBC连接配置

从支持的JDBC连接设置创建数据库连接（提供给JDBC请求取样器使用）。可以在线程之间随意建立连接池连接，也可以让每个线程单独连接。JDBC取样器通过连接配置名称来选择适当的连接。使用的连接池是DBCP，请参阅BasicDataSource配置参数。

JDBC连接配置控制面板的截图

参数

不同的数据库和JDBC驱动程序需要不同的JDBC设置。数据库URL和JDBC驱动类由JDBC实现的提供程序定义。

下面是一些可能的设置。请查看JDBC驱动程序文档中的确切详细信息。

如果JMeter报告No suitable driver（没有合适的驱动程序），那么这可能意味着：

• 找不到驱动程序类。在这种情况下，会有一条日志消息，例如DataSourceElement: Could not load driver: {classname} java.lang.ClassNotFoundException: {classname}
• 找到了驱动程序类，但该类不支持连接字符串。这可能是因为连接字符串中存在语法错误，或者因为使用了错误的类名。

如果数据库服务器未运行或无法访问，则JMeter将报告java.net.ConnectException。

下面给出了数据库及其参数的一些示例。

MySQL

• Driver class

  com.mysql.jdbc.Driver

• Database URL

  jdbc:mysql://host[:port]/dbname

PostgreSQL

• Driver class

  org.postgresql.Driver

• Database URL

  jdbc:postgresql:{dbname}

Oracle

• Driver class

  oracle.jdbc.OracleDriver

• Database URL

  jdbc:oracle:thin:@//host:port/service或jdbc:oracle:thin:@(description=(address=(host={mc-name})(protocol=tcp)(port={port-no}))(connect_data=(sid={sid})))

Ingress (2006)

• Driver class

  ingres.jdbc.IngresDriver

• Database URL

  jdbc:ingres://host:port/db[;attr=value]

Microsoft SQL Server (MS JDBC driver)

• Driver class

  com.microsoft.sqlserver.jdbc.SQLServerDriver

• Database URL

  jdbc:sqlserver://host:port;DatabaseName=dbname

Apache Derby

• Driver class

  org.apache.derby.jdbc.ClientDriver

• Database URL

  jdbc:derby://server[:port]/databaseName[;URLAttributes=value[;…]]

以上可能不正确 - 请查看相关的JDBC驱动程序文档。

【返回目录】

密钥库配置

密钥库配置元件允许您配置密钥库的加载方式以及它将使用的密钥。此组件通常用于您不希望在响应时间中考虑密钥库初始化时间的HTTPS方案中。

要使用此元件，您需要首先使用要测试的客户端证书设置Java密钥库，以执行此操作：

1. 使用Javakeytool实用程序或通过PKI创建证书

2. 如果由PKI创建，请将密钥转换为JKS可接受的格式再导入Java密钥库

3. 然后通过两个JVM属性引用密钥库文件（或在system.properties中添加它们）：

   • -Djavax.net.ssl.keyStore=path_to_keystore
   • -Djavax.net.ssl.keyStorePassword=password_of_keystore

密钥库配置控制面板的截图

参数

要使JMeter使用多个证书，您需要确保：

• 在jmeter.properties或user.properties中设置了https.use.cached.ssl.context=false
• 您对HTTP请求使用HTTPClient 4实现

【返回目录】

登录配置元件

登录配置元件允许您在使用用户名和密码作为其设置的一部分的取样器中添加或覆盖用户名和密码设置。

登录配置元件控制面板的截图

参数

【返回目录】

LDAP默认请求

LDAP默认请求组件允许您为LDAP测试设置默认值。请参阅LDAP请求。

LDAP默认请求控制面板的截图

【返回目录】

LDAP扩展请求默认值

LDAP扩展请求默认值组件允许您为LDAP扩展测试设置默认值。请参阅LDAP扩展请求。

LDAP扩展请求默认值控制面板的截图

【返回目录】

TCP取样器配置

TCP取样器配置为TCP取样器提供默认数据。

TCP取样器配置控制面板的截图

参数

【返回目录】

用户定义的变量

用户定义的变量元件允许您定义一组初始变量，就像在测试计划中一样。

注意，测试计划中的所有用户定义的变量元件 - 无论它们在何处 - 都会在开始时进行处理。

因此，您无法引用定义为测试运行一部分的变量，例如在后置处理器中。

用户定义的变量不应与每次调用时生成不同结果的函数一起使用。只有第一个函数调用的结果才会保存在变量中。但是，用户定义的变量可以与__P()等函数一起使用，例如：

HOST      ${__P(host,localhost)}

这将定义变量“HOST”并赋JMeter属性“host” 的值，如果未定义则默认为“localhost”。

要在测试运行期间定义变量，请参阅用户参数。用户定义的变量按照它们在计划中出现的顺序从上到下进行处理。

为简单起见，建议将用户定义的变量仅放置在线程组的开头（或者在测试计划本身下）。

一旦处理了测试计划和所有用户定义的变量，就会将生成的变量集复制到每个线程以提供初始变量集。

如果运行时元件（例如用户参数前置处理器或正则表达式提取器）定义了与其中一个用户定义的变量同名的变量，那么这将替换初始值，并且线程中的所有其他测试元件将看到更新的值。

用户定义的变量控制面板的截图

如果您有多个线程组，请确保为不同的值使用不同的名称，因为户定义的变量在线程组之间共享。此外，在元件被处理之后变量才可用，因此您无法引用在同一元件中定义的变量。您可以引用之前用户定义的变量或测试计划中定义的变量。

参数

【返回目录】

随机变量

随机变量配置元件用于生成随机数字符串并将它们存储在变量中以供以后使用。它比使用用户定义的变量和__Random()函数更简单。

使用随机数生成器构造输出变量，然后使用格式字符串格式化结果数字。数字的计算使用公式minimum+Random.nextInt(maximum-minimum+1)。Random.nextInt()需要一个正整数。这意味着最大值-最小值 - 即范围 - 必须小于2147483647，但是只要在范围内，最小值和最大值可以是任何long值。

由于在每次迭代开始时评估随机值，因此使用属性以外的变量作为最小值或最大值的值可能不是一个好主意。在第一次迭代时它将为零。

随机变量控制面板的截图

参数

【返回目录】

计数器

允许用户创建可在线程组中的任何位置引用的计数器。计数器配置允许用户配置起始值，最大值和递增值。计数器将从起始循环到最大，然后从起始重新开始，继续这样直到测试结束。

计数器使用long类型来存储值，因此范围从-2^63到2^63-1。

计数器控制面板的截图

参数

【返回目录】

简单配置元件

简单配置元件允许您在取样器中添加或覆盖任意值。您可以选择值的名称和值本身。虽然一些有冒险精神的用户可能会发现这个元件的用途，但它主要是供开发人员在开发新的JMeter组件时使用的基本GUI。

简单配置元件控件面板的截图

参数

【返回目录】

MongoDB源配置（已弃用）

【返回目录】

18.5 断言

断言用于对取样器执行附加检查，并在同一范围内的每个取样器之后进行处理。要确保仅将断言应用于特定取样器，请将其添加为取样器的子级。

注意：除非另有说明，否则断言不适用于子样本 - 仅适用于父样本。对于JSR223和BeanShell断言，脚本可以使用prev.getSubResults()方法检索子样本，该方法返回取样结果数组。如果没有结果，则数组将为空。

断言可以应用于主样本，子样本或两者。默认设置是仅将断言应用于主样本。如果断言支持此选项，则GUI上将显示如下所示的条目：

断言范围

或如下

断言范围

如果子取样器失败且主样本成功，则主样本将设置为失败状态，并将添加断言结果。如果使用JMeter变量选项，则假定它与主样本相关，并且任何失败将仅应用于主样本。

在运行了取样器的所有断言之后，变量JMeterThread.last_sample_ok将更新为“true”或“false”。

响应断言

响应断言控制面板允许您添加模式字符串来和请求或响应的各个字段进行比较。模式字符串是：

• 包括，匹配：Perl5风格的正则表达式
• 相等，字符串：纯文本，区分大小写

模式匹配字符的摘要可以参阅ORO Perl5正则表达式。

您还可以选择是否期望字符串与整个响应匹配，或者是否仅期望响应包括该模式。您可以将多个断言附加到任何控制器，以获得额外的灵活性。

注意模式字符串不应包含封闭分隔符，即使用Price: \d+而不是/Price: \d+/。

默认情况下，模式处于多行模式，这意味着“.”元字符与换行符不匹配。在多行模式下，“^”和“$”匹配字符串中任何位置的任何行的开头或结尾 - 而不仅仅是整个字符串的开头和结尾。请注意\s确实匹配换行符。不忽略大小写。要覆盖这些设置，可以使用扩展的正则表达式语法。例如：

• (?i)

  忽略大小写

• (?s)

  将目标视为单行，即“.”匹配新行

• (?is)

  以上都是

这些可以在表达式中的任何位置使用，并在被覆盖之前保持有效。例如

• (?i)apple(?-i) Pie

  匹配“ApPLe Pie”，但不匹配“ApPLe pIe”

• (?s)Apple.+?Pie

  匹配Apple，然后是Pie，后者可能会在后续行中。

• Apple(?s).+?Pie

  与上面相同，但在开始时使用(?s)可能更清楚。

响应断言控制面板的截图

参数