19 简介¶

本文档描述了 JMeter 属性。jmeter.properties或reportgenerator.properties中存在的属性应在user.properties文件中设置。这些属性仅在重新启动 JMeter 后才会考虑，因为它们通常在加载类时解决。

19.1 语言¶

参数

属性

描述

必需的

语言

首选的 GUI 语言。注释掉以使用 JVM 默认语言环境的语言。
例子：

language=en

此属性是唯一必须在jmeter.properties文件中设置的属性

要完全配置语言，请确保设置语言环境，请参阅国际化：了解 Java 平台中的语言环境。英语示例：

-Duser.language=en -Duser.region=EN

不

语言环境.add

要添加到显示列表的其他语言环境。
当前的默认列表是：en、fr、 de、no、es、tr、 ja、zh_CN、 zh_TW、pl、pt_BR。
请参阅JMeterMenuBar#makeLanguageMenu()
条目是以逗号分隔的语言名称列表。
例子：

locales.add=zu

不

19.2 XML解析器¶

参数

属性

描述

必需的

xpath.namespace.config

包含格式为prefix=Namespace 的命名空间映射的属性文件的路径。例子：

ns=http://biz.aol.com/schema/2006-12-18

不

xpath2query.parser.cache.size

XPath2 查询缓存，用于存储已编译的 XPath 查询默认为400

不

19.3 SSL 配置¶

SSL (Java) 系统属性现在在system.properties
JMeter 不再转换javax。jmeter.properties中的xxx属性条目到系统属性中。这些现在必须在system.properties文件或命令行中定义。system.properties 文件提供了更大的灵活性。

参数

属性

描述

必需的

https.sessioncontext.shared

默认情况下，SSL 会话上下文现在是按线程创建的，而不是共享的。
可以通过将此属性设置为true来启用旧行为。默认为：假

不

https.default.protocol

请注意，https 默认协议可能会因 JVM 的版本而异。请参阅诊断 TLS、SSL 和 HTTPS 和错误 58236。默认 HTTPS 协议级别：

https.default.protocol=TLS

这可能需要更改为：

https.default.protocol=SSLv3

不

https.socket.protocols

要启用的协议列表。如果您发现目标服务器存在问题，您可能只需要选择一个子集。
当服务器不支持 Socket 版本协商时需要这样做，这可能会导致错误，例如： javax.net.ssl.SSLPeerUnverifiedException: peer not authenticated 或java.net.SocketException: Connection reset。
请参阅错误 54759，例如：

https.socket.protocols=SSLv2Hello SSLv3 TLSv1

不

https.cipherSuites

可用于 HTTPS 连接的 SSL 密码套件的逗号分隔列表。当与大量用户一起运行时，可能需要使用密码套件的子集以匹配预期的客户端行为或减少 JMeter 中的加密开销。如果 JVM 不支持指定的密码套件，或者 HTTPS 服务器支持的密码套件不与此列表重叠，则可能会发生错误。请参阅 JSSE 参考指南。
例如：

https.cipherSuites=TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,TLS_RSA_WITH_AES_128_GCM_SHA256

如果未指定，JMeter 将使用 JVM 支持的默认密码套件列表。

不

httpclient.reset_state_on_thread_group_iteration

开始新的线程组迭代时重置 HTTP 状态。总之， true意味着下一次迭代与新用户相关联。 false表示下一次迭代与同一用户相关联。真正的涉及：

关闭打开的连接
重置 SSL 状态

默认为：真

不

https.use.cached.ssl.context

控制我们是否允许在迭代之间重用缓存的 SSL 上下文。
将该值设置为false以在每次迭代时重置 SSL 上下文。
默认为：真

已弃用，您应该使用具有正确值的httpclient.reset_state_on_thread_group_iteration

不

https.keyStoreStartIndex

与具有许多条目的密钥库一起使用的开始索引。
默认是使用条目0，即第一个。
默认为：0

不

https.keyStoreEndIndex

与具有许多条目的密钥库一起使用的结束索引。
默认为：0

不

19.4 外观配置¶

参数

属性

描述

必需的

jmeter.laf.windows_10

Swing 默认 UI
的类名当悬停在选项/外观选择列表上时，可用的 LAF 类名现在显示为工具提示文本。
您可以使用完整的类名，如下所示，也可以使用字符串“ System ”或“ CrossPlatform ”之一，这意味着 JMeter 将使用UIManager.get<name>LookAndFeelClassName()返回的相应字符串。
LAF 可以被os.name覆盖（小写，空格替换为“_”）。

LAF 属性查找顺序¶

以Windows 10的os.name 为例。 JMeter 会首先寻找一个属性

jmeter.laf.windows_10=javax.swing.plaf.metal.MetalLookAndFeel

否则，操作系统系列os.name将被缩短为第一个空格。因此，在我们的示例中，JMeter 会寻找一个属性

jmeter.laf.windows=com.sun.java.swing.plaf.windows.WindowsLookAndFeel

设置系统 LAF 后，Mac 显然看起来更好

jmeter.laf.mac=System

否则，可以通过以下方式定义 JMeter 默认 LAF：

jmeter.laf=System

如果上述jmeter.laf属性均未定义，则 JMeter 使用CrossPlatform LAF。这是因为CrossPlatform LAF 通常看起来比System LAF 更好。有关详细信息，请参阅错误 52026。

当您通过菜单 Options > Look and Feel 从 JMeter GUI 更改 Look and Feel (LAF) 时，您应该重新启动 JMeter 以确保更改完全有效。

不

jmeter.loggerpanel.display

显示记录器面板。
默认为：假

不

jmeter.loggerpanel.enable_when_close

启用 LogViewer 面板即使在关闭时也能接收日志事件。
自 2.12 起启用

请注意，这对性能有一些影响，但由于不得将 GUI 模式用于负载测试，因此可以接受

默认为：真

不

jmeter.loggerpanel.maxlength

LoggerPanel 中保存的最大行数，0表示没有限制。
默认为：1000

不

jmeter.gui.refresh_period

处理监听器事件的间隔时间（毫秒）。
默认为：500

不

19.4.1 Darklaf 配置¶

参数

属性

描述

必需的

darklaf.decorations

使用 Darklaf 外观时启用自定义窗口镶边。默认为：假

不

darklaf.unifiedMenuBar

使用 Darklaf 外观时启用 Windows 上的统一菜单栏。只有当darklaf.native为true
时，此属性才有效。默认为：真

不

19.5 工具栏显示¶

参数

属性

描述

必需的

jmeter.toolbar.icons

工具栏图标定义。
默认为org/apache/jmeter/images/toolbar/icons-toolbar.properties

不

jmeter.toolbar

工具栏列表。
默认为：

new,open,close,save,save_as_testplan,|,cut,copy,paste,|,expand,collapse,toggle,|,test_start,test_stop,test_shutdown,|,test_start_remote_all,test_stop_remote_all,test_shutdown_remote_all,|,test_clear,test_clear_all,|,search,search_reset,|,function_helper,help

不

jmeter.toolbar.icons.size

可用尺寸为：22x22、32x32、48x48。_ HiDPI 模式的建议值为

jmeter.toolbar.icons.size=48x48

默认为：22x22

不

jmeter.icons

图标定义。备用套装：

jmeter.icons=org/apache/jmeter/images/icon_1.properties

历史图标集（已弃用）：

jmeter.icons=org/apache/jmeter/images/icon_old.properties

默认为：org/apache/jmeter/images/icon.properties

不

jmeter.tree.icons.size

可用尺寸为：19x19、24x24、32x32、48x48。_ _ _ 对 HiDPI 显示很有用（见下文）。默认为：19x19 HiDPI 屏幕（如 3200x1800）的建议值为：32x32

不

jmeter.hidpi.mode

HiDPI 模式。激活“伪”-HiDPI 模式。允许在 Linux 或 Windows 中使用高分辨率屏幕增加一些未被 JVM 正确管理的 UI 元素的大小。
默认为：假

不

jmeter.hidpi.scale.factor

HiDPI 比例因子。HiDPI 的建议值：2.0。默认为：1.0

