1、JMeter的非GUI模式说明
之前,我们在启动JMeter时,一直会有一个黑色命令行窗口,窗口中提示了如下的信息:
Jun 05, 2021 10:21:22 AM java.util.prefs.WindowsPreferences <init>
WARNING: Could not open/create prefs root node Software\JavaSoft\Prefs at root 0x80000002. Windows RegCreateKeyEx(...) returned error code 5.
================================================================================
Don't use GUI mode for load testing !, only for Test creation and Test debugging.
For load testing, use NON GUI Mode:
jmeter -n -t [jmx file] -l [results file] -e -o [Path to web report folder]
& increase Java Heap to meet your test requirements:
Modify current env variable HEAP="-Xms1g -Xmx1g -XX:MaxMetaspaceSize=256m" in the jmeter batch file
Check : https://jmeter.apache.org/usermanual/best-practices.html
================================================================================
信息中提示:
- 不要使用 GUI 模式进行负载测试! GUI 模式仅用于测试创建和测试调试。
- 对于负载测试,使用非 GUI 模式。
非 GUI 模式启动方式:jmeter -n -t [jmx file] -l [results file] -e -o [Path to web report folder]
- 可以增加Java虚拟机的堆空间,以满足您的测试需求。
在JMeter批处理文件中修改当前环境变量:HEAP="-Xms1g -Xmx1g -XX:MaxMetaspaceSize=256m"
。
说明:
Java虚拟机在执行Java程序的过程中,会把它所管理的内存划分为若干个不同的数据区域。主要包括:程序计数器、虚拟机栈、本地方法栈、Java堆、方法区(运行时的常量池)。
如下图所示:
而Java Heap内存,简单的说是用来存放
new
出来的对象和数组。也就是负责运行时数据的存放,由JVM的自动管理。在做负载测试时,Java Heap内存空间,调整的大一些,可以避免因Java堆内存不足,而终止测试的情况。如报错:
java.lang.OutOfMemoryError: Java heap space
。
2、为什么使用非GUI模式运行JMeter
使用GUI方式启动JMeter,在运行线程较多的测试时,会造成内存和CPU的大量消耗,导致客户机卡死。
所以做一般的接口测试、脚本调试、压力测试脚本编写等操作时,我们都会选用GUI模式,因为这里不会涉及到压力测试,只是调试脚本,我们本身关注的也是结果是否通过。而在进行负载测试时,都是使用命令行模式执行脚本,来减少因系统资源的消耗,对测试结果的影响。
并且命令行方式支持在多个环境下使用,可以在Windows系统的dos环境下,也可以在Linux环境上执行。
命令行模式优点:
- 图形化界面消耗更多资源,如CPU和内存,容易使压力机达到瓶颈,从而影响测试结果。
- 图形化界面不支持大型的负载测试和性能测试,并发较大时,JMeter会崩溃。
- 命令行方式可以把脚本配置到Jenkins上实现持续集成,做成自动化测试。通过shell脚本或批处理命令均可执行,测试结果可生成报表,可被直接使用生成图形化报告。
- 支持远程或分布式执行。
3、使用非GUI模式运行JMeter
(1)非GUI模式运行JMeter步骤
1)确定执行路径
执行命令前要检查当前目录是否是%JMeter_Home%\bin
目录。
- 如果 JMeter 脚本不在当前目录,需要指定完整的路径。
- 如果要把执行的结果保存在其他地方,也要指定完整的路径。
- 命令中不指定测试计划与测试结果的路径时,
测试计划只在当前目录中查找,测试结果默认都是在执行JMeter命令所在的目录下生成。
2)执行命令
例如,上面日志中提示的命令方式,如下:
jmeter -n -t [testplan jmx file] -l [results file] -e -o [Path to web report folder]
参数解释:
-
-n
:表示non gui mode
,就是非图形化模式。 -
-t
:指定JMX脚本路径,即test plan
(测试计划)。后面跟需要运行的JMeter 脚本的路径和脚本名称。 -
-l
:指定结果文件路径。
后面跟输出结果文件路径和结果文件名称。
1)若没有指定指定结果文件路径,则自动创建,可以生成.csv
文件或者.jtl
文件。
2)若只写脚本名称,则默认是在当前目录查找或创建。 -
-e
:设置测试完成后生成测试报表。 -
-o
:指定测试报表生成文件夹,该文件夹必须为空或不存在。
(2)其它参数说明
对于负载测试,您必须在非GUI模式下运行JMeter,以获得最佳结果。
为此,请使用以下命令选项:
4、CLI模式运行示例
示例一:
测试计划脚本在%JMeter_Home%\bin
目录中,且测试结果也生成在%JMeter_Home%\bin
目录中。
在CMD中进行到%JMeter_Home%\bin
位置,执行命令如下:
jmeter -n -t CLI_test.jmx -l result.jtl
命令含义:以命令行模式运行当前目录下的CLI_test.jmx
测试脚本文件,并在当前目录下输出测试结果文件result.jtl
。
如下图所示:
提示:
- 测试脚本一定要在
bin
目录中,测试结果文件可以不创建,没有则自动创建,不写路径就默认创建在bin
目录中。- 如果已存在测试结果文件,测试结果会追加到结果文件中。(文件不能处于被其他软件打开状态)
- 测试结果文件和日志信息文件,都是这种方式,下面就不重复介绍了。
示例二:
把测试脚本文件在%JMeter_Home%\bin
目录中,然后把测试结果文件和测试日志信息,输出到指定的路径。
在CMD中进行到%JMeter_Home%\bin
位置,执行命令如下:
jmeter -n -t CLI_test.jmx -l C:\Users\L\Desktop\cli\result.jtl -j C:\Users\L\Desktop\cli\test.log
如下图所示:
示例三:
执行任何位置的JMeter脚本文件。
在CMD中进行到%JMeter_Home%\bin
位置,执行命令如下:
jmeter -n -t C:\Users\L\Desktop\JMeterScript\CLI_test.jmx -l C:\Users\L\Desktop\cli\result.jtl
如下图所示:
示例四:(推荐)
在任何位置,执行任何位置的脚本。
前提:需要配置JMeter的
bin
目录到环境变量中。
在任何位置执行如下命令:
jmeter -n -t C:\Users\L\Desktop\JMeterScript\CLI_test.jmx -l C:\Users\L\Desktop\cli\result.jtl
如下图所示:
配置完成JMeter的环境变量,就可以在任何位置执行JMeter命令,不用每次都到
%JMeter_Home%\bin
位置执行命令了。同理:执行命令所在目录中的脚本,同样可以不写路径。
示例五:
默认分布式执行,命令如下:
jmeter -n -t CLI_test.jmx -r -l report\01-result.csv -j report\01-log.log
示例六:
指定IP分布式执行,命令如下:
jmeter -n -t CLI_test.jmx -R 192.168.10.25:1036 -l report\01-result.csv -j report\01-log.log
即:启动remote_hosts
分布式测试。
注意:如果使用
-R serverIP port
模式,将启动指定的远程压力机,配置文件中设置的remote_hosts
属性将被此设置覆盖,类似指定远程压力机执行测试。
示例七:
生成测试结果报表,即:生成 HTML报告,并保存报告到指定文件夹中。
命令格式:
jmeter -n -t 【Jmx脚本位置】-l 【结果文件result.jtl存放的位置】-e -o 【报告指定文件夹】
示例:
jmeter -n -t test1.jmx -l report\01-result.jtl -e -o tableresult
说明:最后三个命令,不进行演示,后面的文章中会详细说明。