Earlier changes are detailed in the History of Previous Changes.
- New and Noteworthy
- Incompatible changes
- Bug fixes
- Non-functional changes
- Known problems and workarounds
New and Noteworthy
JMeter now supports Java 17
JMeter 5.5 ships with log4j2 2.17.2
Open Model Thread Group
New component: Open Model Thread Group allows creating load profiles with variable load.
For example, if you need to gradually increase load from 0/sec to 10/sec during minute you could previously use Thread Group + Timer combinations. However, then you need to compute the expected number of threads, ensure they are created only when needed, and so on.
With Open Model Thread Group you can configure the same load profile as rate(0/sec) random_arrivals(1 minute) rate(10/sec). The thread group would spawn threads as needed to drive the configured load. The load profile can use properties, so you can launch the same script with slightly different load levels, however, the profile can't be updated while the test is running.
The new thread group is experimental in JMeter 5.5, so please feel free to submit your feedback.
Preparing the deprecation of Oro Regex usage
Another experimental feature in JMeter 5.5 is the ability to replace the Oro based Regex implementation by the built-in Java based one. To choose the Java based one, set the JMeter property jmeter.regex.engine to the value java.
Kotlin language is now used in some core classes and tests (e.g. Open Model Thread Group). JMeter is compiled with apiTarget=1.5, and it ships with kotlin-stdlib 1.6.
lets-plot-kotlin charting library is added, so it will be easier to refine and create new charts in UI in the future.
- New component: Open Model Thread Group
HTTP Samplers and Test Script Recorder
- Bug 65027 - Detect mime-type for files automatically when adding files to HTTP Sampler
- Bug 65020 - HTTP Sampler/Files upload tab – add missing buttons
- Pull request #650 - HTTP Sampler timestamp fix when exception is caught. Contributed by Konstantin Kalinin (konstantin at kkalinin.pro)
- Bug 65328 - Pull request #666 - HTTP 308 Permanent Redirect is not supported. Contributed by Baptiste Gaillard (baptiste.gaillard at gmail.com)
- Bug 65149 - Pull request #644 - Encode the personal part of email addresses in SMTP Sampler
- Pull request #638 - Various additions to the Bolt Sampler. Added transaction timeout, database option required for Neo4j 4.x (with multi-database support) and access mode option, that allows running against a Neo4j Enterprise Causal Cluster. Contributed by David Pecollet (david.pecollet at gmail.com)
- Pull request #665 - Increase visible lines of code in IfController and WhileController. Based on an idea by David Getzlaff (david.getzlaff at t-systems.com>).
- Bug 64988 - Sort properties and variables in a human expected order for DebugPostProcessor and DebugSampler
- Bug 63061 - Sort View Results in Table in a human expected order
- Pull request #706 - Try to keep UI responsive when displaying large text results. Can be configured with the new property view.results.tree.simple_view_limit
Timers, Assertions, Config, Pre- & Post-Processors
- Pull request #638 - Bolt Connection Configuration: added ConnectionPoolMaxSize parameter. Contributed by David Pecollet (david.pecollet at gmail.com)
- Bug 65515 - Allow pooling of Prepared Statements in JDBC
- Bug 65299 - JSONPathAssertion attributes are out of order/Compare JSON objects and not their string representations.
Report / Dashboard
- Bug 65353 - Make the estimator used for calculating percentiles on the dashboard configurable
- Bug 61805 - Pull request #663 - Add simple HTTP request template. Contributed by Ori Marko (orimarko at gmail.com)
- Bug 65611 - Pull request #673 - Add support for IPv6 addresses when specifying a remote worker node. Based on a patch by Peter Wong (peter.wong at csexperts.com)
- Reduce memory consumption by the logging panel (disable undo events for it)
- Bug 63620 - Pull request #694 - Fix GUI freeze when viewing response body with long line breaks
- Pull request #699 - Add documentation for Graphite Backend Listener. Contributed by Ji Hun (jihunkimkw at gmail.com)
- Bug 57672 - Pull request #700 - Add a switch (jmeter.regex.engine) to replace Oro Regex implementation by the built-in Java one.
- Added Kotlin 1.6.21 for JMeter engine implementation (apiVersion=1.5). The set of JSR 223 languages is intact.
- Bug 65128 - Pull request #643 - Add missing documentation about Same user on each iteration for Thread Groups. Contributed by njkuzas.
- Pull request #648 - Updated xmlgraphics-commons to 2.6 (from 2.3). Contributed by Stefan Seide (stefan at trilobyte-se.de)
- Pull request #655, Pull request #667, Pull request #675, Pull request #698 - Updated x-stream to 1.4.19 (from 1.4.15). Contributed by Stefan Seide (stefan at trilobyte-se.de)
- Pull request #656, Pull request #668 - Updated json-smart to 2.4.8 (from 2.3), accessors-smart to 2.4.8 (from 1.2) and asm 9.3 (from 9.0). Contributed by Stefan Seide (stefan at trilobyte-se.de)
- Bug 64831 - Log truststore entries in debug level for logger org.apache.jmeter.util.keystore.JmeterKeyStore
- Bug 65232 - Hide splash screen when an error is displayed because the test plan could not be parsed.
- Updated Groovy to 3.0.11 (from 3.0.7).
- Updated Darklaf to 2.7.3 (from 2.5.4).
- Updated Apache ActiveMQ to 15.6.4 (from 15.6.0).
- Updated Asm to 9.2 (from 9.1).
- Updated Bouncycastle to 1.70 (from 1.67).
- Updated Caffeine to 2.9.3 (from 2.8.8).
- Updated Apache commons-dbcp2 to 2.9.0 (from 2.8.0).
- Updated Apache commons-io to 2.11.0 (from 2.8.0).
- Updated Apache commons-lang3 to 3.12.0 (from 3.11).
- Updated Apache commons-net to 3.8.0 (from 3.7.2).
- Updated Apache commons-pool2 to 2.11.1 (from 2.9.0).
- Updated equalsverifier to 3.10 (from 3.4.2).
- Updated Apache Freemarker to 2.3.31 (from 2.3.30).
- Updated hsqldb to 2.5.2 (from 2.5.0).
- Updated Apache HttpClient to 4.5.13 (from 4.5.12).
- Updated Apache HttpCore to 4.4.15 (from 4.4.13).
- Updated jacoco to 0.8.7 (from 0.8.5).
- Updated json-path to 2.7.0 (from 2.4.0).
- Updated jsoup to 1.15.1 (from 1.13.1).
- Updated JUnit to 4.13.2 and 5.8.2 (from 4.13.1 and 5.7.0).
- Updated Apache log4j2 to 2.17.2 (from 2.13.3).
- Updated Miglayout to 5.3 (from 5.2).
- Updated Neo4j Java driver to 4.4.6 (from 4.2.0).
- Updated Objenesis to 3.2 (from 2.6).
- Updated ktlint to 0.40.0
- Updated PH CSS and PH commons to 6.5.4 and 10.1.6 (from 6.2.3 and 9.5.1).
- Updated RSyntaxTextArea to 3.2.0 (from 3.1.1).
- Updated SLF4J to 1.7.36 (from 1.7.30).
- Updated SvgSalamander to 184.108.40.206 (from 220.127.116.11).
- Pull request #698 - Updated Apache Tika to 1.28.3 (from 1.26).
- Updated WireMock-JRE8 to 2.30.0 (from 2.24.1).
- Updated com.github.vlsi.vlsi-release-plugins 1.76 (from 1.74).
- Updated jackson to 2.13.3 (from 2.10.5)
- Updated jmespath to 0.5.1
- Updated Saxon-HE to 11.2 (from 9.9.1-8)
- Updated Apache xmlgraphics commons to 2.7 (from 2.6)
- Pull request #671 - Move example definition of property jmeter.reportgenerator.statistic_window to user.properties, as it is read from that place. Contributed by Rithvik Patibandla (rithvikp98 at gmail.com)
- Bug 65456 - Updated commons-jexl 3 to 3.2.1 (from 3.1). Contributed by Ori Marko (orimarko at gmail.com>)
- Pull request #654 - Try do give better feedback while loading keystores
- Pull request #672 - Add more details to documentation for timeShift function. Contributed by Mariusz (mawasak at gmail.com)
- Updated Gradle to 7.3 (from 7.2)
- Pull request #689 - Code clean up in StringFromFile. Contributed by Sampath Kumar Krishnasamy (sampathkumar.krishnasamykuppusamy at aexp.com)
- Pull request #690 - Refactor a few unit tests. Contributed by Sampath Kumar Krishnasamy (sampathkumar.krishnasamykuppusamy at aexp.com)
- Pull request #692> - Fix a few deprecation warnings for Gradle. Contributed by Sampath Kumar Krishnasamy (sampathkumar.krishnasamykuppusamy at aexp.com)
- Pull request #697> - Junit 5 tests to use asserts from Junit 5 API. Contributed by Sampath Kumar Krishnasamy (sampathkumar.krishnasamykuppusamy at aexp.com)
- Bug 65983 - Pull request #707 - Use current screenshot for save-to-file listener in documentation. Based on patch by NaveenKumar Namachivayam (catch.nkn at gmail.com)
- Pull request #708 - Make errorprone happier. Based on patch by Wilson Kurniawan (wilson at visenze.com)>
HTTP Samplers and Test Script Recorder
- Bug 65310 - Don't let users override multipart/form-data content-type header in HC4 sampler.
- Bug 65363 - NullPointerException in HTTPHC4Impl$ManagedCredentialsProvider.getAuthorizationForAuthScope when 401 response from remote and httpclient4.auth.preemptive=false
- Bug 65692 - HTTP(s) Test Script Recorder: Enable setting enabled cipher suite and enabled protocols on SSLContext/ Align SSL properties between Java and HC4 implementation
- Bug 65108 - Support JMeter variables in GraphQL HTTP Request
- Bug 65864 - Catch NullPointerException from JSoup when recording a test plan
- Bug 65152 - OS Process Sampler – Cannot Add from Clipboard Command parameters
- Pull request #638 - Bolt Sampler: fixed error displaying results when "Record Query Results" is enabled. Contributed by David Pecollet (david.pecollet at gmail.com)
- Bug 64962 - Save CSV sub-results recursively from View Results Tree
- Bug 65784 - No Graphs displayed in Aggregate Report/Response Time Graph
- Bug 65884 - GUI doesn't display response for multipart request manually encoded
Timers, Assertions, Config, Pre- & Post-Processors
- Bug 65257 - JMESPathExtractor writes error log entries if JMESPath filter returns empty result
- Bug 65259 - JMESPathExtractor Attribute Match No. Required
- Bug 65269 - JSON Extractor and JSON JMESPath Extractor ignore sub-samples
- Bug 65352 - Warning logged when Boundary Extractor doesn't find any match
- Bug 65681 - Use default values for null values when extracting with JSONPostProcessor
- Allow setters in ConstantThroughputTimer to update the values during run time
- Bug 65782 - Use correct message format for MessageFormat in HTMLAssertion
- Bug 65794 - JSON Assertion always successful with indefinite paths
Report / Dashboard
- Pull request #658 - Improve javadoc. Contributed by Ori Marko (orimarko at gmail.com)
- Bug 64318 - DNS Cache Manager – custom DNS resolver does not use system resolver by default
- Pull request #641, Pull request #698 - Updated xercesImpl to 2.12.2 (from 2.12.0). Based on patch by Stefan Seide (stefan at trilobyte-se.de).
- Pull request #645 - Add escaping for new lines in AbstractInfluxdbMetricsSender. Contributed by David Getzlaff (david.getzlaff at t-systems.com>)
- Bug 65198 - Can't copy generated function from FunctionHelper
- Pull request #661 - Fix wording in doc. Contributed by BugKing (wangzhen at fit2cloud.com)
- Pull request #664 - Allow whitespace in path. Contributed by Till Neunast (github.com/tilln)
- Bug 65270 - POST application/x-www-form-urlencoded cURL code generated from Postman is not imported correctly
- Silence warnings of missing font Arial on startup under Linux
- Bug 65300 - IllegalAccessError when opening file dialog with Java 16
- Bug 65336 - Blank labels when different elements had the same name
- Bug 65522 - Restart doesn't work, when parameters contain spaces
- Bug 63914 - Simplify :src:dist:clean configuration, ensure /lib/junit/test.jar is removed on clean
- Pull request #696 - Keep JSyntaxTextArea text value for use in headless mode. Contributed by Peter Paul Bakker (peter.paul.bakker at stokpop.nl)
We thank all contributors mentioned in bug and improvement sections above:
- Stefan Seide (stefan at trilobyte-se.de)
- njzukas (github.com/njzukas)
- David Getzlaff (david.getzlaff at t-systems.com>)
- Konstantin Kalinin (konstantin at kkalinin.pro)
- David Pecollet (david.pecollet at gmail.com)
- Ori Marko (orimarko at gmail.com)
- BugKing (wangzhen at fit2cloud.com)
- Till Neunast (github.com/tilln)
- Baptiste Gaillard (baptiste.gaillard at gmail.com)
- Rithvik Patibandla (rithvikp98 at gmail.com)
- Mariusz (mawasak at gmail.com)
- Woonsan Ko (woonsan.ko at bloomreach.com)
- Chromico Rek (atech5122 at gmail.com)
- Magnus Spångdal (magnus.spangdal as avanza.se)
- Piotr Smietana (piotrsmietana1998 at gmail.com)
- Sampath Kumar Krishnasamy (sampathkumar.krishnasamykuppusamy at aexp.com)
- Ji Hun (jihunkimkw at gmail.com)
- Peter Paul Bakker (peter.paul.bakker at stokpop.nl)
- NaveenKumar Namachivayam (catch.nkn at gmail.com)
- Wilson Kurniawan (wilson at visenze.com)
We also thank bug reporters who helped us improve JMeter.
- Nikola Aleksic (nalexic at gmail.com)
- Vladimir Rosu (rosuvladimir at gmail.com)
Apologies if we have omitted anyone else.
Known problems and workarounds
- The Once Only controller behaves correctly under a Thread Group or Loop Controller, but otherwise its behaviour is not consistent (or clearly specified).
- The numbers that appear to the left of the green box are the number of active threads / total number of threads, the total number of threads only applies to a locally run test, otherwise it will show 0 (see Bug 55510).
Note that under some windows systems you may have this WARNING:
java.util.prefs.WindowsPreferences WARNING: Could not open/create prefs root node Software\JavaSoft\Prefs at root 0 x80000002. Windows RegCreateKeyEx(…) returned error code 5.The fix is to run JMeter as Administrator, it will create the registry key for you, then you can restart JMeter as a normal user and you won't have the warning anymore.
You may encounter the following error:
java.security.cert.CertificateException: Certificates does not conform to algorithm constraintsif you run a HTTPS request on a web site with a SSL certificate (itself or one of SSL certificates in its chain of trust) with a signature algorithm using MD2 (like md2WithRSAEncryption) or with a SSL certificate with a size lower than 1024 bits. This error is related to increased security in Java 8+.
To allow you to perform your HTTPS request, you can downgrade the security of your Java installation by editing the Java jdk.certpath.disabledAlgorithms property. Remove the MD2 value or the constraint on size, depending on your case.
This property is in this file:
JAVA_HOME/jre/lib/security/java.securitySee Bug 56357 for details.
- Under Mac OSX Aggregate Graph will show wrong values due to mirroring effect on numbers. This is due to a known Java bug, see Bug JDK-8065373 The fix is to use JDK8_u45 or later.
- View Results Tree may fail to display some HTML code under HTML renderer, see Bug 54586. This is due to a known Java bug which fails to parse "px" units in row/col attributes. See Bug JDK-8031109 The fix is to use JDK9 b65 or later.
- JTable selection with keyboard (SHIFT + up/down) is totally unusable with Java 7 on Mac OSX. This is due to a known Java bug JDK-8025126 The fix is to use JDK 8 b132 or later.
Warning: Nashorn engine is planned to be removed from a future JDK releaseTo silence these warnings, add -Dnashorn.args=--no-deprecation-warning to your Java arguments. That can be achieved by setting the enviroment variable JVM_ARGS
- Use Mozilla Rhino
- Copy rhino-engine-1.7.14.jar into $JMETER_HOME/lib/ext.
- Use OpenJDK Nashorn
The OpenJDK Nashorn implementation comes as a module. To use it, you will have to download it and add it to the module path. A hacky way to download the version 15.0 (or later) and its dependencies and set the module path is outlined below:
mkdir lib/modules pushd lib/modules wget https://repo1.maven.org/maven2/org/openjdk/nashorn/nashorn-core/15.3/nashorn-core-15.3.jar wget https://repo1.maven.org/maven2/org/ow2/asm/asm/9.2/asm-9.2.jar wget https://repo1.maven.org/maven2/org/ow2/asm/asm-commons/9.2/asm-commons-9.2.jar wget https://repo1.maven.org/maven2/org/ow2/asm/asm-util/9.2/asm-util-9.2.jar wget https://repo1.maven.org/maven2/org/ow2/asm/asm-tree/9.2/asm-tree-9.2.jar wget https://repo1.maven.org/maven2/org/ow2/asm/asm-analysis/9.2/asm-analysis-9.2.jar popd export JVM_ARGS="--module-path $PWD/lib/modules" ./bin/jmeter