不

not_in_menu

不显示在 JMeter GUI 中的组件（GUI 类名称或静态标签）。
这些元素已被弃用，并将在下一个版本中删除：

MongoDB Script, MongoDB Source Config

默认为：

org.apache.jmeter.protocol.mongodb.sampler.MongoScriptSampler, org.apache.jmeter.protocol.mongodb.config.MongoSourceElement

不

undo.history.size

撤消历史记录中的项目数。由于已知且未修复的错误 Bug 57043、 Bug 57039和 Bug 57040
，功能默认禁用 ( 0 ) 。将其设置为大于零的数字（25可能是一个很好的默认值）。它越大，消耗的内存就越多。默认为：0

不

gui.quick_X

添加 JMeter 组件的热键，其中X是快捷键，例如：

gui.quick_0=ThreadGroupGui
gui.quick_1=HttpTestSampleGui
gui.quick_2=RegexExtractorGui
gui.quick_3=AssertionGui
gui.quick_4=ConstantTimerGui
gui.quick_5=TestActionGui
gui.quick_6=JSR223PostProcessor
gui.quick_7=JSR223PreProcessor
gui.quick_8=DebugSampler
gui.quick_9=ViewResultsFullVisualizer

当您按Ctrl + 0 … Ctrl + 9 （Mac 上为⌘ + 0 … ⌘ + 9 ）时，上面的代码将添加相应的元素

不

19.6 JMX 备份配置¶

参数

属性

描述

必需的

jmeter.gui.action.save.backup_on_save

保存测试计划时启用.jmx文件的自动备份。
启用后，在保存.jmx之前，会将其备份到jmeter.gui.action.save.backup_directory属性指向的目录（见下文）。备份文件名是在保存 jmx 文件之后构建的。例如，如果最后创建的备份文件是test-plan-000011.jmx ，保存test-plan.jmx将在备份目录中创建一个test -plan-000012.jmx 。默认值为true，表示启用了自动备份。默认为：真

不

jmeter.gui.action.save.backup_directory

设置在 GUI 中保存时将创建 JMX 备份的备份目录路径。
如果未设置（默认设置），则将在 JMeter 基本安装的子目录中创建备份文件。如果设置且目录不存在，则会创建对应的目录。
默认为：${JMETER_HOME}/backups

不

jmeter.gui.action.save.keep_backup_max_hours

设置自保存时间以来备份文件应保留的最长时间（以小时为单位）。
默认情况下没有设置过期时间，这意味着我们会永远保留备份。
默认为：0

不

jmeter.gui.action.save.keep_backup_max_count

设置应保留的最大备份文件数。默认情况下，将保留十个备份。
将此设置为零将导致备份不被删除（除非keep_backup_max_hours 设置为非零值）。
默认为：10

不

save_automatically_before_run

在开始运行测试计划之前启用 .jmx 文件的自动保存
启用后，在运行之前，.jmx 将被保存并备份到指定的目录。
默认为：真

不

19.7 远程主机和RMI配置¶

参数

属性

描述

必需的

远程主机

远程主机 - 逗号分隔，例如

remote_hosts=localhost:1099,localhost:2010

默认为：127.0.0.1

不

服务器端口

服务器要使用的 RMI 端口（必须使用相同的端口启动rmiregistry ）。要将端口更改为（例如）1234：
在服务器上：

设置 server_port=1234
使用端口1234启动rmiregistry

在 Windows 上，这可以通过以下方式完成：

SET SERVER_PORT=1234
JMETER-SERVER

在 Unix 上：

SERVER_PORT=1234 jmeter-server

在 Windows 客户端上：

set remote_hosts=server:1234

在 Unix 客户端上：

export remote_hosts=server:1234

默认为：1099

不

客户端.rmi.localport

控制RemoteSampleListenerImpl和RemoteThreadsListenerImpl（控制器）使用的 RMI 端口的参数
默认值为0，表示端口是随机分配的。如果它不为零，它将用作客户端引擎的本地端口号的基础。目前，JMeter 将打开最多三个端口，从这个属性中定义的端口开始。

您可能需要在 Controller 机器上的防火墙中打开相应的端口。

默认为：0

不

客户端尝试

当分布式测试开始时，可能会有多次尝试初始化远程引擎。
默认情况下，只进行一次尝试。增加此属性以使其重试更多次。
默认为：1

不

client.retries_delay

如果重试初始化，则此属性设置这些尝试之间的延迟（以毫秒为单位）。
默认为：5000

不

client.continue_on_fail

进行所有初始化尝试后，如果任何远程引擎失败，则测试将失败。
将此属性设置为true以忽略失败的节点并继续测试。
默认为：假

不

服务器.rmi.port

更改用于访问服务器的默认端口 ( 1099 )。
默认为：1099

不

server.rmi.localport

要为 JMeter 服务器引擎使用特定端口，请在启动服务器之前定义此属性。
默认为：4000

不

server.rmi.create

从 JMeter 2.3.1 版开始，JMeter 服务器创建 RMI 注册表作为服务器进程的一部分。
将此属性设置为false，以停止服务器创建 RMI 注册表。
默认为：真

不

server.exitaftertest

从 JMeter 版本 2.3.1 开始，定义此属性以使 JMeter 在第一次测试后退出。
默认为：真

不

server.rmi.ssl.keystore.type

RMI 连接安全的密钥库类型。可能的值取决于使用的 JVM，但通常支持的是JKS和PKCS12。默认为：JKS

不

server.rmi.ssl.keystore.file

包含私钥的密钥库文件默认为：rmi_keystore.jks

不

server.rmi.ssl.keystore.password

Keystore 密码默认为：changeit

不

server.rmi.ssl.keystore.alias

密钥别名默认为：rmi

不

server.rmi.ssl.truststore.type

RMI 连接安全的信任库类型默认为：server.rmi.ssl.keystore.type的值，即JKS

不

server.rmi.ssl.truststore.file

包含证书的密钥库文件默认为：server.rmi.ssl.keystore.file的值，即rmi_keystore.jks

不

server.rmi.ssl.truststore.password

信任库密码默认为：server.rmi.ssl.keystore.password的值，即changeit

不

server.rmi.ssl.disable

如果您不想为 RMI 使用 SSL，请将其设置为true默认为： false

不

19.8 包含控制器¶

参数

属性

描述

必需的

包括controller.prefix

IncludeController在构建文件名时使用的前缀。
默认为空值

不

19.9 HTTP Java 配置¶

参数

属性

描述

必需的

http.java.sampler.retries

HTTP Java 采样器在放弃之前执行的连接重试次数。 0表示自 3.0 版起不再重试。
默认为：0

不

19.10 Apache HttpClient 常用属性¶

参数

属性

描述

必需的

http.post_add_content_type_if_missing

JMeter 是否应该在 POST 请求中添加一个 Header Content-type: application/x-www-form-urlencoded如果缺失？
在 4.1 版之前是真的。
默认为：假

不

httpclient.timeout

为 AJP Sampler 设置套接字超时（或使用参数http.socket.timeout ）。
值以毫秒为单位，0表示没有超时。
默认为：0

不

httpclient.version

设置http版本。
默认为：1.1（或使用参数http.protocol.version）

不

httpclient.socket.http.cps

将每秒字符数设置为大于零的值以模拟慢速连接。
默认为：0

不

httpclient.socket.https.cps

与以前相同，但适用于 https。默认为：0

不

httpclient.loopback

启用环回协议。
默认为：真

不

httpclient.localaddress

定义用于多宿主主机的本地主机地址，例如

httpclient.localaddress=1.2.3.4

不

http.proxyUser

设置要与代理一起使用的用户名。

不

http.proxyPass

设置要与代理一起使用的密码。

不

19.11 Kerberos 属性¶

参数

属性

描述

必需的

kerberos_jaas_application

AuthManager Kerberos 配置jaas.conf
中使用的应用程序模块的名称。默认为：JMeter

不

kerberos.spnego.strip_port

在为 SPNEGO 身份验证构建 SPN 之前，应从 url 中删除端口。默认为：真

