19 简介

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

19.1 语言

参数

属性
描述
必需的
语言
首选的 GUI 语言。注释掉以使用 JVM 默认语言环境的语言。
例子:
language=en
此属性是唯一必须在jmeter.properties文件中设置的属性
要完全配置语言,请确保设置语言环境,请参阅国际化:了解 Java 平台中的语言环境。英语示例:
-Duser.language=en -Duser.region=EN
语言环境.add
要添加到显示列表的其他语言环境。
当前的默认列表是:enfrdenoestrjazh_CNzh_TWplpt_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 authenticatedjava.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.nativetrue
时,此属性才有效。默认为:

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  +  0Ctrl  +  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
在服务器上:
  1. 设置 server_port=1234
  2. 使用端口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
控制RemoteSampleListenerImplRemoteThreadsListenerImpl(控制器) 使用的 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,但通常支持的是JKSPKCS12。默认为: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.codeRETURN_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
本部分有助于确定如何保存结果数据。
注释掉的值是默认值。
合法值:xmlcsvdb
目前仅支持xmlcsv
默认为:csv
jmeter.save.saveservice.assertion_results_failure_message
应该保存字段时为真;否则为假。
assertion_results_failure_message仅影响 CSV 输出。
默认为:
jmeter.save.saveservice.assertion_results
合法值: n ​​onefirstall
默认为:
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 ​​onems或适合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 采样器。
可以是其中之一
HTTPSamplerJava
使用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 元素中删除的默认标题。指定为逗号分隔列表
标头CookieAuthorization始终被删除。
默认为: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_thresholdtime_threshold配置
统计
返回样本汇总统计信息。由属性key_on_threadnametime_threshold配置
剥离
标准模式类似,但从 SampleResult 中去除 Response。由属性sample_sender_strip_also_on_error配置
剥离批次
Batch相同,但从 SampleResult 中去除 Response。由属性num_sample_thresholdtime_thresholdsample_sender_strip_also_on_error配置
异步
异步发送者;使用队列和后台工作进程返回样本。由属性asynch.batch.queue.size配置
剥离异步
Asynch相同,但从 SampleResult 中删除响应数据。由属性asynch.batch.queue.sizesample_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
从采样器中的CLOBBLOB 存储的最大字节数。
默认为: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
要在报告中显示的百分位数。以0100
之间的浮点值形式给出(表示百分比)。 要显示的第一个百分位数。 默认为:90

聚合rpt_pct2
要显示的第二个百分位数。以0100
之间的浮点值形式给出(表示百分比)。 默认为:95
聚合rpt_pct3
要显示的第二个百分位数。以0100
之间的浮点值形式给出(表示百分比)。 默认为: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
PercentilesMinMax 的后端指标滑动窗口大小。
默认为:100
backend_metrics_large_window
PercentilesMinMax 的后端指标滑动窗口大小。当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.2security.provider.3,...)参见属性security.provider
Go to top