不

kerberos.spnego.delegate_cred

SPNEGO 身份验证是否应该使用凭证委托。默认为：假

不

19.12 Apache HttpClient 日志记录示例¶

启用标头连线和上下文日志记录 - 最适合调试在 log4j2.xml 中，设置：

<Logger name="org.apache.http" level="debug" />
<Logger name="org.apache.http.wire" level="error" />

启用完整的连线和上下文日志记录在 log4j2.xml 中，设置：

<Logger name="org.apache.http" level="debug" />

为连接管理启用上下文日志记录

<Logger name="org.apache.http.impl.conn" level="debug" />

为连接管理/请求执行启用上下文日志记录

<Logger name="org.apache.http.impl.conn" level="debug" />
<Logger name="org.apache.http.impl.client" level="debug" />
<Logger name="org.apache.http.client" level="debug" />

19.13 Apache HttpComponents HTTPClient 配置（HTTPClient4）¶

参数

属性

描述

必需的

hc.parameters.file

定义用于覆盖 Apache HttpClient 参数的属性文件。
如果您在hc.parameters文件中添加任何内容，请取消注释此行。
默认为：hc.parameters

不

httpclient4.auth.preemptive

使用 BASIC auth 时抢先发送 Authorization Header 默认为：true

不

httpclient4.retrycount

尝试重试的次数。默认情况下，重试将在幂等 Http 方法上完成。如果要重试所有方法，请参阅属性httpclient4.request_sent_retry_enabled
默认为：0

不

httpclient4.request_sent_retry_enabled

如果可以重试已发送的请求，则将此属性设置为true 。这意味着将重试幂等和非幂等请求。这通常应该是错误的，但在针对一些负载均衡器（如 Amazon ELB）进行测试时它可能很有用。
默认为：假

不

httpclient4.idletimeout

如果服务器不发送Keep-Alive超时标头，则应用空闲连接超时（以毫秒为单位）。
默认为：0 （没有建议的Keep-Alived连接持续时间）

不

httpclient4.validate_after_inactivity

如果自上次使用连接以来经过的时间（以毫秒为单位）超过此值，请检查连接。确保此值始终比httpclient4.time_to_live
至少低 150 毫秒默认为：4900

不

httpclient4.time_to_live

TTL（以毫秒为单位）代表一个绝对值。无论如何，连接不会在超过其 TTL 后被重新使用。
默认为：60000

不

httpclient4.deflate_relax_mode

忽略某些前卫的应用程序可能发出的 EOFException 异常，以发出 Deflated 流结束的信号。
默认为：假

不

httpclient4.gzip_relax_mode

忽略某些前卫应用程序可能发出的 EOFException 异常，以表示 GZipped 流的结束。
默认为：假

不

httpclient4.default_user_agent_disabled

如果为 true，则不会添加默认的 HC4 用户代理 (Apache-HttpClient/XYZ (Java/ABC_D))。
默认为：假

不

19.14 HTTP缓存管理器配置¶

参数

属性

描述

必需的

可缓存方法

可以缓存的方法的空格或逗号分隔列表。
默认为：获取

不

cache_manager.cached_resource_mode

注意此属性目前是 Bug 56162的临时解决方案。

从 2.12 版开始，JMeter 不再为缓存中的资源创建响应代码为204的示例结果。这与浏览器所做的一致。
您可以在三种模式之间进行选择：

RETURN_NO_SAMPLE（默认）: 此模式不返回样本结果。它没有额外的配置。
RETURN_200_CACHE: 此模式将返回示例结果，响应代码为200，响应消息为“ （ex cache） ”。
RETURN_CUSTOM_STATUS: 选择此模式，必须通过指定RETURN_CUSTOM_STATUS.code和RETURN_CUSTOM_STATUS.message来设置响应代码和消息。

默认为：RETURN_NO_SAMPLE

不

RETURN_CUSTOM_STATUS.code

如果选择了模式RETURN_CUSTOM_STATUS ，这使您可以选择要返回的响应代码。
默认为空值。

不

RETURN_CUSTOM_STATUS.message

如果选择了RETURN_CUSTOM_STATUS 模式，这使您可以选择要返回的响应消息。
默认为空值

不

19.15 结果文件配置¶

参数

属性

描述

必需的

jmeter.save.saveservice.output_format

本部分有助于确定如何保存结果数据。
注释掉的值是默认值。
合法值：xml、csv、db。
目前仅支持xml和csv。
默认为：csv

不

jmeter.save.saveservice.assertion_results_failure_message

应该保存字段时为真；否则为假。
assertion_results_failure_message仅影响 CSV 输出。
默认为：真

不

jmeter.save.saveservice.assertion_results

合法值： n one，first，all。
默认为：无

不

jmeter.save.saveservice.data_type

默认为：真

不

jmeter.save.saveservice.label

默认为：真

不

jmeter.save.saveservice.response_code

默认为：真

不

jmeter.save.saveservice.response_data

CSV 输出当前不支持response_data

默认为：假

不

jmeter.save.saveservice.response_data.on_error

为失败的样本保存 ResponseData。默认为：假

不

jmeter.save.saveservice.response_message

默认为：真

不

jmeter.save.saveservice.successful

默认为：真

不

jmeter.save.saveservice.thread_name

默认为：真

不

jmeter.save.saveservice.time

默认为：真

不

jmeter.save.saveservice.subresults

默认为：真

不

jmeter.save.saveservice.assertions

默认为：真

不

jmeter.save.saveservice.latency

默认为：真

不

jmeter.save.saveservice.connect_time

默认为：假

不

jmeter.save.saveservice.samplerData

默认为：假

不

jmeter.save.saveservice.responseHeaders

默认为：假

不

jmeter.save.saveservice.requestHeaders

默认为：假

不

jmeter.save.saveservice.encoding

默认为：假

不

jmeter.save.saveservice.bytes

默认为：真

不

jmeter.save.saveservice.url

默认为：假

不

jmeter.save.saveservice.filename

默认为：假

不

jmeter.save.saveservice.hostname

默认为：假

不

jmeter.save.saveservice.thread_counts

默认为：真

不

jmeter.save.saveservice.sample_count

默认为：假

不

jmeter.save.saveservice.idle_time

默认为：真

不

jmeter.save.saveservice.timestamp_format

时间戳格式 - 这只影响 CSV 输出文件。
合法值： n one、ms或适合SimpleDateFormat的格式。
默认为：毫秒

不

jmeter.save.saveservice.timestamp_format

默认为：yyyy/MM/dd HH:mm:ss.SSS

不

jmeter.save.saveservice.default_delimiter

用于逗号分隔值 (CSV) 文件或字段值由指定分隔符分隔的其他格式。
默认为：,

对于 TAB，可以使用\t

不

jmeter.save.saveservice.print_field_names

仅适用于 CSV 格式文件：将
字段名称打印为 CSV 中的第一行
默认为：true

不

样本变量

JMeter 变量名称的可选列表，其值将保存在结果数据文件中。
使用逗号分隔名称。
默认为：SESSION_ID,REFERENCE

不

jmeter.save.saveservice.xml_pi

注意当前实现将 XML 中的值保存为属性，因此名称必须是有效的 XML 名称。

2.3.2 之后的 JMeter 版本将变量发送到所有服务器，以确保客户端提供正确的数据。
文件第二行的可选 XML 处理指令。
默认为空值

不

jmeter.save.saveservice.base_prefix

用于标识相对于当前基础的文件名的前缀。
默认为：~/

不

jmeter.save.saveservice.autoflush

以 XML 或 CSV 输出编写的每一行的 AutoFlush。
将此设置为true将导致在发生崩溃时减少测试结果数据丢失，但会影响性能，特别是对于密集测试（低暂停或无暂停）。
从 JMeter 2.10 版开始，默认情况下为false。
默认为：假

不

19.16 影响 SampleResults 的设置¶

参数

属性

描述

必需的

sampleresult.timestamp.start

保存开始时间戳而不是结束。
这也会影响存储在结果文件中的时间戳。
默认为：假

不

sampleresult.useNanoTime

是否使用System.nanoTime() - 否则仅使用System.currentTimeMillis()。
默认为：真

不

sampleresult.nanoThreadSleep

使用后台线程计算 nanoTime 偏移量。
将此设置为小于零的值以禁用后台线程。
默认为：5000

不

subresults.disable_renaming

从 5.0 版开始，JMeter 有一个新的子结果命名策略，默认情况下对子结果进行编号。
如果设置为true ，则此属性将丢弃重命名策略。如果您使用 JMeter 进行功能测试，这可能是必需的。
默认为：假

不

19.17 升级¶

参数

属性

描述

必需的

升级属性

保存向后兼容性问题的名称更改记录的文件。
默认为：/bin/upgrade.properties

不

19.18 JMeter 测试脚本记录器配置¶

参数

属性

描述

必需的

代理.暂停

注意该元素最初称为代理记录器，这就是属性具有前缀“代理”的原因。

如果记录器检测到 HTTP 请求之间的间隔至少为 5 秒（默认），则假定用户单击了新 URL。以毫秒为单位指定。
默认为：5000

不

proxy.number.requests

为采样器名称添加数字后缀。
默认为：真

不

proxy.sampler_format

当使用格式字符串作为命名方案时，默认格式字符串用于新采样器。
默认为：#{counter,number,000} - #{path} (#{name})

不

proxy.excludes.suggested

将添加到要排除的 URL 模式的 URL 模式列表。用;
分隔多行默认为：.*\\.(bmp|css|js|gif|ico|jpe?g|png|swf|woff|woff2)

不

jmeter.httpsampler

更改默认的 HTTP 采样器。
可以是其中之一

HTTPSampler或Java: 使用Java采样器
HTTPSampler2
HttpClient4: 使用 Apache HTTPClient 版本 4

默认为：HttpClient4

不

jmeter.httpclient.strict_rfc2616

默认情况下，JMeter 尝试对RFC 2616 重定向更宽松，并允许相对路径。
如果要测试严格的一致性，请将此值设置为true。
当该属性为true时，JMeter 遵循 RFC 3986 第 5.2 节。
默认为：假

不

proxy.content_type_include

默认内容类型包括要使用的过滤器。指定为正则表达式。
默认为：text/html|text/plain|text/xml

不

proxy.content_type_exclude

要使用的默认内容类型排除过滤器。指定为正则表达式。
默认为：image/.*|text/css|application/.*

不

proxy.headers.remove

要从 Header Manager 元素中删除的默认标题。指定为逗号分隔列表

标头Cookie和Authorization始终被删除。

默认为：If-Modified-Since,If-None-Match,Host

不

proxy.binary.types

二进制内容类型处理。
这些内容类型将通过将请求保存在文件中来处理。
默认为：application/x-amf,application/x-java-serialized-object,binary/octet-stream

不

proxy.binary.directory

文件将保存在此目录中。
默认为：user.dir

不

proxy.binary.filesuffix

将创建带有此值后缀的文件。
默认为：.binary

不

proxy.redirect.disabling

是否尝试禁用由重定向产生的样本，其中生成的样本使用自动重定向。
默认为：真

不

proxy.ssl.protocol

SSL 配置。
默认为：TLS

不

19.19 测试脚本记录器证书配置¶

参数

属性

描述

必需的

代理证书目录

默认为：JMeter bin目录

不

代理证书文件

默认为：proxyserver.jks

不

代理证书类型

默认为：JKS

不

proxy.cert.keystorepass

默认为：密码

不

proxy.cert.keypassword

默认为：密码

不

代理证书工厂

默认为：SunX509

不

代理证书别名

如果您希望使用密钥库中的特殊条目，请定义此属性。
默认为空值

不

proxy.cert.validity

JMeter 创建的证书的默认有效期（以天为单位）。
默认为：7

不

proxy.cert.dynamic_keys

使用动态密钥生成（如果 JMeter/JVM 支持）。
如果为false，将恢复为使用没有证书的单个密钥。
默认为：真

不

19.20 JMeter 代理配置¶

参数

属性

描述

必需的

http.proxyDomain

对用户名和密码使用命令行标志。
默认为：NTLM 域，如果 HTTPClient 采样器需要

不

19.21 HTML解析器配置¶

参数

属性

描述

必需的

HTTPResponse.parsers

以空格分隔的解析器组列表。

对于每个解析器，应该有一个解析器.types和一个解析器.className属性

默认为：htmlParser wmlParser cssParser

不

cssParser.className

基于 ph-css 的 CSS 解析器。
默认为：org.apache.jmeter.protocol.http.parser.CssParser

不

cssParser.types

由 cssParser 处理的内容类型。
默认为：文本/css

不

css.parser.cache.size

CSS 解析器 LRU 缓存大小。此缓存存储在 CSS 中找到的 URL，以避免不断地解析 CSS。默认情况下，缓存大小为 400。可以通过将其值设置为 0 来禁用它。
默认为：400

不

css.parser.ignore_all_css_errors

让 CSS Parser 忽略所有 CSS 错误。
默认为：真

不

htmlParser.className

定义要使用的 HTML 解析器。
不要评论这个属性。

org.apache.jmeter.protocol.http.parser.LagartoBasedHtmlParser: 这个新的解析器（从 2.10 开始）应该比所有其他解析器表现得更好。请参阅错误 55632。
org.apache.jmeter.protocol.http.parser.JTidyHTMLParser: JMeter 2.10 版之前的默认解析器
org.apache.jmeter.protocol.http.parser.RegexpHTMLParser: 请注意，Regexp 提取器可能会检测到已被注释掉的引用。

在许多情况下，它可以正常工作，但您应该知道它可能会生成额外的引用。
org.apache.jmeter.protocol.http.parser.JsoupBasedHtmlParser: 此解析器基于 JSoup。它应该是最准确的解析器，但它的性能不如 LagartoBasedHtmlParser

默认为：org.apache.jmeter.protocol.http.parser.LagartoBasedHtmlParser

是的

htmlParser.types

HTTPSamplerBase 使用它来将 htmlParser 与下面的内容类型相关联。
默认为：text/html application/xhtml+xml application/xml text/xml

不

wmlParser.className

默认为：org.apache.jmeter.protocol.http.parser.RegexpHTMLParser

不

wmlParser.types

由 HTTPSamplerBase 用于将 wmlParser 与以下内容类型相关联。
默认为：text/vnd.wap.wml

不

19.22 远程批处理配置¶

配置使用分布式测试时 SampleResults 如何从服务器发送到客户端。

请注意，该模式当前在客户端上解析，而其他属性（例如time_threshold）在服务器上解析。

从 JMeter 2.9 版开始，默认为StrippedBatch，它以批处理模式返回样本（默认每 100 个样本或每分钟）。
您可以通过配置来设置模式：

mode=one of the possible modes below

StrippedBatch 从 SampleResult 中剥离响应数据，因此如果您需要响应数据，请更改为另一种模式。

可能的模式有：

标准: 一个一个发送 SampleResult
批: 在发送之前累积 SampleResults。由属性num_sample_threshold和time_threshold配置
统计: 返回样本汇总统计信息。由属性key_on_threadname和time_threshold配置
剥离: 与标准模式类似，但从 SampleResult 中去除 Response。由属性sample_sender_strip_also_on_error配置
剥离批次: 与Batch相同，但从 SampleResult 中去除 Response。由属性num_sample_threshold、time_threshold 和sample_sender_strip_also_on_error配置
异步: 异步发送者；使用队列和后台工作进程返回样本。由属性asynch.batch.queue.size配置
剥离异步: 与Asynch相同，但从 SampleResult 中删除响应数据。由属性asynch.batch.queue.size 和sample_sender_strip_also_on_error配置
剥离磁盘存储: 与DiskStore相同，但从 SampleResult 中删除响应数据
扩展AbstractSampleSender的类（例如org.example.load.MySampleSender ）: 您选择的自定义实现

参数

属性

描述

必需的

sample_sender_client_configured

如何配置示例发送方实现：

真的: （默认）表示将使用客户端配置
错误的: 表示将使用服务器配置

默认为：真

不

sample_sender_strip_also_on_error

默认情况下，当使用剥离模式时，JMeter 因为版本 3.1 会剥离响应，即使是错误的 SampleResults。如果您想恢复到以前的行为（不删除错误的响应）将此属性设置为false
默认为：true

不

模式

远程批处理支持。
从 JMeter 2.9 版开始，默认为StrippedBatch，它以批处理模式返回样本（默认每 100 个样本或每分钟）。

另请注意，StrippedBatch 从 SampleResult 中删除响应数据，因此如果您需要响应数据，请更改为另一种模式。

不

key_on_threadname

设置为true以在threadName而不是threadGroup上的关键统计样本。
默认为：假

不

num_sample_threshold

在发送到客户端之前要累积的 SampleResult 数。
默认为：100

不

时间阈值

在将 SampleResults 发送给客户端之前保留它们的时间。值以毫秒为单位。
默认为：60000

不

asynch.batch.queue.size

异步模式使用的默认队列大小。
默认为：100

不

19.23 JDBC请求配置¶

参数

属性

描述

必需的

jdbcsampler.nullmarker

用于指示空值的字符串。
默认为：]NULL[

不

jdbcsampler.max_retain_result_size

从采样器中的CLOB或BLOB 存储的最大字节数。
默认为：65536（字节）

不

jdbc.config.check.query

用于确定数据库是否仍在响应的查询列表。
默认为：

select 1 from INFORMATION_SCHEMA.SYSTEM_USERS|select 1 from dual|select 1 from sysibm.sysdummy1|select 1|select 1 from rdb$database

不

jdbc.config.jdbc.driver.class

JDBC 驱动程序类名列表
默认为：

com.mysql.jdbc.Driver|org.postgresql.Driver|oracle.jdbc.OracleDriver|com.ingres.jdbc.IngresDriver|com.microsoft.sqlserver.jdbc.SQLServerDriver|com.microsoft.jdbc.sqlserver.SQLServerDriver|org.apache.derby.jdbc.ClientDriver|org.hsqldb.jdbc.JDBCDriver|com.ibm.db2.jcc.DB2Driver|org.apache.derby.jdbc.ClientDriver|org.h2.Driver|org.firebirdsql.jdbc.FBDriver|org.mariadb.jdbc.Driver|org.sqlite.JDBC|net.sourceforge.jtds.jdbc.Driver|com.exasol.jdbc.EXADriver

不

19.24 操作系统进程采样器配置¶

19.25 TCP 采样器配置¶

参数

属性

描述

必需的

tcp.handler

默认处理程序类。
默认为：TCPClientImpl

不

tcp.eolByte

将此值设置为-128到+127范围之外的值以跳过 eol检查。
默认为行尾的字节值：1000

不

tcp.charset

TCP 字符集，由org.apache.jmeter.protocol.tcp.sampler.TCPClientImpl使用。默认为Charset.defaultCharset().name()
返回的平台默认字符集

不

tcp.status.prefix

状态响应代码开头的字符串。
默认为：状态

不

tcp.status.suffix

状态响应代码末尾的字符串。
默认为：。

不

tcp.status.properties

将代码转换为消息的属性文件。
默认为：mytestfiles/tcpstatus.properties

不

tcp.binarylength.prefix.length

LengthPrefixedBinaryTCPClientImpl实现使用的长度前缀（以字节为单位）。
默认为：2

不

19.26 Summariser - Generate Summary Results - 配置（主要适用于CLI模式）¶

参数

属性

描述

必需的

总结者名称

注释以下属性以禁用默认 CLI 模式摘要程序。
[或更改值以重命名]

仅适用于 CLI 模式

默认为：摘要

不

summariser.interval

摘要之间的间隔（以秒为单位）。
默认为：30

不

总结器.log

将消息写入日志文件。
默认为：真

不

总结器输出

将消息写入System.out。
默认为：真

不

summariser.ignore_transaction_controller_sample_result

忽略 TransactionControllers 生成的 SampleResults。
默认为：真

不

19.27 聚合报告和聚合图 - 配置¶

参数

属性

描述

必需的

聚合_rpt_pct1

要在报告中显示的百分位数。以0到100
之间的浮点值形式给出（表示百分比）。要显示的第一个百分位数。默认为：90

不

聚合rpt_pct2

要显示的第二个百分位数。以0到100
之间的浮点值形式给出（表示百分比）。默认为：95

不

聚合rpt_pct3

要显示的第二个百分位数。以0到100
之间的浮点值形式给出（表示百分比）。默认为：99

不

19.28 BackendListener - 配置¶

参数

属性

描述

必需的

backend_graphite.send_interval

发送间隔以秒为单位。
默认为：1秒

不

backend_influxdb.send_interval

发送间隔以秒为单位。
默认为：5秒

不

backend_influxdb.connection_timeout

InfluxDB 连接超时。
默认为：1000毫秒

不

backend_influxdb.socket_timeout

InfluxDB 套接字读取超时。
默认为：3000毫秒

不

backend_influxdb.connection_request_timeout

InfluxDB 超时获取连接。
默认为：100毫秒

不

backend_metrics_window

Percentiles、Min 和Max 的后端指标滑动窗口大小。
默认为：100

不

backend_metrics_large_window

Percentiles、Min 和Max 的后端指标滑动窗口大小。当backend_metrics_window_mode=timed
将此值设置得太高会导致 OOM 后端指标滑动窗口大小默认为：5000

不

backend_metrics_window_mode

后端指标窗口模式。可能的值：

固定：固定大小的窗口
定时：时间盒装

默认为：固定

不

19.29 BeanShell 配置¶

参数

属性

描述

必需的

beanshell.server.port

BeanShell 服务器属性。
将端口号定义为非零以在该端口上启动 http 服务器。
telnet 服务器将在下一个端口上启动。
默认为：0（即不启动服务器）

没有安全保障。任何可以连接到端口的人都可以发出任何 BeanShell 命令。这些可以提供对 JMeter 应用程序和主机的不受限制的访问。 除非端口受到保护，例如防火墙，否则不要启用服务器。

不

beanshell.server.file

定义服务器初始化文件。
默认为： ../extras/ startup.bsh

不

beanshell.init.file

定义要在启动时处理的文件。
这是使用它自己的解释器处理的。
默认为空值。

不

beanshell.sampler.init

为 BeanShell Sampler、Function 和其他 BeanShell 元素定义初始化文件。

NB Beanshell 测试元素不共享解释器。每个线程中的每个元素都有自己的解释器。这在样本之间保留。

默认为空值。

不

beanshell.function.init

默认为空值。

不

beanshell.assertion.init

默认为空值。

不

beanshell.listener.init

默认为空值。

不

beanshell.postprocessor.init

默认为空值。

不

beanshell.preprocessor.init

默认为空值。

不

beanshell.timer.init

默认为空值。

不

文件BeanShellListeners.bshrc包含测试和线程侦听器的示例定义。

19.30 MailerModel 配置¶

参数

属性

描述

必需的

mailer.successlimit

发送消息前的成功样本数。
默认为：2

不

mailer.failurelimit

发送消息之前失败的样本数。
默认为：2

不

19.31 CSVRead 配置¶

参数

属性

描述

必需的

csvread.delimiter

CSVRead 分隔符设置（默认“ , ”）。

确保分隔符字符后没有尾随空格或制表符，否则这些将包含在有效分隔符列表中。

默认为：,

不

19.32 __time() 函数配置¶

参数

属性

描述

必需的

时间.YMD

此属性和以下属性可用于重新定义默认时间格式。
默认为：yyyyMMdd

不

时间.HMS

默认为：HHmmss

不

时间.YMDHMS

默认为：yyyyMMdd-HHmmss

不

时间.USER1

默认为空值

不

时间.USER2

默认为空值

不

19.33 CSV 数据集配置¶

参数

属性

描述

必需的

csvdataset.eofstring

在EOF 返回的字符串（如果未使用回收）。
默认为：<EOF>

不

csvdataset.file.encoding_list

文件编码值列表
默认为：平台默认值

不

19.34 LDAP 采样器配置¶

参数

属性

描述

必需的

ldapsampler.max_sorted_results

搜索返回的搜索结果的最大数量将被排序以保证稳定的排序（如果更多的结果则返回此限制，则不进行排序）。
设置为零以关闭所有排序，在这种情况下，“等于”响应断言很可能对搜索结果失败。
默认为：1000

不

assertion.equals_section_diff_len

当 Equals 断言失败时，为三个部分（开始匹配部分、差异部分、结束匹配部分，其中并非所有部分都将出现在所有差异中）中的每一个部分记录的字符数。所以值100意味着最多300 个字符的差异文本将被显示（加上一些额外的字符，如“ ... ”和“ [[[ “/” ]]] “用于装饰它）。
默认为：100

不

assertion.equals_diff_delta_start

测试写入日志以表示差异增量的开始/结束。
默认为：[[[

不

assertion.equals_diff_delta_end

默认为：]]]

不

19.35 其他配置¶

参数

属性

描述

必需的

cssselector.parser.cache.size

CSS 选择器提取器（仅用于 JODD 实现）用于存储解析的 CSS 选择器表达式的缓存大小。
默认为：400

不

resultcollector.action_if_file_exists

用于控制开始测试时发生的情况，并拥有可以覆盖现有结果文件的侦听器。
可能的值：

询问：询问用户
APPEND：将结果附加到现有文件
DELETE：删除现有文件并开始一个新文件

不

镜像服务器端口

如果已定义且大于零，则在端口上启动镜像服务器。
默认为：0

不

oro.patterncache.size

ORO PatternCacheLRU 大小。
默认为：1000

不

属性编辑器搜索路径

TestBeanGui
默认为：空

不

jmeter.expertMode

打开/关闭专家模式：专家模式将显示专家模式 bean 和属性。
默认为：真

不

httpsampler.max_bytes_to_store_per_request

每个SampleResult 存储在内存中的最大字节大小。确保您不超过 Java Array 的最大容量，并记住您设置的值越高，JMeter 将消耗的内存越多。
默认为：0字节，这意味着不会发生截断

不

httpsampler.max_buffer_size

读取响应时使用的最大缓冲区大小（以字节为单位）。
默认为：66560字节

不

httpsampler.max_redirects

在单个序列中遵循的最大重定向。
默认为：20

不

httpsampler.max_frame_depth

最大框架/iframe 嵌套深度。
默认为：5

不

httpsampler.separate.container

通过设置以下false 恢复到 Bug 51939行为（嵌入式资源没有单独的容器）。默认为：真

不

httpsampler.ignore_failed_embedded_resources

如果由于缺少资源或其他原因导致嵌入式资源下载失败，如果该属性为true，则不会将父样本标记为失败。
默认为：假

不

httpsampler.parallel_download_thread_keepalive_inseconds

并行下载线程的保持活动时间（以秒为单位）。
默认为：60

不

httpsampler.embedded_resources_use_md5

不要保留嵌入式资源响应数据；只保留大小和 MD5 总和。
默认为：假

不

httpsampler.user_defined_methods

选择框中应该可用的额外 HTTP 方法列表。
默认为：

VERSION-CONTROL,REPORT,CHECKOUT,CHECKIN,UNCHECKOUT,MKWORKSPACE,UPDATE,LABEL,MERGE,BASELINE-CONTROL,MKACTIVITY

不

sampleresult.default.encoding

如果没有提供，则使用的编码。
默认为：ISO-8859-1

不

CookieManager.delete_null_cookies

CookieManager 行为 - 是否应删除具有 null/空值的 cookie？
使用false恢复到原始行为。
默认为：真

不

CookieManager.allow_variable_cookies

CookieManager 行为 - 应该允许可变 cookie 吗？
使用false恢复到原始行为。
默认为：真

不

CookieManager.save.cookies

CookieManager 行为 - Cookie 是否应存储为变量？
默认为：假

不

CookieManager.name.prefix

CookieManager 行为 - 在将其存储为变量之前添加到 cookie 名称的前缀。
默认是 COOKIE_；要删除前缀，请将其定义为一个或多个空格。
默认为：COOKIE_

不

CookieManager.check.cookies

CookieManager 行为 - 在存储它们之前检查接收到的 cookie 是否有效？
使用false恢复到以前的行为。
默认为：真

不

饼干

网景 HTTP Cookie 文件。
默认为：cookies

不

javascript.use_rhino

能够切换到 Rhino 作为IfController 和__javaScript函数使用的默认 Javascript 引擎。

JMeter 从 3.2 版本开始使用 Nashorn。如果您想使用 Rhino，请将此值设置为true

默认为：假

不

jmeterengine.threadstop.wait

等待线程停止的毫秒数。
默认为：5000

不

jmeterengine.remote.system.exit

停止 RMI 后是否在服务器退出代码中调用System.exit(0) 。
默认为：假

不

jmeterengine.stopfail.system.exit

是否在 CLI 模式下停止线程失败时调用System.exit(1)。
这仅在明确要求停止测试时生效。
如果禁用此功能，则可能需要从外部终止 JVM。
默认为：真

不

jmeterengine.force.system.exit

是否在 CLI 模式下在测试结束时强制调用System.exit(0)，即使没有失败并且没有明确要求停止测试。
如果没有这个，如果测试产生的其他线程永远不会退出，JVM 可能永远不会退出。
默认为：假

不

jmeter.exit.check.pause

在报告 JVM 退出失败之前，在守护线程中暂停多长时间（以毫秒为单位）。
如果该值小于零，则 JMeter 不会启动守护线程
默认为：2000

不

jmeterengine.nongui.port

如果运行 CLI 模式，则 JMeter 在以下端口上侦听关闭消息。
要禁用，请将端口设置为1000或更少。
默认为：4445

不

jmeterengine.nongui.maxport

如果初始端口繁忙，请继续尝试直到到达此端口（要禁用搜索，请将值设置为小于或等于.port属性）。
默认为：4455

不

jmeterthread.rampup.granularity

在加速期间检查关闭的频率（毫秒）。
默认为：1000

不

onload.expandtree

加载测试计划时，JMeter 是否应该展开树？自 JMeter 2.7 起
默认值为false
默认为：false

不

jsyntaxtextarea.wrapstyleword

JSyntaxTextArea 配置。
默认为：真

不

jsyntaxtextarea.linewrap

默认为：真

不

jsyntaxtextarea.codefolding

默认为：真

不

jsyntaxtextarea.maxundos

设置为零以禁用 JSyntaxTextArea 中的撤消功能。
默认为：50

不

jsyntaxtextarea.font.family

更改（JSyntax）文本区域的字体。（适用于 HiDPI 屏幕）。
默认为空值，表示平台默认等宽字体

不

jsyntaxtextarea.font.size

更改（JSyntax）文本区域的大小。仅在设置jsyntaxtextarea.font.family时使用。
默认为：-1

不

loggerpanel.usejsyntaxtext

将此设置为false以禁用对控制台记录器面板使用 JSyntaxTextArea。
默认为：真

不

view.results.tree.max_results

应存储和显示的主要样本的最大数量。
值0将存储所有结果。这可能会消耗大量内存。
默认为：500

不

view.results.tree.max_size

可以显示的 HTML 页面的最大大小（以字节为单位）。
设置为零以禁用大小检查并显示整个响应。
默认为：10485760

不

view.results.tree.renderers_order

查看结果树中的渲染器顺序。

注意完整的类名应该用于非 JMeter 核心渲染器

对于 JMeter 核心渲染器，类名以. 并自动以org.apache.jmeter.visualizers
为前缀默认为：

.RenderAsText,.RenderAsRegexp,.RenderAsCssJQuery,.RenderAsXPath,.RenderAsHTML,.RenderAsHTMLWithEmbedded,.RenderAsDocument,.RenderAsJSON,.RenderAsXML

不

文档.max_size

Tika 引擎可以解析的文档的最大大小（以字节为单位）
设置为零以禁用大小检查。
默认为：10485760

不

JMSSampler.useSecurity.properties

JMS 选项。
启用以下属性以阻止 JMS 点对点采样器在创建队列连接时使用属性java.naming.security.[principal|credentials] 。
默认为：假

不

确认.删除.跳过

将以下值设置为true以跳过删除确认对话框。
默认为：假

不

19.36 类路径配置¶

参数

属性

描述

必需的

搜索路径

用于搜索其他 JMeter 插件类的目录列表（由;分隔），例如新的 GUI 元素和采样器。
此类目录中的任何 jar 文件都会自动包含在内；子目录中的 jar 文件将被忽略。
给定的值是在lib/ext目录中找到的任何 jar 的补充。
不要将此用于实用程序或插件依赖项 jar。
默认为空值。

不

用户类路径

JMeter 将搜索实用程序和插件依赖类的目录列表。
使用您的平台路径分隔符（ Java 中的java.io.File.pathSeparatorChar）来分隔多个路径。
此类目录中的任何 jar 文件都会自动包含在内；子目录中的 jar 文件将被忽略。
给定的值是在lib目录中找到的任何 jar 之外的值。
所有条目都将添加到系统类加载器的类路径以及 JMeter 内部加载器的路径中。
带有空格的路径可能会导致 JVM 出现问题。
默认为空值。

不

plugin_dependency_paths

JMeter 将搜索实用程序和插件依赖类的目录列表（由;分隔）。
此类目录中的任何 jar 文件都会自动包含在内；子目录中的 jar 文件将被忽略。
给定的值是在lib目录中找到或由user.classpath属性给出的任何 jar 的补充。
所有条目将仅添加到 JMeter 内部加载器的路径中。
对于插件依赖项，应使用此属性而不是user.classpath。
默认为空值。

不

classfinder.functions.contain

类路径查找器当前需要加载每个 JMeter 类以找到它需要的类。
对于 CLI 模式，只需要扫描 Function 类，但仍会加载所有类。
所有当前的 Function 类在其名称中都包含“.function . ” ，并且没有一个在名称中包含“ .gui. ”，因此可以通过检查这些来减少加载的不需要的类的数量。但是，如果一个有效的函数类名不符合这些限制，它就不会被加载。如果遇到问题，请评论或更改此或以下属性。
默认为：.functions。

不

classfinder.functions.notContain

默认为：.gui。

不

19.37 上报配置¶

参数

属性

描述

必需的

jmeter.reportgenerator.apdex_satisfied_threshold

设置 APDEX 计算的满意度阈值（以毫秒为单位）。
默认为：500

不

jmeter.reportgenerator.apdex_tolerated_threshold

设置 APDEX 计算的容差阈值（以毫秒为单位）。
默认为：1500

不

jmeter.reportgenerator.sample_filter

正则表达式，指示要为图形和统计信息生成保留哪些样本。
空值表示不过滤
默认为空值。

不

jmeter.reportgenerator.temp_dir

如果需要文件 I/O 操作，则设置生成过程使用的临时目录。
默认为：温度

不

jmeter.reportgenerator.statistic_window

设置百分比评估使用的滑动窗口的大小。

注意：值越高，精度越高，但需要更多内存。

默认为：20000

不

jmeter.reportgenerator.report_title

配置此属性以将报告标题
默认更改为：Apache JMeter Dashboard

不

jmeter.reportgenerator.overall_granularity

定义随时间变化图的整体粒度
默认为：60000

不

jmeter.reportgenerator.graph.responseTimePercentiles.classname

响应时间百分比图定义
默认为：

org.apache.jmeter.report.processor.graph.impl.ResponseTimePercentilesGraphConsumer

不

jmeter.reportgenerator.graph.responseTimePercentiles.title

默认为：响应时间百分比

不

jmeter.reportgenerator.graph.responseTimeDistribution.classname

响应时间分布图定义
默认为：

org.apache.jmeter.report.processor.graph.impl.ResponseTimeDistributionGraphConsumer

不

jmeter.reportgenerator.graph.responseTimeDistribution.title

默认为：响应时间分布

不

jmeter.reportgenerator.graph.responseTimeDistribution.property.set_granularity

默认为：100

不

jmeter.reportgenerator.graph.activeThreadsOverTime.classname

随时间变化的活动线程图定义
默认为：

org.apache.jmeter.report.processor.graph.impl.ActiveThreadsGraphConsumer

不

jmeter.reportgenerator.graph.activeThreadsOverTime.title

默认为：随时间推移的活动线程

不

jmeter.reportgenerator.graph.activeThreadsOverTime.property.set_granularity

默认为：${jmeter.reportgenerator.overall_granularity}

不

jmeter.reportgenerator.graph.timeVsThreads.classname

Time VS Threads 图定义
默认为：

org.apache.jmeter.report.processor.graph.impl.TimeVSThreadGraphConsumer

不

jmeter.reportgenerator.graph.timeVsThreads.title

默认为：时间 VS 线程

不

jmeter.reportgenerator.graph.bytesThroughputOverTime.classname

Bytes Throughput Over Time 图定义
默认为：

org.apache.jmeter.report.processor.graph.impl.BytesThroughputGraphConsumer

不

jmeter.reportgenerator.graph.bytesThroughputOverTime.title

默认为：随时间推移的字节吞吐量

不

jmeter.reportgenerator.graph.bytesThroughputOverTime.property.set_granularity

默认为：${jmeter.reportgenerator.overall_granularity}

不

jmeter.reportgenerator.graph.responseTimesOverTime.classname

随时间变化的响应时间图定义
默认为：

org.apache.jmeter.report.processor.graph.impl.ResponseTimeOverTimeGraphConsumer

不

jmeter.reportgenerator.graph.responseTimesOverTime.title

默认为：随时间变化的响应时间

不

jmeter.reportgenerator.graph.responseTimesOverTime.property.set_granularity

默认为：${jmeter.reportgenerator.overall_granularity}

不

jmeter.reportgenerator.graph.latenciesOverTime.classname

随时间变化的延迟图定义
默认为：

org.apache.jmeter.report.processor.graph.impl.LatencyOverTimeGraphConsumer

不

jmeter.reportgenerator.graph.latenciesOverTime.title

默认为：随时间变化的延迟

不

jmeter.reportgenerator.graph.latenciesOverTime.property.set_granularity

默认为：${jmeter.reportgenerator.overall_granularity}

不

jmeter.reportgenerator.graph.responseTimeVsRequest.classname

响应时间与请求图定义
默认为：

org.apache.jmeter.report.processor.graph.impl.ResponseTimeVSRequestGraphConsumer

不

jmeter.reportgenerator.graph.responseTimeVsRequest.title

默认为：响应时间与请求

不

jmeter.reportgenerator.graph.responseTimeVsRequest.exclude_controllers

默认为：真

不

jmeter.reportgenerator.graph.responseTimeVsRequest.property.set_granularity

默认为：${jmeter.reportgenerator.overall_granularity}

不

jmeter.reportgenerator.graph.latencyVsRequest.classname

延迟与请求图定义
默认为：

org.apache.jmeter.report.processor.graph.impl.LatencyVSRequestGraphConsumer

不

jmeter.reportgenerator.graph.latencyVsRequest.title

默认为：延迟与请求

不

jmeter.reportgenerator.graph.latencyVsRequest.exclude_controllers

默认为：真

不

jmeter.reportgenerator.graph.latencyVsRequest.property.set_granularity

默认为：${jmeter.reportgenerator.overall_granularity}

不

jmeter.reportgenerator.graph.hitsPerSecond.classname

每秒点击次数图表定义
默认为：

org.apache.jmeter.report.processor.graph.impl.HitsPerSecondGraphConsumer

不

jmeter.reportgenerator.graph.hitsPerSecond.title

默认为：每秒点击次数

不

jmeter.reportgenerator.graph.hitsPerSecond.exclude_controllers

默认为：真

不

jmeter.reportgenerator.graph.hitsPerSecond.property.set_granularity

默认为：${jmeter.reportgenerator.overall_granularity}

不

jmeter.reportgenerator.graph.codesPerSecond.classname

Codes Per Second 图形定义
默认为：

org.apache.jmeter.report.processor.graph.impl.CodesPerSecondGraphConsumer

不

jmeter.reportgenerator.graph.codesPerSecond.title

默认为：每秒代码数

不

jmeter.reportgenerator.graph.codesPerSecond.exclude_controllers

默认为：真

不

jmeter.reportgenerator.graph.codesPerSecond.property.set_granularity

默认为：${jmeter.reportgenerator.overall_granularity}

不

jmeter.reportgenerator.graph.transactionsPerSecond.classname

每秒事务数图表定义
默认为：

org.apache.jmeter.report.processor.graph.impl.TransactionsPerSecondGraphConsumer

不

jmeter.reportgenerator.graph.transactionsPerSecond.title

默认为：每秒事务数

不

jmeter.reportgenerator.graph.transactionsPerSecond.property.set_granularity

默认为：${jmeter.reportgenerator.overall_granularity}

不

jmeter.reportgenerator.exporter.html.classname

HTML 导出
默认为：

org.apache.jmeter.report.dashboard.HtmlTemplateExporter

不

jmeter.reportgenerator.exporter.html.property.template_dir

设置生成 html 页面的模板文件的源目录。
默认为：报告模板

不

jmeter.reportgenerator.exporter.html.property.output_dir

设置生成的 html 页面的目标目录。
这将被命令行选项-o覆盖。
默认为：报告输出

不

jmeter.reportgenerator.exporter.html.series_filter

正则表达式，指示在显示中过滤了哪些图形系列。
空值意味着没有过滤。
默认为空值。

不

jmeter.reportgenerator.exporter.html.filters_only_sample_series

指示系列过滤器是否仅适用于样本系列
默认为：true

不

jmeter.reportgenerator.exporter.html.show_controllers_only

指示是否仅控制器示例显示在支持它的图形上。
默认为：假

不

jmeter.reportgenerator.date_format

使用 start_date 和 end_date 属性的报告的日期格式。
默认为：yyyyMMddHHmmss

不

jmeter.reportgenerator.start_date

使用 date_format 属性的报告开始日期。
默认为：无

不

jmeter.reportgenerator.end_date

使用 date_format 属性的报告结束日期。
默认为：无

不

generate_report_ui.generation_timeout

使用工具 > 生成 HTML 报告时生成报告的超时时间（以毫秒为单位）。
默认为：300000

不

19.38 要加载的附加属性文件¶

参数

属性

描述

必需的

用户属性

JMeter 是否应该自动加载额外的 JMeter 属性？
要查找的文件名（注释以禁用）
默认为：user.properties

不

系统属性

JMeter 是否应该自动加载额外的系统属性？
要查找的文件名（注释以禁用）
默认为：system.properties

不

模板文件

包含对模板及其描述的引用的文件的逗号分隔列表。
路径必须相对于 JMeter 根文件夹
默认为：/bin/templates/templates.xml

不

19.39 线程组验证功能¶

验证是用于快速验证线程组运行良好的特性的名称

参数

属性

描述

必需的

testplan_validation.tree_cloner_class

默认实现是

org.apache.jmeter.gui.action.validation.TreeClonerForValidation

它在没有计时器的情况下运行验证，一个线程和一个迭代。您可以实施必须扩展org.apache.jmeter.engine.TreeCloner
的自己的策略。 JMeter 将实例化它并使用它来创建用于在线程组上运行验证的树。默认为：

org.apache.jmeter.gui.action.validation.TreeClonerForValidation

不

testplan_validation.nb_threads_per_thread_group

用于验证线程组的线程数。
默认为：1

不

testplan_validation.ignore_timers

验证计划的线程组时忽略计时器。
默认为：真

不

testplan_validation.ignore_backends

验证计划的线程组时忽略BackendListener。
默认为：真

不

testplan_validation.number_iterations

用于验证线程组的迭代次数。
默认为：1

不

testplan_validation.tpc_force_100_pct

强制以百分比模式工作的吞吐量控制器为 100%。
默认为：假

不

19.40 定时器相关功能¶

计时器用于在您的计划中引入思考时间。

参数

属性

描述

必需的

定时器因子

通过以下计时器对计算的暂停应用一个因子：

高斯随机定时器
统一随机定时器
泊松随机定时器

默认为：1.0f

不

think_time_creator.impl

创建 Timer 结构以添加到测试计划的默认实现。实现接口org.apache.jmeter.gui.action.thinktime.ThinkTimeCreator 默认为：org.apache.jmeter.thinktime.DefaultThinkTimeCreator

不

think_time_creator.default_timer_implementation

DefaultThinkTimeCreator 添加到测试计划的默认计时器 GUI 类默认为：org.apache.jmeter.timers.gui.UniformRandomTimerGui

不

think_time_creator.default_constant_pause

定时器的默认恒定暂停默认为：1000

不

think_time_creator.default_range

Timer的默认范围暂停默认为：100

不

^

19.41 命名策略¶

计时器用于在您的计划中引入思考时间。

参数

属性

描述

必需的

命名策略前缀

命名元素时使用的前缀。默认为空前缀

不

命名策略.suffix

命名元素时使用的前缀。默认为空后缀

不

命名策略.impl

接口org.apache.jmeter.gui.action.TreeNodeNamingPolicy的实现创建 Timer 结构以添加到测试计划的默认实现。实现接口 org.apache.jmeter.gui.action.thinktime.ThinkTimeCreator 默认为：org.apache.jmeter.gui.action.impl.DefaultTreeNodeNamingPolicy

不

^

19.42 帮助¶

控制 JMeter 中文档的显示方式

参数

属性

描述

必需的

help.local

允许使用在 JMeter GUI 中打开的本地文档的开关。
默认情况下，我们使用在浏览器中打开的在线文档。默认为假

不

19.43 高级 Groovy 脚本配置¶

在 Groovy 中配置脚本的高级属性

参数

属性

描述

必需的

groovy.utilities

Groovy 文件的路径，其中包含使__groovy函数可用的实用程序函数。
默认为bin/utility.groovy

不

19.44 高级 JSR-223 脚本配置¶

JSR-223 中脚本配置的高级属性

参数

属性

描述

必需的

jsr223.init.file

JSR-223 文件的路径，其中包含在 JMeter 启动时调用的脚本。

要使用的实际脚本引擎将由 init 文件名的扩展名决定。如果文件名没有扩展名，或者找不到该扩展名的脚本引擎，则将使用 Groovy。

该脚本可以使用预定义的变量：

log：记录任何消息的记录器，使用 SLF4J 库
道具：JMeter 属性
OUT : System.OUT，在控制台写有用

默认情况下没有定义脚本。

不

jsr223.compiled_scripts_cache_size

由 JSR-223 元素使用。
已编译脚本缓存的大小。
默认为：100

不

19.45 文档生成¶

文档生成的高级属性

参数

属性

描述

必需的

docgeneration.schematic_xsl

用于生成测试计划示意图的 XSL 文件的路径。
为空时，JMeter 会使用 src/core/org/apache/jmeter/gui/action/schematic.xsl 中嵌入的
无默认值

不

19.46 安全提供者¶

文档生成的高级属性

参数

属性

描述

必需的

安全提供者

该值必须采用以下格式：<ClassName>[:<Postion>[:<ConfigString>]]

不

. 例子：

org.bouncycastle.jce.provider.BouncyCastleProvider: 将BouncyCastleProvider添加到下一个可用位置。
org.bouncycastle.jce.provider.BouncyCastleProvider:1: 在第一个位置添加BouncyCastleProvider 。
org.bouncycastle.jsse.provider.BouncyCastleJsseProvider:2:BC: 在第二个位置添加BouncyCastleJsseProvider。并将其配置为使用 BC 提供程序。

security.provider.<n>

将<n>替换为任意数字。SecurityProviders 将按属性名称的字母顺序添加。（首先：security.provider然后是security.provider.2，security.provider.3，...）参见属性security.provider

不