New Search Feature in View Results Tree to allow searching for text / regexp in Request/Responses/Headers/Cookies/… This will ease correlation and Test plans creation
New JSON Post Processor to better extract data from JSON content using user friendly JSON-PATH syntax
JSON is now a first class citizen in JMeter with the introduction of a new
JSONPath
post processor.
This post processor is very similar to Regular Expression Post Processor but is well suited for JSON code.
It is based on
Jayway JSON Path library
New validation feature, in one click run a selection of Thread Groups with user, no pause and iteration
JSR223 Test Elements do not require a Cache Compilation Key anymore
Just check
Cache compiled script if available
checkbox and the elements (Pre-Processor, Post-Processor, Assertions, Listeners, …)
will pre-compile the script and cache the compiled code if the underlying language supports it
Nashorn can now be used as Javascript engine providing better performance and easier usage
To enable
Nashorn
, you need to set in
user.properties
:
javascript.use_rhino=false
Nashorn can be used with Java 8 in the following elements:
IfController
JSR223 Test elements with
javascript
language selected
__javaScript
function
Jexl3 has been integrated. It provides new scripting features and much better documentation
JEXL3
can now be used thanks to a new function
__jexl3
.
JEXL is a language very similar to JSTL.
Simplified HTTP Request UI
A new "
Advanced
" tab has been added to HTTP Request to simplify configuration. The file upload feature has been moved into a dedicated tab.
This increases the space available for parameters in UI and simplifies the UX.
HTTP Request Defaults improvements
You can now configure Source Address (IP Spoofing like feature) and "
Save response as MD5 hash
" in Advanced Tab
Reporting improvements
New Reporting Feature generating dynamic Graphs in HTML pages (APDEX, Summary report and Graphs)
A dynamic HTML report can now be generated either at the end of a load test or from a result file whenever you want.
See
Generating dashboard
for more details.
This report provides the following metrics:
APDEX
(Application Performance Index) table that computes the APDEX based on configurable values for tolerated and satisfied thresholds
A request summary graph showing the Success and failed transaction percentage:
A Statistics table providing in one table a summary of all metrics per transaction including 3 configurable percentiles :
An error table providing a summary of all errors and their proportion in the total requests :
Zoomable chart where you can check/uncheck every transaction to show/hide it for:
Response times Over Time :
Bytes throughput Over Time :
Latencies Over Time :
Hits per second :
Response codes per second :
Transactions per second :
Response Time vs Request per second :
Latency vs Request per second :
Response times percentiles :
Active Threads Over Time :
Times vs Threads :
Response Time Distribution :
GraphiteBackendListener has a new Server Hits metric
Summariser displays a more readable duration
Now duration are display in the format
hours:minutes:seconds
BackendListener now allows you to define sampler list as a regular expression
You can now use a regular expression to select the samplers you want to filter.
Use parameter:
useRegexpForSamplersList=true
and put a regex in pararameter
samplersList
Protocols and Load Testing improvements
Migration to HttpClient 4.5.2 has been started. Although not completely finished, it improves many areas in JMeter
Migration to HttpClient 4.5.2 improves the following fields of JMeter:
Improved and better performing validation mechanism for Stale connections and Keep-Alive management, see properties
httpclient4.validate_after_inactivity
and
httpclient4.time_to_live
Better support of HTTP RFC 2616 / RFC 7230 and fixes to issues with
deflate
compression management
Parallel Downloads is now realistic and scales much better:
Parsing of CSS imported files (through
@import
) or embedded resources (background, images, …)
Lazy initialization of SSL context: For 15 Threads 138% more sampling in 5 minutes for HTTP only tests. Gain increases as number of threads increases
Rework of Connection management for Parallel Download: This better simulates current browser behaviour and improves throughput. For 15 Threads 135% extra samples in 5 minutes.
Reuse of Threads used for Parallel downloads through a ThreadPool: This improves throughput and increases JMeter scalability for such tests
Total of 750% more throughput found on test with 15 threads, the more threads you have the more the gain
You can now compute and store just the MD5 of embedded resources instead of storing the entire response, this can be done by setting the property
httpsampler.embedded_resources_use_md5=true
Introduction of Sample Timeout feature
This new
Sample Timeout
Pre-Processor allows you to apply a Timeout on the elements that are in its scope.
In the screenshot below the 10 second timeout applies to the
Debug Sampler
and
HTTP Request
elements.
JDBC request now uses DBCP2 pool
JDBC Request and JDBC Connection Configuration have been updated to replace old Excalibur Pool by Apache Commons DBCP2 pool. As a consequence properties have been migrated to equivalent
when available and UI has been updated.
Note that unlike Excalibur, Commons DBCP uses the validation query when creating the pool.
So make sure the query is valid.
The default query suits many databases, but not all - for example Oracle requires '
SELECT 1 FROM DUAL
' or similar.
JMeter has a new Logo created by Felix Schumacher.
Icons have also been refreshed to give a more modern style and make them more meaningful
Lots of fixes of annoying little bugs
Around 40 UI fixes have been made to either fix buggy, confusing behaviour or simplify usage by not allowing incompatible options to be selected
Improved Thread Group UI and related actions (, , )
Creating and testing a Test Plan before Load Test has been much simplified by allowing you to only start a selection of Thread Group, start them without applying Timers (thus gaining time)
or start them using a new Validation mode. This validation mode allows you to start a Thread Group (without modifying it) with 1 thread, 1 iteration and without applying timers.
This validation mode can be customized.
New shortcuts
Add most used elements
(
Ctrl + 0
…
Ctrl + 9),
configurable through
gui.quick_
XXX
properties
Shortcuts to expand nodes
Core improvements
Configuration simplification with better defaults
Default values for many properties have been modified to make JMeter configuration optimal Out of the box. Read "Incompatible changes" section for more details.
Apache Groovy bundled with JMeter
Apache Groovy
, the well-known JVM scripting language, is now bundled with Apache JMeter in lib folder.
This allows you to use it immediately through JSR223 Elements by selecting the Groovy language.
Superflous and old properties removed
Old properties that existed to maintain backward compatibility or to offer some superflous customization have been removed.
Read "Incompatible changes" section to see which properties have been removed.
Code and documentation improvements
Migration to Java7 source code and use of its syntactic sugar
Major code cleanups
Full review of documentation and improvement both in content and presentation
Improvements to unit tests
Migration of many tests to JUnit 4
Better management of Headless tests
More Unit Tests
Dependencies refresh
Deprecated Libraries dropped or replaced by up to date ones:
Excalibur replaced by commons-dbcp
htmllexer, htmlparser removed
soap removed
jdom removed
Slf4j can now be used within Plugins and core code
You can now use
SLF4J
logging wrapper in your custom plugins or
org.apache.jmeter.protocol.java.sampler.AbstractJavaSamplerClient
subclasses.
Since version 3.0, Groovy-2.4.6 is bundled with JMeter (
lib
folder), ensure you remove old version or referenced versions through properties
search_paths
or
user.classpath
Since version 3.0,
jmeter.save.saveservice.assertion_results_failure_message
property value is true, meaning CSV file for results will contain an additional column containing assertion result response message, see
Bug 58978
Since version 3.0,
jmeter.save.saveservice.print_field_names
property value is true, meaning CSV file for results will contain field names as first line in CSV, see
Bug 58991
Since version 3.0,
jmeter.save.saveservice.idle_time
property value is true, meaning CSV/XML result files will contain an additional column containing idle time between samplers, see
Bug 57182
In RandomTimer class, protected instance
timer
field has been replaced by
getTimer()
protected method, this is related to
Bug 58100
. This may impact 3
rd
party plugins.
Since version 3.0, you can use Nashorn Engine (default javascript engine is Rhino) under Java8 for Elements that use Javascript Engine (
__javaScript
,
IfController
). If you want to use it, use property
javascript.use_rhino=false
, see
Bug 58406
.
Note: in a future version, we will switch to Nashorn by default. Users are encouraged to report any issue related to using Nashorn instead of Rhino.
Since version 3.0, JMS Publisher will reload contents of file if Message source is "
From File
" and the "
Filename
" field changes (e.g. if it uses a variable that has changed)
org.apache.jmeter.gui.util.ButtonPanel
has been removed, if you use it in your 3
rd
party plugin or custom development ensure you update your code. See
Bug 58687
Property
jmeterthread.startearlier
has been removed. See
Bug 58726
Property
jmeterengine.startlistenerslater
has been removed. See
Bug 58728
Property
jmeterthread.reversePostProcessors
has been removed. See
Bug 58728
Property
jmeter.toolbar.display
has been removed, the toolbar is now always displayed. See
Bug 59236
Property
jmeter.errorscounter.display
has been removed, the errors/warnings counter is now always displayed. See
Bug 59236
Property
xml.parser
has been removed, it is not used anymore as
org.apache.jmeter.util.JMeterUtils#getXMLParser
has been deprecated and is not used either. See
Bug 59236
Summariser listener now shows the duration in the format
HH:mm:ss
(Hour:Minute:Second), it previously showed the duration in seconds. See
Bug 58776
org.apache.jmeter.protocol.http.visualizers.RequestViewHTTP.getQueryMap
signature has changed, if you use it ensure you update your code. See
Bug 58845
JMS Subscriber will consider a sample to be an error if the number of received messages is not equal to expected number of messages. It previously considered a sample OK if at least 1 message was received. See
Bug 58980
Since version 3.0, HTTP(S) Test Script recorder defaults to using port
8888
(as configured when using Recording Template). See
Bug 59006
Since version 3.0, the parser for embedded resources (replaced since 2.10 by Lagarto based implementation) which relied on the htmlparser library (HtmlParserHTMLParser) has been dropped along with its dependencies.
Since version 3.0, support for reading old Avalon format JTL (result) files has been removed, see
Bug 59064
Since version 3.0, the default property value for
http.java.sampler.retries
has been changed to
0
(no retry by default) to align it with the behaviour of HttpClient4.
Note also that its meaning has changed: before 3.0,
http.java.sampler.retries=1
meant
No Retry
(i.e. total tries = 1), since 3.0
http.java.sampler.retries=1
means
1
retry.
(Note: this only applies to the Java HTTP Sampler)
httpsampler.await_termination_timeout
has been replaced by
httpsampler.parallel_download_thread_keepalive_inseconds
which is now the keep alive time for the parallel download threads (in seconds).
JDBC Request has been updated to use commons-dbcp2, since then the behaviour is slightly different, ensure you have a correct "Validation Query" for your database. See
Bug 58786
Maximum number of redirects allowed by JMeter is now 20, it was previously 5. This can be changed with the property
httpsampler.max_redirects
. See
Bug 59382
Deprecated and removed elements
MongoDB elements (MongoDB Source Config, MongoDB Script) have been deprecated and will be removed in the next version of JMeter. They do not appear anymore in the menu, if you need them modify
not_in_menu
property. The JMeter team advises not to use them anymore. See
Bug 58772
WebService(SOAP) Request and HTML Parameter Mask which were deprecated in 2.13 version, have now been removed following our
deprecation strategy
.
Classes and properties which were only used by those elements have been dropped:
__jexl
function (i.e. JEXL 1) has been deprecated and will be removed in next version. See
Bug 58903
Spline Visualizer listener and Distribution Graph listener have been deprecated and will be removed in the next version of JMeter. They do not appear anymore in the menu, if you need them modify
not_in_menu
property. JMeter team advises not to use them anymore. See
Bug 58791
Bug 57696
- HTTP Request : Improve responseMessage when resource download fails. Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 57995
- Use FileServer for HTTP Request files. Implemented by Andrey Pokhilko (andrey at blazemeter.com) and contributed by BlazeMeter Ltd.
Bug 58843
- Improve the usable space in the HTTP sampler GUI. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58852
- Use less memory for
PUT
requests. The uploaded data will no longer be stored in the Sampler.
This is the same behaviour as with
POST
requests.
Bug 58860
- HTTP Request : Add automatic variable generation in HTTP parameters table by right click. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58923
- normalize URIs when downloading embedded resources.
Bug 59006
- Change Default proxy recording port to
8888
to align it with Recording Template. Contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Bug 58099
- Performance : Lazily initialize HttpClient SSL Context to avoid its initialization even for HTTP only scenarios
Bug 57577
- HttpSampler : Retrieve All Embedded Resources, add property "
httpsampler.embedded_resources_use_md5
" to only compute md5 and not keep response data. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59023
- HttpSampler UI : rework the embedded resources labels and change default number of parallel downloads to
6
. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59028
- Use
SystemDefaultDnsResolver
singleton. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59036
- FormCharSetFinder : Use JSoup instead of deprecated HTMLParser
Bug 59034
- Parallel downloads connection management is not realistic. Contributed by Benoit Wiart (benoit dot wiart at gmail.com) and Philippe Mouawad
Bug 59060
- HTTP Request GUI : Move File Upload to a new Tab to have more space for parameters and prevent incompatible configuration. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59103
- HTTP Request Java Implementation: Change default "
http.java.sampler.retries
" to align it on HttpClient behaviour and make the name meaningful
Bug 59083
- HTTP Request : Make Method field editable so that additional methods (WebDAV) can be added easily
Bug 59118
- Add comment in recorded think time by proxy recorder. Contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Bug 59116
- Add the possibility to setup a prefix to sampler name recorded by proxy. Partly based on a patch by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Bug 59033
- Parallel Download : Rework Parser classes hierarchy to allow plug-in parsers for different mime types
Bug 52073
- Embedded Resources Parallel download : Improve performances by avoiding shutdown of ThreadPoolExecutor at each sample. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59190
- HTTP(S) Test Script Recorder : Suggested excludes should ignore case. Contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Bug 59140
- Parallel Download : Add CSS Parsing to extract links from CSS files
Bug 59249
- Http Request Defaults : Add "
Source address
" and "
Save responses as MD5
"
Bug 59382
- More realistic default value for
httpsampler.max_redirects
Other samplers
Bug 57928
- Add ability to define protocol (http/https) to AccessLogSampler GUI. Contributed by Jérémie Lesage (jeremie.lesage at jeci.fr)
Bug 58300
- Make existing Java Samplers implement Interruptible
Bug 58160
- JMS Publisher : reload file content if file name changes. Based partly on a patch contributed by Maxime Chassagneux (maxime.chassagneux at gmail.com)
Bug 58786
- JDBC Sampler : Replace Excalibur DataSource by more up to date library commons-dbcp2
Bug 59205
- TCP Sampler: Set connect time in sampler when connection is established.
Bug 59381
- JMSPublisher : FileChooserDialog filter does not work for browser buttons. Based partly on a patch contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Controllers
Bug 58406
- IfController : Allow use of Nashorn Engine if available for JavaScript evaluation
Bug 58281
- RandomOrderController : Improve randomization algorithm performance. Contributed by Graham Russell (jmeter at ham1.co.uk)
Bug 58675
- Module controller : error message can easily be missed. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58673
- Module controller : when the target element is disabled the default jtree icons are displayed. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58674
- Module controller : it should not be possible to select more than one node in the tree. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58680
- Module Controller : ui enhancement. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58989
- Record controller gui : add a button to clear all the recorded samples. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Listeners
Bug 58041
- Tree View Listener should show sample data type
Bug 58122
- GraphiteBackendListener : Add Server Hits metric. Partly based on a patch from Amol Moye (amol.moye at thomsonreuters.com)
Bug 58681
- GraphiteBackendListener : Don't send data if no sampling occurred
Bug 58776
- Summariser should display a more readable duration
Bug 58791
- Deprecate listeners: Distribution Graph (alpha) and Spline Visualizer
Bug 58849
- View Results Tree : Add a search panel to the request http view to be able to search in the parameters table. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58857
- View Results Tree : the request view http does not allow to resize the parameters table first column. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58955
- Request view http does not correctly display http parameters in multipart/form-data. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 55597
- View Results Tree: Add a search feature to search in recorded samplers
Bug 59102
- View Results Tree: Better default value for "
view.results.tree.max_size
"
Bug 59099
- Backend listener : Add the possibility to consider samplersList as a Regular Expression. Contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Bug 59424
- Visualizer : Add "Clear" in popup menu
Bug 58303
- Change usage of bouncycastle api in SMIMEAssertion to get rid of deprecation warnings.
Bug 58515
- New JSON related components : JSON-PATH Extractor and JSON-PATH Renderer in View Results Tree. Donated by Ubik Load Pack (support at ubikloadpack.com).
Bug 58698
- Correct parsing of auth-files in HTTP Authorization Manager.
Bug 58756
- CookieManager : Cookie Policy select box content must depend on Cookie implementation.
Bug 56358
- Cookie manager supports cross port cookies and RFC6265. Thanks to Oleg Kalnichevski (olegk at apache.org)
Bug 58773
- TestCacheManager : Add tests for CacheManager that use HttpClient 4
Bug 58742
- CompareAssertion : Reset data in TableEditor when switching between different CompareAssertions in gui.
Based on a patch by Vincent Herilier (vherilier at gmail.com)
Bug 59108
- TableEditor: Allow rows to be moved up and down. Contributed by Vincent Herilier (vherilier at gmail.com)
Bug 58848
- Argument Panel : when adding an argument (add button or from clipboard) scroll the table to the new line. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58865
- Allow empty default value in the Regular Expression Extractor. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59156
- XMLAssertion : drop jdom dependency by using XMLReader
Bug 59328
- Better tooltip for Variable Names in CSVDataSet. Contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Functions
Bug 58477
- __javaScript function : Allow use of Nashorn engine for Java8 and later versions
Bug 58903
- Provide __jexl3 function that uses commons-jexl3 and deprecated __jexl (1.1) function
Bug 57913
- Automated backups of last saved JMX files. Contributed by Benoit Vatan (benoit.vatan at gmail.com)
Bug 57988
- Shortcuts (
Ctrl + 1 …
Ctrl + 9) to quickly add elements into test plan.
Implemented by Andrey Pokhilko (andrey at blazemeter.com) and contributed by BlazeMeter Ltd.
Bug 58100
- Performance enhancements : Replace Random by ThreadLocalRandom.
Bug 58677
- TestSaveService#testLoadAndSave
use the wrong set of files. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58689
- Add shortcuts to expand / collapse a part of the tree. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58696
- Create Ant task to setup Eclipse project
Bug 58653
- New JMeter Dashboard/Report with Dynamic Graphs, Tables to help analyzing load test results. Developed by Ubik-Ingenierie and contributed by Decathlon S.A. and Ubik-Ingenierie / UbikLoadPack
Bug 58699
- Workbench changes neither saved nor prompted for saving upon close. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58165
- Show the time elapsed since the start of the load test in GUI mode. Partly based on a contribution from Maxime Chassagneux (maxime.chassagneux at gmail.com)
Bug 58814
- JVM no longer recognizes option
MaxLiveObjectEvacuationRatio
; remove from comments
Bug 58810
- Config Element Counter (and others): Check Boxes Toggle Area Too Big
Bug 56554
- JSR223 Test Element : Generate compilation cache key automatically. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58911
- Header Manager : it should be possible to copy/paste between Header Managers. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58864
- Arguments Panel : when moving parameter with up / down, ensure that the selection remains visible. Based on a contribution by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58968
- Add a new template to allow to record script with think time included. Contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Bug 59082
- Remove the "
TestCompiler.useStaticSet
" parameter. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59093
- Option parsing error message can be '
lost
'
Bug 58715
- Feature request: Bundle
groovy-all
with JMeter
Bug 58426
- Improve display of JMeter on high resolution devices (HiDPI) (part 1 of enhancement)
Bug 59105
- TableEditor : Add ability to paste rows from clipboard and delete multiple selection. Contributed by Vincent Herilier (vherilier at gmail.com)
Bug 59197
- Thread Group : it should be possible to only run a single threadgroup or a selection of threadgroups with a popup menu. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59207
- Change the font color of
errorsOrFatalsLabel
to red when an error occurs. Contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Bug 58941
- Create a new Starter that runs thread groups in validation mode (
1
thread only,
1
iteration, no pause all customizable)
Bug 59240
- Introduce a slf4j adapter for Logkit (this allows using slf4j within plugins and core code)
Bug 59153
- Stop test if CSVDataSet is accessing non-existing file. Contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Bug 59320
- Better tooltip in GUI with GenericTestBeanCustomizer (CSV Data Set Config, JDBC Connection Configuration, Keystore Configuration, …) . Based on a patch by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Bug 59171
- Sample Result SaveConfig Dialog is generated in random order
Bug 59425
- Display error about missing help page inside the help pane
Updated to httpclient, httpmime 4.5.2 (from 4.2.6)
Updated to tika-core and tika-parsers 1.12 (from 1.7)
Updated to commons-math3 3.6.1 (from 3.4.1)
Updated to commons-pool2 2.4.2 (from 2.3)
Updated to commons-lang 3.4 (from 3.3.2)
Updated to rhino-1.7.7.1 (from 1.7R5)
Updated to jodd-3.6.7.jar (from 3.6.4)
Updated to jsoup-1.8.3 (from 1.8.1)
Updated to rsyntaxtextarea-2.5.8 (from 2.5.6)
Updated to slf4j-1.7.12 (from 1.7.10)
Updated to xmlgraphics-commons-2.0.1 (from 1.5)
Updated to commons-collections-3.2.2 (from 3.2.1)
Updated to commons-net 3.4 (from 3.3)
Updated to slf4j 1.7.13 (from 1.7.12)
Bug 57981
- Require a minimum of Java 7. Partly contributed by Graham Russell (jmeter at ham1.co.uk)
Bug 58684
- JMeterColor does not need to extend
java.awt.Color
. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58687
- ButtonPanel should die. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58705
- Make
org.apache.jmeter.testelement.property.MultiProperty
iterable. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58729
- Cleanup extras folder for maintainability
Bug 57110
- Fixed spelling+grammar, formatting, removed commented out code etc. Contributed by Graham Russell (jmeter at ham1.co.uk)
Correct instructions on running JMeter in
help.txt
. Contributed by Pascal Schumacher (pascalschumacher at gmx.net)
Bug 58704
- Non regression testing : Ant task batchtest fails if tests and run in a non
en_EN
locale and use a JMX file that uses a CSV DataSet
Bug 58897
- Improve JUnit Test code. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58949
- Cleanup of LDAP code. Based on a patch by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58897
- Improve JUnit Test code. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58967
- Use JUnit categories to exclude tests that need a gui. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59003
- ClutilTestCase
testSingleArg8
and
testSingleArg9
are identical
Bug 59064
- Remove OldSaveService which supported very old Avalon format JTL (result) files
Bug 59165
- RSyntaxTextArea not compatible with headless testing
Bug 59021
- Use
Double#compare
instead of reimplementing it in
NumberProperty#compareTo
Bug 59037
- Drop HtmlParserHTMLParser and dependencies on htmlparser and htmllexer
Bug 58465
- JMS Read response field is badly named and documented
Bug 58601
- Change check for modification of
saveservice.properties
from
SVN Revision ID
to sha1 sum of the file itself.
Bug 58726
- Remove the
jmeterthread.startearlier
parameter. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58784
- Make
JMeterUtils#runSafe
sync/async awt invocation configurable and change the visualizers to use the async version.
Bug 58790
- Issue in CheckDirty and its relation to ActionRouter
Bug 59095
- Remove UserParameterXMLParser that was deprecated eight years ago. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59262
- Add list of binary jars to LICENSE; use that for unit tests
Bug 59353
- Add "Deprecated and removed elements" in "Incompatible changes" part in changes.xml. Contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Bug 57806
- "
audio/x-mpegurl
" mime type is erroneously considered as binary by ViewResultsTree. Contributed by Ubik Load Pack (support at ubikloadpack.com).
Bug 57858
- Don't call
sampleEnd
twice in HTTPHC4Impl when a
RuntimeException
or an
IOException
occurs in the sample method.
Bug 57921
- HTTP/1.1 without keep-alive "
Connection
" response header no longer uses infinite keep-alive.
Bug 57956
- The
hc.parameters
reference in
jmeter.properties
doesn't work when JMeter is not started in
bin
.
Bug 58137
- JMeter fails to download embedded URLs that contain illegal characters in URL (it does not escape them).
Bug 58201
- Make usage of port in the host header more consistent across the different http samplers.
Bug 58453
- HTTP Test Script Recorder :
NullPointerException
when disabling Capture HTTP Headers
Bug 57804
- HTTP Request doesn't reuse cached SSL context when using Client Certificates in HTTPS (only fixed for HttpClient4 implementation)
Bug 58844
- Buttons enable / disable is broken in the arguments panel. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58861
- When clicking on up, down or detail while in a cell of the argument panel, newly added content is lost. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 57935
- SSL SNI extension not supported by HttpClient 4.2.6
Bug 59044
- Http Sampler : It should not be possible to select the multipart encoding if the method is not
POST
. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58881
- HTTP Request : HTTPHC4Impl shows exception when server uses "
deflate
" compression
Bug 58583
- HTTP client fails to close connection if server misbehaves by not sending "
connection: close
", violating HTTP RFC 2616 / RFC 7230
Bug 58950
- NoHttpResponseException
when Pause between samplers exceeds keepalive sent by server
Bug 59085
- Http file panel : data lost on browse cancellation. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 56141
- Application does not behave correctly when using HTTP Recorder. With the help of Dan (java.junkee at yahoo.com)
Bug 59079
- "
httpsampler.max_redirects
" property is not enforced when "
Redirect Automatically
" is used
Bug 58811
- When pasting arguments between http samplers the column "Encode" and "Include Equals" are lost. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Other Samplers
Bug 58013
- Enable all protocols that are enabled on the default SSLContext for usage with the SMTP Sampler.
Bug 58209
- JMeter hang when testing javasampler because
HashMap.put()
is called from multiple threads without sync.
Bug 58301
- Use typed methods such as
setInt
,
setDouble
,
setDate
, … for prepared statement #27
Bug 58851
- Add a dependency on hamcrest-core to allow JUnit tests with annotations to work
Bug 58947
- Connect metric is wrong when
ConnectException
occurs
Bug 58980
- JMS Subscriber will return successful as long as 1 message is received. Contributed by Harrison Termotto (harrison dot termotto at stonybrook.edu)
Bug 59075
- JMS Publisher:
NumberFormatException
is thrown if priority or expiration field is empty
Bug 59345
- SMTPSampler connection leak. Based on a patch by Luca Maragnani (luca dot maragnani at gmail dot com)
Controllers
Bug 58600
- Display correct filenames, when they are searched by IncludeController
Bug 58678
- Module Controller : limit target element selection. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58714
- Module controller : it should not be possible to add a timer as child. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59067
- JMeter fails to iterate over Controllers that are children of a TransactionController having "
Generate parent sample
" checked after an assertion error occurs on a Thread Group with "
Start Next Thread Loop
". Contributed by Benoit Wiart(benoit dot wiart at gmail.com)
Bug 59076
- Test should fail if a module controller cannot find its replacement subtree
Listeners
Bug 58033
- SampleResultConverter should note that it cannot record non-TEXT data
Bug 58845
- Request http view doesn't display all the parameters. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 58413
- ViewResultsTree : Request HTTP Renderer does not show correctly parameters that contain ampersand (&). Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59172
- SampleResult SaveConfig does not allow some fields to be disabled
Bug 58329
- Response Time Graph and Aggregate Graph : Save graph to file does not take into account the settings changed since last click on Graph. Contributed by David Coppens (d.l.coppens at gmail.com)
Bug 58079
- Do not cache HTTP samples that have a
Vary
header when using a HTTP CacheManager.
Bug 58912
- Response assertion gui : Deleting more than 1 selected row deletes only one row. Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Functions
Bug 57825
- __Random function fails if
min
value is equal to
max
value (regression related to
Bug 54453
)
I18N
General
Bug 54826
- Don't fail on long strings in JSON responses when displaying them as JSON in View Results Tree.
Bug 57734
- Maven transient dependencies are incorrect for 2.13 (Fixed group ids for Commons Pool and Math)
Bug 57731
- TESTSTART.MS
has always the value of the first Test started in Server mode in NON GUI Distributed testing
Bug 58016
- Error type casting using external SSL Provider. Contributed by Kirill Yankov (myworkpostbox at gmail.com)
Bug 57821
- Command-line option "
-X --remoteexit
" doesn't work since 2.13 (regression related to
Bug 57500
)
Bug 58795
- NPE may occur in
GuiPackage#getTestElementCheckSum
with some 3
rd
party plugins
Bug 58913
- When closing JMeter should not interpret cancel as "
destroy my test plan
". Contributed by Benoit Wiart (benoit dot wiart at gmail.com)
Bug 59096
- Search Feature : Case insensitive search is not really case insensitive
Bug 59193
- ant run_gui
fails with
ClassNotFoundException
or
IllegalAccessError
when accessing classes from dependencies not loaded through
Thread.currentThread().getContextClassLoader()
Bug 59225
- Bad display of running indicator icon. Contributed by Antonio Gomes Rodrigues (ra0077 at gmail.com)
Florent Sabbe (f dot sabbe at ubik-ingenierie.com)
Antonio Gomes Rodrigues (ra0077 at gmail.com)
Harrison Termotto (harrison dot termotto at stonybrook.edu
Denis Kirpichenkov (denis.kirpichenkov at gmail.com)
Gary Gregory (ggregory at apache.org)
David Coppens (d.l.coppens at gmail.com)
Luca Maragnani (luca dot maragnani at gmail dot com)
Philip Helger (http://www.helger.com) for his
CSS Parser
and for taking into account our bug reports very rapidly
Irek Pastusiak (the.automatic.tester at gmail.com)
We also thank bug reporters who helped us improve JMeter.
For this release we want to give special thanks to the following reporters for the clear reports and tests made after our fixes:
purnasatyap at gmail dot com for the tests and reports on nightly build
Sergey Batalin (sergey_batalin at mail dot ru) for the tests and reports on nightly build
Vincent Daburon (vdaburon at gmail dot com) for the tests and reports on nightly build
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 there is a
bug in Java
on some Linux systems that manifests itself as the following error when running the test cases or JMeter itself:
[java] WARNING: Couldn't flush user prefs:
java.util.prefs.BackingStoreException:
java.lang.IllegalArgumentException: Not supported: indent-number
This does not affect JMeter operation. This issue is fixed since Java 7b05.
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.
With Oracle Java 7 and Mac Book Pro Retina Display, the JMeter GUI may look blurry.
This is a known Java bug, see Bug
JDK-8000629
.
A workaround is to use a Java 7 update 40 runtime which fixes this issue.
You may encounter the following error:
java.security.cert.CertificateException: Certificates does not conform to algorithm constraints
if 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 7 version u16 (MD2) and version u40 (Certificate size lower than 1024 bits), and Java 8 too.
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:
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 JDK7_u79, 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.
New Async BackendListener with Graphite implementation
A new Async BackendListener has been added to allow sending result data to a backend listener.
JMeter ships with a GraphiteBackendListenerClient that allows sending results to a
Graphite
server using Pickle or Plaintext protocols.
You can implement your own backend by extending
AbstractBackendListenerClient
. This backend could be
a database (JDBC), a Message Oriented Middleware (JMS), a Webservice or anything you want.
This is the kind of Live Dashboard you can obtain using
Grafana
and
InfluxDB
Read
this
for more details.
Grafana dashboard
Core Improvements
New connect time metric
Starting with this version a new metric called connectTime has been added. It represents the time to establish connection.
By default it is not saved to CSV or XML, to have it saved add to user.properties:
jmeter.save.saveservice.connect_time=true
Aggregate Graph and Report
The listeners Aggregate Graph and Aggregate Report previously showed only the 90 percentile (historical behavior), the 95 percentile and the 99 percentile have been added and are customizable.
To setup the percentiles value you want, add to user.properties:
aggregate_rpt_pct1=90
aggregate_rpt_pct2=95
aggregate_rpt_pct3=99
HTTP(S) Test Script Recorder
Now component is able to detect authentication schemes and automatically adds a pre-configured HTTP Authorization Manager with the correct Mechanism.
HTTP Request
The CalDAV verbs (Calendar extensions to WebDAV) REPORT and MKCALENDAR have been added in the HTTP Request sampler.
JDBC Request
The ResultSet can be get as a object, this allows to handle more easily the results after in BeanShell, JSR223 scripts, …
Distributed Testing
To allow better usage of Distributed Testing in the cloud, retry behaviour has been added when starting test on servers.
Read
this
for more details.
Distributed Testing performance
Since JMeter 2.13, Stripping modes (StrippingBatch being the default mode) now also strip responses from SubResults improving consumed network bandwidth.
Documentation refresh
A new style for website (responsive and more up to date) has been created by Felix Schumacher.
Documentations have been refreshed particularly:
The Module Controller now shows the target controller in a tree view (instead of combo list).
Toolbar
JMeter's toolbar has been refreshed for some icons (start, toggle, etc.). Three sizes are now available for the icons: 22x22, 32x32 and 48x48.
The property to define your preferred size is:
jmeter.toolbar.icons.size=value
with the value 22x22 (default size), 32x32 or 48x48.
The toolbar with 22x22 pixels icons
The toolbar with 32x32 pixels icons
The toolbar with 48x48 pixels icons
HTTP(S) Test Script Recorder
If your Test Plan does not contains a Recording Controller, a new warning message will appear if the
HTTP(S) Test Script Recorder is configured to send the samples into a Recording Controller.
Since 2.13, Aggregate Graph, Summary Report and Aggregate Report now export percentages to %, before they exported the decimal value which differed from what was shown in GUI
Third party plugins may be impacted by fix of
Bug 57586
, ensure that your subclass of HttpTestSampleGui implements ItemListener if you relied on parent class doing so.
Report package has been removed,
ApacheJMeter_report.jar
is not generated anymore as a consequence, see
Bug 57269
Bug 25430
- HTTP(S) Test Script Recorder : Make it populate HTTP Authorization Manager. Partly based on a patch from Dzmitry Kashlach (dzmitrykashlach at gmail.com)
Bug 57381
- HTTP(S) Test Script Recorder should display an error if Target Controller references a Recording Controller and no Recording Controller exists. Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 57565
- SamplerCreator : Add method to allow implementations to add children to created sampler
Bug 57606
- HTTPSamplerBase#errorResult changes the sample label on exception
Bug 57613
- HTTP Sampler : Added CalDAV verbs (REPORT, MKCALENDAR). Contributed by Richard Brigham (richard.brigham at teamaol.com)
Bug 48799
- Add time to establish connection to available sample metrics. Implemented by Andrey Pokhilko (andrey at blazemeter.com) and contributed by BlazeMeter Ltd. and Pieter Ennes (apache.org at spam.ennes.nl)
Bug 57500
- Introduce retry behavior for distributed testing. Implemented by Andrey Pokhilko and Dzimitry Kashlach and contributed by BlazeMeter Ltd.
Other samplers
Bug 57322
- JDBC Test elements: add ResultHandler to deal with ResultSets(cursors) returned by callable statements. Contributed by Yngvi Þór Sigurjónsson (blitzkopf at gmail.com)
Controllers
Bug 57561
- Module controller UI : Replace combobox by tree. Contributed by Maciej Franek (maciej.franek at gmail.com)
Bug 57648
- TestFragment should be disabled when created. Contributed by Ubik Load Pack (support at ubikloadpack.com)
Listeners
Bug 55932
- Create a Async BackendListener to allow easy plug of new listener (Graphite, JDBC, Console, …)
Bug 57246
- BackendListener : Create a Graphite implementation
Bug 57217
- Aggregate graph and Aggregate report improvements (3 configurable percentiles, same data in both, factor out code). Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 57537
- BackendListener : Allow implementations to drop samples
Bug 57385
- Getting empty thread name in xml result for HTTP requests with "Follow Redirects" set. Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 57579
- NullPointerException error is raised on main sample if "RETURN_NO_SAMPLE" is used (default) and "Use Cache-Control / Expires header…" is checked in HTTP Cache Manager
Other Samplers
Controllers
Bug 57447
- Use only the user listed DNS Servers, when "use custom DNS resolver" option is enabled.
Listeners
Bug 57262
- Aggregate Report, Aggregate Graph and Summary Report export : headers use keys instead of labels
Bug 57346
- Summariser : The + (difference) reports show wrong elapsed time and throughput
Bug 57449
- Distributed Testing: Stripped modes do not strip responses from SubResults (affects load tests that use Download of embedded resources). Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 57562
- View Results Tree CSS/JQuery Tester : Nothing happens when there is an error in syntax and an exception occurs in jmeter.log
Bug 57514
- Aggregate Graph, Summary Report and Aggregate Report show wrong percentage reporting in saved file
Bug 57607
- Constant Throughput Timer : Wrong throughput computed in shared modes due to rounding error
General
Bug 57365
- Selected LAF is not correctly setup due to call of
UIManager.setLookAndFeel
too late. Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 57364
- Options < Look And Feel does not update all windows LAF. Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 57394
- When constructing an instance with ClassTools#construct(String, int) the integer was ignored and the default constructor was used instead.
Bug 57440
- OutOfMemoryError after introduction of JSyntaxTextArea in LoggerPanel due to disableUndo not being taken into account.
Bug 57569
- FileServer.reserveFile - inconsistent behaviour when hasHeader is true
Bug 57555
- Cannot use JMeter 2.12 as a maven dependency. Contributed by Pascal Schumacher (pascal.schumacher at t-systems.com)
Bug 57608
- Fix start script compatibility with old Unix shells, e.g. on Solaris
Pascal Schumacher (pascal.schumacher at t-systems.com)
Maciej Franek (maciej.franek at gmail.com)
Richard Brigham (richard.brigham at teamaol.com)
Pieter Ennes (apache.org at spam.ennes.nl)
We also thank bug reporters who helped us improve JMeter.
For this release we want to give special thanks to the following reporters for the clear reports and tests made after our fixes:
Chaitanya Bhatt (bhatt.chaitanya at gmail.com) for his thorough testing of new BackendListener and Graphite Client implementation.
Marcelo Jara (marcelojara at hotmail.com) for his clear report on
Bug 57607
.
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 there is a
bug in Java
on some Linux systems that manifests itself as the following error when running the test cases or JMeter itself:
[java] WARNING: Couldn't flush user prefs:
java.util.prefs.BackingStoreException:
java.lang.IllegalArgumentException: Not supported: indent-number
This does not affect JMeter operation. This issue is fixed since Java 7b05.
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.
With Java 1.6 and Gnome 3 on Linux systems, the JMeter menu may not work correctly (shift between mouse's click and the menu).
This is a known Java bug (see
Bug 54477
).
A workaround is to use a Java 7 runtime (OpenJDK or Oracle JDK).
With Oracle Java 7 and Mac Book Pro Retina Display, the JMeter GUI may look blurry.
This is a known Java bug, see Bug
JDK-8000629
.
A workaround is to use a Java 7 update 40 runtime which fixes this issue.
You may encounter the following error:
java.security.cert.CertificateException: Certificates does not conform to algorithm constraints
if 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 7 version u16 (MD2) and version u40 (Certificate size lower than 1024 bits), and Java 8 too.
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:
The Critical Section Controller allow to serialize the execution of a section in your tree.
Only one instance of the section will be executed at the same time during the test.
DNS Cache Manager
The new configuration element
DNS Cache Manager
(see
Bug 56841
) improves the testing of:
CDN (Content Delivery Network)
DNS load balancing.
Load Balancers like Amazon Elastic Load Balancer
Core Improvements
Smarter Recording of Http Test Plans
Test Script Recorder has been improved in many ways
Better matching of Variables in Requests, making Test Script Recorder variabilize your sampler during recording more versatile
Ability to filter from View Results Tree the Samples that are excluded from recording, this lets you concentrate on recorded Samplers analysis and not bother with useless Sample Results
Better defaults for recording, since this version Recorder will number created Samplers letting you find them much easily in View Results Tree.
Grouping of Samplers under Transaction Controller will be smarter making all requests emitted by a web page be children as new Transaction Controller
Support of Webdav requests
You can now test against WebDav server using HttpClient4 Implementation of Http Request
Better handling of embedded resources
When download embedded resources is checked, JMeter now uses User Agent header to download or not resources embedded within conditional comments as per
About conditional comments
.
Ability to customize Cache Manager (Browser cache simulation) handling of cached resources
You can now configure the behaviour of JMeter when a resource is found in Cache, this can be controlled with
cache_manager.cached_resource_mode
property
JMS Publisher / JMS Point-to-Point
Add JMSPriority and JMSExpiration fields for these samplers.
Mail Reader Sampler
You can now specify the number of messages that want you retrieve (before all messages were retrieved).
In addition, you can fetch only the message header now.
SMTP Sampler
Adding the Connection timeout and the Read timeout to the
SMTP Sampler.
Synchronizing Timer
Adding a timeout to define the maximum time to waiting of the group of virtual users.
Performance improvements
A big improvement in performances of Functions has been made by lifting useless synchronization. It concerns all functions except __StringFromFile, __XPath and __BeanShell, see
Bug 57114
__jexl2 performances have been improved to avoid contention point, see
Bug 56708
GUI Improvements
Undo/Redo support
Undo / Redo has been introduced and allows user to undo/redo changes made on Test Plan Tree. This feature (ALPHA MODE) is disabled by default, to enable it set property
undo.history.size=25
View Results Tree
Improve the ergonomics of View Results Tree by changing placement of Renderers and allowing custom ordering
(with the property
view.results.tree.renderers_order
).
Response Time Graph
Adding the ability for the
Response Time Graph
listener to save/restore format its settings in/from the jmx file.
Log Viewer
Starting with this version, the last lines of JMeter's log file (jmeter.log) can be viewed directly in GUI by clicking on Warning icon in the upper right corner.
This will unfold the Log Viewer panel and show logs.
File Opening
Now, "Open File dialog" uses last opened file folder as start folder, see
Bug 52707
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 there is a
bug in Java
on some Linux systems that manifests itself as the following error when running the test cases or JMeter itself:
[java] WARNING: Couldn't flush user prefs:
java.util.prefs.BackingStoreException:
java.lang.IllegalArgumentException: Not supported: indent-number
This does not affect JMeter operation. This issue is fixed since Java 7b05.
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.
With Java 1.6 and Gnome 3 on Linux systems, the JMeter menu may not work correctly (shift between mouse's click and the menu).
This is a known Java bug (see
Bug 54477
).
A workaround is to use a Java 7 runtime (OpenJDK or Oracle JDK).
With Oracle Java 7 and Mac Book Pro Retina Display, the JMeter GUI may look blurry.
This is a known Java bug, see Bug
JDK-8000629
.
A workaround is to use a Java 7 update 40 runtime which fixes this issue.
You may encounter the following error:
java.security.cert.CertificateException: Certificates does not conform to algorithm constraints
if 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 7 version u16 (MD2) and version u40 (Certificate size lower than 1024 bits), and Java 8 too.
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:
Since JMeter 2.12, active threads in all thread groups and active threads in current thread group are saved by default to CSV or XML results, see
Bug 57025
.
This is usually the expected behaviour as you want to have the number of running threads during the test. But if you want to revert to previous behaviour, set property
jmeter.save.saveservice.thread_counts=false
Since JMeter 2.12, Mail Reader Sampler will show 1 for number of samples instead of number of messages retrieved, see
Bug 56539
Since JMeter 2.12, when using Cache Manager, if resource is found in cache no SampleResult will be created, in previous version a SampleResult with empty content and 204 return code was returned, see
Bug 54778
.
You can choose between different ways to handle this case, see
cache_manager.cached_resource_mode
in
jmeter.properties
.
Since JMeter 2.12, Log Viewer will no more clear logs when closed and will have logs available even if closed. See
Bug 56920
. Read
Hints and Tips > Enabling Debug logging
for details on configuring this component.
Bug 55998
- HTTP recording – Replacing port value by user defined variable does not work
Bug 56178
- keytool error: Invalid escaped character in AVA: - some characters must be escaped
Bug 56222
- NPE if jmeter.httpclient.strict_rfc2616=true and location is not absolute
Bug 56263
- DefaultSamplerCreator should set BrowserCompatible Multipart true
Bug 56231
- Move redirect location processing from HC3/HC4 samplers to HTTPSamplerBase#followRedirects()
Bug 56207
- URLs get encoded on redirects in HC3.1 & HC4 samplers
Bug 56303
- The width of target controller's combo list should be set to the current panel size, not on label size of the controllers
Bug 54778
- HTTP Sampler should not return 204 when resource is found in Cache, make it configurable with new property cache_manager.cached_resource_mode
Bug 55999
- Scroll bar on jms point-to-point sampler does not work when content exceeds display
Bug 56198
- JMSSampler : NullPointerException is thrown when JNDI underlying implementation of JMS provider does not comply with
Context.getEnvironment
contract
Bug 56428
- MailReaderSampler - should it use mail.pop3s.* properties?
Bug 46932
- Alias given in select statement is not used as column header in response data for a JDBC request. Based on report and analysis of Nicola Ambrosetti
Bug 56539
- Mail reader sampler: When Number of messages to retrieve is superior to 1, Number of samples should only show 1 not the number of messages retrieved
Bug 56809
- JMSSampler closes InitialContext too early. Contributed by Bradford Hovinen (hovinen at gmail.com)
Bug 56761
- JMeter tries to stop already stopped JMS connection and displays "The connection is closed"
Bug 57068
- No error thrown when negative duration is entered in Test Action
Bug 57078
- LagartoBasedHTMLParser fails to parse page that contains input with no type
Bug 57183
- JMSSampler: For input string: "" java.lang.NumberFormatException (for Expiration or Priority fields)
Controllers
Bug 56243
- Foreach works incorrectly with indexes on subsequent iterations
Bug 56276
- Loop controller becomes broken once loop count evaluates to zero
Bug 56160
- StackOverflowError when using WhileController within IfController
Bug 56811
- "Start Next Thread Loop" in Result Status Action Handler or on Thread Group and "Go to next Loop iteration" in Test Action behave incorrectly with TransactionController that has "Generate Parent Sampler" checked
Listeners
Bug 56706
- SampleResult#getResponseDataAsString() does not use encoding in response body impacting PostProcessors and ViewResultsTree. Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 57052
- ArithmeticException: / by zero when sampleCount is equal to 0
Bug 55959
- Improve error message when Test Script Recorder fails due to I/O problem
Bug 52013
- Test Script Recorder's Child View Results Tree does not take into account Test Script Recorder excluded/included URLs. Based on report and analysis of James Liang
Bug 56119
- File uploads fail every other attempt using timers. Enable idle timeouts for servers that don't send Keep-Alive headers.
Bug 56272
- MirrorServer should support query parameters for status and redirects
Bug 57026
- HTTP(S) Test Script Recorder : Better default settings. Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 57107
- Patch proposal: Add DAV verbs to HTTP Sampler. Contributed by Philippe Jung (apache at famille-jung.fr)
Bug 56357
- Certificates does not conform to algorithm constraints: Adding a note to indicate how to remove of the Java installation these new security constraints
Other samplers
Bug 56033
- Add Connection timeout and Read timeout to SMTP Sampler
Bug 56429
- MailReaderSampler - no need to fetch all Messages if not all wanted
Bug 56427
- MailReaderSampler enhancement: read message header only
Bug 56510
- JMS Publisher/Point to Point: Add JMSPriority and JMSExpiration
Controllers
Bug 56728
- New Critical Section Controller to serialize blocks of a Test. Based partly on a patch contributed by Mikhail Epikhin(epihin-m at yandex.ru)
Bug 57145
- RandomController : Use ThreadLocalRandom instead of Random for better performances
Listeners
Bug 56228
- View Results Tree : Improve ergonomy by changing placement of Renderers and allowing custom ordering
Bug 56349
- "summary" is a bad name for a Generate Summary Results component, documentation clarified
Bug 56769
- Adds the ability for the Response Time Graph listener to save/restore format settings in/from the jmx file
Bug 57025
- SaveService : Better defaults, save thread counts by default
Bug 56691
- Synchronizing Timer : Add timeout on waiting
Bug 56701
- HTTP Authorization Manager/ Kerberos Authentication: add port to SPN when server port is neither 80 nor 443. Based on patches from Dan Haughey (dan.haughey at swinton.co.uk) and Felix Schumacher (felix.schumacher at internetallee.de)
Bug 56841
- New configuration element: DNS Cache Manager to improve the testing of CDN. Based on patch from Dzmitry Kashlach (dzmitrykashlach at gmail.com), and contributed by BlazeMeter Ltd.
Bug 52061
- Allow access to Request Headers in Regex Extractor. Based on patch from Dzmitry Kashlach (dzmitrykashlach at gmail.com), and contributed by BlazeMeter Ltd.
Functions
Bug 56708
- __jexl2 doesn't scale with multiple CPU cores. Based on analysis and patch contributed by Mikhail Epikhin(epihin-m at yandex.ru)
Bug 57114
- Performance : Functions that only have values as instance variable should not synchronize execute. Based on analysis by Ubik Load Pack support and Vladimir Sitnikov, patch contributed by Vladimir Sitnikov (sitnikov.vladimir at gmail.com)
I18N
General
Bug 21695
- Unix jmeter start script assumes it is on PATH, not a link
Bug 56292
- Add the check of the Java's version in startup files and disable some options when is Java v8 engine
Bug 56298
- JSR223 language display does not show which engine will be used
Bug 56455
- Batch files: drop support for non-NT Windows shell scripts
Bug 52707
- Make Open File dialog use last opened file folder as start folder. Based on patch from Dzmitry Kashlach (dzmitrykashlach at gmail.com), and contributed by BlazeMeter Ltd.
Bug 56807
- Ability to force flush of ResultCollector file. Contributed by Andrey Pohilko (apc4 at ya.ru)
Bug 56921
- Templates : Improve Recording template to ignore embedded resources case and URL parameters. Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 42248
- Undo-redo support on Test Plan tree modification. Developed by Andrey Pohilko (apc4 at ya.ru) and contributed by BlazeMeter Ltd. Additional contribution by Ubik Load Pack (support at ubikloadpack.com)
Bug 56920
- LogViewer : Make it receive all log events even when it is closed. Contributed by Ubik Load Pack (support at ubikloadpack.com)
Bug 57083
- simplified the CachedResourceMode enum. Contributed by Graham Russel (graham at ham1.co.uk)
Bug 57082
- ComboStringEditor : Added hashCode to an inner class which overwrote equals. Contributed by Graham Russel (graham at ham1.co.uk)
Bug 57081
- Updating checkstyle to only check for tabs in java, xml, xsd, dtd, htm, html and txt files (not images!). Contributed by Graham Russell (graham at ham1.co.uk)
Bug 56178
- Really replace backslashes in user name before generating proxy certificate. Contributed by Graham Russel (graham at ham1.co.uk)
Bug 57084
- Close socket after usage in BeanShellClient. Contributed by Graham Russel (graham at ham1.co.uk)
Vladimir Sitnikov (sitnikov.vladimir at gmail.com)
We also thank bug reporters who helped us improve JMeter.
For this release we want to give special thanks to the following reporters for the clear reports and tests made after our fixes:
Oliver LLoyd (email at oliverlloyd.com) for his help on
Bug 56119
Vladimir Ryabtsev (greatvovan at gmail.com) for his help on
Bug 56243
and
Bug 56276
Adrian Speteanu (asp.adieu at gmail.com) and Matt Kilbride (matt.kilbride at gmail.com) for their feedback and tests on
Bug 54648
Shmuel Krakower (shmulikk at gmail.com) for his tests and reports on Undo/Redo feature
Following improvements have been made since major changes introduced in JMeter 2.10 on HTTP(S) Test Script Recorder:
Better detection of missing or invalid configuration of keytool utility
New system property
keytool.directory
(see
system.properties
) lets you configure directory containing keytool in case on non-standard installation
JMS Publisher/Point to Point : Add ability to set typed values in JMS header properties
In the samplers JMS Publisher and JMS Point-to-Point, you can now set up the class of values for the JMS header properties. Previously only String was possible.
View Results Tree : Add an XPath Tester
In View Results Tree listener, a new XPath tester can be used to test XPATH expressions.
Ability to choose the client alias for the cert key in JsseSslManager such that Mutual SSL auth testing can be made more flexible
When testing client based certificate authentications you have now better control on certificate you use through a new field "Variable name holding certificate alias", this
field lets you select the certificate you want to send to server to authenticate. You can use a CSV Data Set as a holder for the variable value.
Add a "Save as Test Fragment" option
In the file menu, a new option allow to save a group of elements as a Test fragment.
Summariser is be enabled by default in Non GUI mode
When you run JMeter from command line, now JMeter displays some statistics from the Summariser mode.
Transaction Controller:Change default property "Include duration of timer…" for newly created element
Starting from 2.11, Transaction Controller is configured by default to exclude processing time of pre/post processors as long as timers pause.
The Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
Listeners don't show iteration counts when a If Controller has a condition which is always false from the first iteration (see
Bug 52496
).
A workaround is to add a sampler at the same level as (or superior to) the If Controller.
For example a Test Action sampler with 0 wait time (which doesn't generate a sample),
or a Debug Sampler with all fields set to False (to reduce the sample size).
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 there is a
bug in Java
on some Linux systems that manifests itself as the following error when running the test cases or JMeter itself:
[java] WARNING: Couldn't flush user prefs:
java.util.prefs.BackingStoreException:
java.lang.IllegalArgumentException: Not supported: indent-number
This does not affect JMeter operation. This issue is fixed since Java 7b05.
With Java 1.6 and Gnome 3 on Linux systems, the JMeter menu may not work correctly (shift between mouse's click and the menu).
This is a known Java bug (see
Bug 54477
).
A workaround is to use a Java 7 runtime (OpenJDK or Oracle JDK).
With Oracle Java 7 and Mac Book Pro Retina Display, the JMeter GUI may look blurry.
This is a known Java bug, see Bug
JDK-8000629
.
A workaround is to use a Java 7 update 40 runtime which fixes this issue.
When creating a new Transaction Controller, property "Include duration of timer and pre-post processors in generated sample" will be unchecked starting from version 2.11
In Non GUI mode, since 2.11 summariser is enabled with a 30 seconds frequency
JMeter is more lenient with redirect handling and relaxes on RFC2616 by allowing relative locations. See property "
jmeter.httpclient.strict_rfc2616
" in
jmeter.properties
to change this behaviour, see
Bug 55717
When creating a new Response Assertion, property "Pattern Matching Rules" now defaults to Substring starting from version 2.11
Bug 55871
- Wrong result with intSum() function when a space character is present before/after the number. Contributed by Milamber based on a proposal by James Liang.
I18N
General
Bug 55739
- Remote Test : Total threads in GUI mode shows invalid total number of threads
Bug 55908
- Response assertion : Change Pattern Matching Rules default to Substring on creation for better performances
Bug 54977
- Ability to choose the client alias for the cert key in JsseSslManager such that Mutual SSL auth testing can be made more flexible. Contributed by UBIK Load Pack (support at ubikloadpack.com)
Bug 55753
- Improve FilePanel behaviour to start from the value set in Filename field if any. Contributed by UBIK Load Pack (support at ubikloadpack.com)
Bug 55756
- HTTP Mirror Server : Add ability to set Headers
Bug 55852
- Be more lenient in parsing when charset value is surrounded with single quotes
Bug 55857
- Performance : AbstractProperty should test for emptiness to avoid Exception throwing
Bug 55858
- Startup Performance : On Startup, BeanInfoSupport should test for key availability instead of throwing
Bug 55865
- Performance :Disable stale check by default in HttpClient 4 and 3.1
Bug 55512
- Summariser should be enabled by default in Non GUI mode
We thank all contributors mentioned in bug and improvement sections above:
James Liang (jliang at andera.com)
UBIK Load Pack (support at ubikloadpack.com)
We also thank bug reporters who helped us improve JMeter.
For this release we want to give special thanks to the following reporters for the clear reports and tests made after our fixes:
A Huge performance improvement has been made on High Throughput Tests (no pause), see
Bug 54777
An issue with unnecessary SSL Context reset has been fixed which improves performances of pure HTTP tests, see
Bug 55023
Important performance improvement in parsing of Embedded resource in HTML pages thanks to a switch to JODD/Lagarto HTML Parser, see
Bug 55632
New CSS/JQuery Tester in View Tree Results
A new CSS/JQuery Tester in View Tree Results that makes CSS/JQuery Extractor a first class
citizen in JMeter, you can now test your expressions very easily
Many improvements in HTTP(S) Recording have been made
The "HTTP Proxy Server" test element has been renamed as "HTTP(S) Test Script Recorder".
Better recording of HTTPS sites, embedded resources using subdomains will more easily be recorded when using JDK 7. See
Bug 55507
.
See updated documentation:
HTTP(S) Test Script Recorder
Redirection are now more smartly detected by HTTP Proxy Server, see
Bug 55531
You can now load test MongoDB through new MongoDB Source Config
Kerberos authentication has been added to Auth Manager
Device can now be used in addition to source IP address
You can now do functional testing of MongoDB scripts through new MongoDB Script
Timeout has been added to OS Process Sampler
Query timeout has been added to JDBC Request
New functions (__urlencode and __urldecode) are now available to encode/decode URL encoded chars
Continuous Integration is now eased by addition of a new flag that forces NON-GUI JVM to exit after test end
See jmeter property:
jmeterengine.force.system.exit
HttpSampler now allows DELETE Http Method to have a body (works for HC4 and HC31 implementations). This allows for example to test Elastic Search APIs
2 implementations of HtmlParser have been added to improve Embedded resources parsing
You can choose the implementation to use for parsing Embedded resources in HTML pages:
See jmeter.properties and look at property "htmlParser.className".
org.apache.jmeter.protocol.http.parser.LagartoBasedHtmlParser for optimal performances
org.apache.jmeter.protocol.http.parser.JSoupBasedHtmlParser for most accurate parsing and functional testing
Distributed testing has been improved
Number of threads on each node are now reported to controller.
Performance improvement on BatchSampleSender(
Bug 55423
)
Addition of 2 SampleSender modes (StrippedAsynch and StrippedDiskStore), see jmeter.properties
ModuleController has been improved to better handle changes to referenced controllers
Improved class loader configuration, see
New property "plugin_dependency_paths" for plugin dependencies
Properties "search_paths", "user.classpath" and "plugin_dependency_paths"
now automatically add all jars from configured directories
Best-practices section has been improved, ensure you read it to get the most out of JMeter
New Templates feature that allows you to create test plan from existing template or merge
template into your Test Plan
Workbench can now be saved
Syntax color has been added to scripts elements (BeanShell, BSF, and JSR223), MongoDB and JDBC elements making code much more readable and allowing UNDO/REDO through CTRL+Z/CTRL+Y
BSF Sampler with syntax color
JSR223 Pre Processor with syntax color
Better editors are now available for Test Elements with large text content, like HTTP Sampler, and JMS related Test Element providing line numbering and allowing UNDO/REDO through CTRL+Z/CTRL+Y
JMeter GUI can now be fully Internationalized, all remaining issues have been fixed
Currently French has all its labels translated. Other languages are partly translated, feel free to
contribute translations by reading
Localisation (Translator's Guide)
Moving elements in Test plan has been improved in many ways
Drag and drop of elements in Test Plan tree is now much easier and possible on multiple nodes
Note that due to this
bug in Java
,
you cannot drop a node after last node. The workaround is to drop it before this last node and then Drag and Drop the last node
before the one you just dropped.
New shortcuts have been added to move elements in the tree.
(alt + Arrow Up) and (alt + Arrow Down) move the element within the parent node
(alt + Arrow Left) and (alt + Arrow Right) move the element up and down in the tree depth
Response Time Graph Y axis can now be scaled
JUnit Sampler gives now more details on configuration errors
The Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
Listeners don't show iteration counts when a If Controller has a condition which is always false from the first iteration (see
Bug 52496
).
A workaround is to add a sampler at the same level as (or superior to) the If Controller.
For example a Test Action sampler with 0 wait time (which doesn't generate a sample),
or a Debug Sampler with all fields set to False (to reduce the sample size).
Webservice sampler does not consider the HTTP response status to compute the status of a response, thus a response 500 containing a non empty body will be considered as successful, see
Bug 54006
.
To workaround this issue, ensure you always read the response and add a Response Assertion checking text inside the response.
The numbers that appear to the left of the green box are the number of active threads / total number of threads,
these only apply to a locally run test; they do not include any threads started on remote systems when using client-server mode, (see
Bug 54152
).
Note that there is a
bug in Java
on some Linux systems that manifests itself as the following error when running the test cases or JMeter itself:
[java] WARNING: Couldn't flush user prefs:
java.util.prefs.BackingStoreException:
java.lang.IllegalArgumentException: Not supported: indent-number
This does not affect JMeter operation. This issue is fixed since Java 7b05.
With Java 1.6 and Gnome 3 on Linux systems, the JMeter menu may not work correctly (shift between mouse's click and the menu).
This is a known Java bug (see
Bug 54477
).
A workaround is to use a Java 7 runtime (OpenJDK or Oracle JDK).
With Oracle Java 7 and Mac Book Pro Retina Display, the JMeter GUI may look blurry.
This is a known Java bug, see Bug
JDK-8000629
.
A workaround is to use a Java 7 update 40 runtime which fixes this issue.
SMTP Sampler
now uses eml file subject if subject field is empty
With this version autoFlush has been turned off on PrintWriter in charge of writing test results.
This results in improved throughput for intensive tests but can result in more test data loss in case
of JMeter crash (extremely rare). To revert to previous behaviour set
jmeter.save.saveservice.autoflush
property to
true
.
Shortcut for
Function Helper Dialog
is now
CTRL+SHIFT+F1 (CMD + SHIFT + F1 for Mac OS)
.
The original key sequence
(Ctrl+F1)
did not work in some locations (it is consumed by the Java Swing ToolTipManager).
It was therefore necessary to change the shortcut.
Webservice (SOAP) Request
has been removed by default from GUI as Element is deprecated. (Use
HTTP Request
with
Body Data
, see also the Template
Building a SOAP Webservice Test Plan
), if you need to show it, see property
not_in_menu
in
jmeter.properties
Transaction Controller
now sets
Response Code
of
Generated Parent Sampler
(if
Generated Parent Sampler
is checked) to response code of first failing child in case of failure of one of the children, in previous versions
Response Code
was empty.
In previous versions,
IncludeController
could run Test Elements located inside a
Thread Group
, this behaviour (
which was not documented
)
could result in weird behaviour, it has been removed in this version (see
Bug 55464
).
The correct way to include Test Elements is to use
Test Fragment
as stated in documentation of
Include Controller
.
The retry count for the HttpClient 3.1 and HttpClient 4.x samplers has been changed to
0
.
Previously the default was 1, which could cause unexpected additional traffic.
Starting with this version, the
HTTP(S) Test Script Recorder
tries to detect when a sample is the result of a previous
redirect. If the current response is a redirect, JMeter will save the redirect URL. When the next request is received,
it is compared with the saved redirect URL and if there is a match, JMeter will disable the generated sample.
To revert to previous behaviour, set the property
proxy.redirect.disabling=false
Starting with this version, in
HTTP(S) Test Script Recorder
if Grouping is set to
Put each group in a new Transaction Controller
,
the Recorder will create
Transaction Controller
instances with
Include duration of timer and pre-post processors in generated sample
set
to false. This default value reflect more accurately response time.
__escapeOroRegexpChars
function (which escapes ORO reserved characters) no longer trims the value (see
Bug 55328
)
The
commons-lang-2.6.jar
has been removed from embedded libraries in
jmeter/lib
folder as it is not needed by JMeter at run-time
(it is only used by Apache Velocity for generating documentation).
If you use any plugin or third-party code that depends on it, you need to add it in
jmeter/lib
folder
Bug 55455
- HTTPS with HTTPClient4 ignores cps setting
Bug 55502
- Proxy generates empty http:/ entries when recording
Bug 55504
- Proxy incorrectly issues CONNECT requests when browser prompts for certificate override
Bug 55506
- Proxy should deliver failed requests to any configured Listeners
Bug 55545
- HTTP Proxy Server GUI should not allow both Follow and Auto redirect to be selected
Other Samplers
Bug 54913
- JMSPublisherGui incorrectly restores its state. Contributed by Benoit Wiart (benoit.wiart at gmail.com)
Bug 55027
- Test Action regression, duration value is not recorded (nightly build).
Bug 55163
- BeanShellTestElement fails to quote string when calling testStarted(String)/testEnded(String).
Bug 55349
- NativeCommand hangs if no input file is specified and the application requests input.
Bug 55462
- System Sampler should not change the sampler label if a sample fails
Controllers
Bug 54467
- Loop Controller: compute loop value only once per parent iteration.
Bug 54985
- Make Transaction Controller set Response Code of Generated Parent Sampler to response code of first failing child in case of failure of one of its children. Contributed by Mikhail Epikhin (epihin-m at yandex.ru)
Bug 54950
- ModuleController : Changes to referenced Module are not taken into account if changes occur after first run and referenced node is disabled.
Bug 55201
- ForEach controller excludes start index and includes end index (clarified documentation).
Bug 55334
- Adding Include Controller to test plan (made of Include Controllers) without saving TestPlan leads to included code not being taken into account until save.
Bug 55375
- StackOverflowError with ModuleController in Non-GUI mode if its name is the same as the target node.
Bug 55464
- Include Controller running included thread group
Listeners
Bug 54589
- View Results Tree have a lot of Garbage characters if html page uses double-byte charset.
Bug 54753
- StringIndexOutOfBoundsException at SampleResult.getSampleLabel() if key_on_threadname=false when using Statistical mode.
Bug 54685
- ArrayIndexOutOfBoundsException if "sample_variable" is set in client but not server.
Bug 55111
- ViewResultsTree: text not refitted if vertical scrollbar is required. Contributed by Milamber
Bug 55600
- JSyntaxTextArea : Strange behaviour on first undo
Bug 55655
- NullPointerException when Remote stopping /shutdown all if one engine did not start correctly. Contributed by UBIK Load Pack (support at ubikloadpack.com)
Bug 55657
- Remote and Local Stop/Shutdown buttons state does not take into account local / remote status
HTTP Request: Small user interaction improvements in Row parameter Detail Box. Contributed by Milamber
Bug 55255
- Allow Body in HTTP DELETE method to support API that use it (like ElasticSearch).
Bug 53480
- Add Kerberos support to Http Sampler (HttpClient4). Based on patch by Felix Schumacher (felix.schumacher at internetallee.de)
Bug 54874
- Support device in addition to source IP address. Based on patch by Dan Fruehauf (malkodan at gmail.com)
Bug 55488
- Add .ico and .woff file extension to default suggested exclusions in proxy recorder. Contributed by Antonio Gomes Rodrigues
Bug 55525
- Proxy should support alias for keyserver entry
Bug 55531
- Proxy recording and redirects. Added code to disable redirected samples.
Bug 55507
- Proxy SSL recording does not handle external embedded resources well
Bug 55632
- Have a new implementation of htmlParser for embedded resources parsing with better performances
Bug 55653
- HTTP(S) Test Script Recorder should set TransactionController property "Include duration of timer and pre-post processors in generated sample" to false
Other samplers
Bug 54788
- JMS Point-to-Point Sampler - GUI enhancements to increase readability and ease of use. Contributed by Bruno Antunes (b.m.antunes at gmail.com)
Bug 54798
- Using subject from EML-file for SMTP Sampler. Contributed by Mikhail Epikhin (epihin-m at yandex.ru)
Bug 54759
- SSLPeerUnverifiedException using HTTPS , property documented.
Bug 54896
- JUnit sampler gives only "failed to create an instance of the class" message with constructor problems.
Bug 55084
- Add timeout support for JDBC Request. Contributed by Mikhail Epikhin (epihin-m at yandex.ru)
Bug 55403
- Enhancement to OS sampler: Support for timeout
Bug 55518
- Add ability to limit number of cached PreparedStatements per connection when "Prepared Select Statement", "Prepared Update Statement" or "Callable Statement" query type is selected
Controllers
Bug 54271
- Module Controller breaks if test plan is renamed.
Listeners
Bug 54532
- Improve Response Time Graph Y axis scale with huge values or small values (< 1000ms). Add a new field to define increment scale. Contributed by Milamber based on patch by Luca Maragnani (luca.maragnani at gmail.com)
Bug 54576
- View Results Tree : Add a CSS/JQuery Tester.
Bug 54777
- Improve Performance of default ResultCollector. Based on patch by Mikhail Epikhin (epihin-m at yandex.ru)
Bug 55389
- Show IP source address in request data
Bug 54789
- XPath Assertion - GUI enhancements to increase readability and ease of use.
Functions
Bug 54991
- Add functions to encode/decode URL encoded chars (__urlencode and __urldecode). Contributed by Milamber.
I18N
Bug 55241
- Need GUI Editor to process fields which are based on Enums with localised display strings
Bug 55440
- ComboStringEditor should allow tags to be language dependent
Bug 55432
- CSV Dataset Config loses sharing mode when switching languages
General
Bug 54584
- MongoDB plugin. Based on patch by Jan Paul Ettles (janpaulettles at gmail.com)
Bug 54669
- Add flag forcing non-GUI JVM to exit after test. Contributed by Scott Emmons
Bug 42428
- Workbench not saved with Test Plan. Contributed by Dzmitry Kashlach (dzmitrykashlach at gmail.com)
Bug 54825
- Add shortcuts to move elements in the tree. Contributed by Benoit Wiart (benoit.wiart at gmail.com)
Bug 54834
- Improve Drag & Drop in the jmeter tree. Contributed by Benoit Wiart (benoit.wiart at gmail.com)
Bug 54839
- Set the application name on Mac. Contributed by Benoit Wiart (benoit.wiart at gmail.com)
Bug 54841
- Correctly handle the quit shortcut on Mac Os (CMD-Q). Contributed by Benoit Wiart (benoit.wiart at gmail.com)
Bug 54844
- Set the application icon on Mac Os. Contributed by Benoit Wiart (benoit.wiart at gmail.com)
Bug 54864
- Enable multi selection drag & drop in the tree without having to start dragging before releasing Shift or Control. Contributed by Benoit Wiart (benoit.wiart at gmail.com)
Bug 54945
- Add Shutdown Hook to enable trapping kill or CTRL+C signals.
Bug 54990
- Download large files avoiding outOfMemory.
Bug 55085
- UX Improvement : Ability to create New Test Plan from Templates. Contributed by UBIK Load Pack (support at ubikloadpack.com)
Bug 55172
- Provide plugins a way to add Top Menu and menu items.
Bug 55202
- Add syntax color for scripts elements (BeanShell, BSF, and JSR223) and JDBC elements with RSyntaxTextArea. Contributed by Milamber based on patch by Marko Vlahovic (vlahovic74 at gmail.com)
Bug 55175
- HTTPHC4Impl refactoring to allow better inheritance.
Bug 55236
- Templates - provide button to reload template details.
Bug 55237
- Template system should support relative fileName entries.
Bug 55423
- BatchSampleSender: Reduce locking granularity by moving listener.processBatch outside of synchronized block
Bug 55424
- Add Stripping to existing SampleSenders
Bug 55451
- Test Element GUI with JSyntaxTextArea scroll down when text content is long enough to add a Scrollbar
Bug 55513
- StreamCopier cannot be used with System.err or System.out as it closes the output stream
Bug 55514
- SystemCommand should support arbitrary input and output streams
Bug 55515
- SystemCommand should support chaining of commands
Bug 55606
- Use JSyntaxtTextArea for Http Request, JMS Test Elements
We thank all contributors mentioned in bug and improvement sections above:
Bruno Antunes (b.m.antunes at gmail.com)
Emmanuel Bourg (ebourg at apache.org)
Scott Emmons
Mikhail Epikhin (epihin-m at yandex.ru)
Dzmitry Kashlach (dzmitrykashlach at gmail.com)
Luca Maragnani (luca.maragnani at gmail.com)
Milamber
Adrian Nistor (nistor1 at illinois.edu)
Antonio Gomes Rodrigues (ra0077 at gmail.com)
UBIK Load Pack (support at ubikloadpack.com)
Benoit Wiart (benoit.wiart at gmail.com)
We also thank bug reporters who helped us improve JMeter.
For this release we want to give special thanks to the following reporters for the clear reports and tests made after our fixes:
Immanuel Hayden (immanuel.hayden at gmail.com)
Danny Lade (dlade at web.de)
Brent Cromarty (brent.cromarty at yahoo.ca)
Wolfgang Heider (wolfgang.heider at racon.at)
Shmuel Krakower (shmulikk at gmail.com)
Apologies if we have omitted anyone else.
Version 2.9
New and Noteworthy
Core Improvements:
* A new Extractor that uses CSS or jquery-like selector syntax has been introduced,
it allows using either JODD or JSOUP implementations
Result: the title of the page in a JMeter variable
* JMeter can now handle different types of documents (PDF, MsOffice files, Apache OpenOffice's files, …)
within different elements
Regular Expression Extractor, extract text from documents
Assertion Response, check text in documents
View Results Tree, view as a text the documents
* A new Regex User Parameters Pre-Processor that enables injecting input parameter names and values
using a reference extracted by Regular Expression Extractor from a previous response
* TCP Sampler: new options
TCP Sampler has been enhanced with new options to allow setting
Close Connection
,
SO_LINGER
and
End of line(EOL) byte value
* A new function
__escapeOroRegexpChars(,)
has been introduced quote ORO regexp meta characters
* ForEach Controller: new fields
ForEach Controller has now 2 new fields to control start and end of loop
* Result Status Action Handler now has a new option to "Start next thread loop"
* JMS Publisher: new option
JMS Publisher can now send Bytes Messages
* Memory and performance improvements
Significant improvements have been done in this version on memory usage per Thread and CPU when more
than one Post Processor is used as child of a Sampler
JSR223 Elements (enable using Groovy, Scala, … as scripting languages) have been improved to enable caching
of Compilation results when scripts are passed in Text area
Some configuration defaults have changed to improve performances by default(see
Bug 54412
),
see description in New and Noteworthy section.
Distributed testing now uses MODE_STRIPPED_BATCH, which returns samples in batch mode (every 100 samples
or every minute by default). Note also that MODE_STRIPPED_BATCH strips response data from SampleResult,
so if you need it change to another mode (mode property in jmeter.properties)
Result data are now saved to CSV by default (jmeter.save.saveservice.output_format in jmeter.properties)
* XPath Assertion now enables using a JMeter variable as input
GUI and ergonomy Improvements:
* Search feature has been improved to search within more internal fields of elements and expand search results
* Copy/paste is now possible between 2 JMeter instances >= 2.9 version
Copy element(s) from one JMeter instance:
Paste element(s) into a second JMeter instance:
* HTTP Header Manager
Allow copy from clipboard to HeaderPanel, headers are supposed to be separated by new line
and have the following form
name:value
* Module Controller
Module Controller has been improved to better render referenced controller and expand it by clicking on a new button
* HTTP Proxy Server
HTTP Proxy Server now has a button to add a set of default exclusions for URL patterns,
this list can be configured through property :
proxy.excludes.suggested
* Rendering of target controller has been improved in HTTP Proxy Server
HTTP Proxy Server recording:
* HTTP Proxy Server now automatically uses HTTP Request with Raw Post Body mode for
samples that only have one unnamed argument (JSON, XML, GWT, …)
* HTTP Proxy Server does not force user to select the type of Sampler in HTTP Sampler Settings,
this allows easier switch between implementations as Sampler do not have this information set anymore
* SamplerCreator interface has been enriched to meet new requirements for plug-in providers
* It is now possible to create binary sampler for x-www-form-urlencoded POST request by
modifying
proxy.binary.types
property to add application/x-www-form-urlencoded
* Improved timestamp format auto-detection when reading CSV files
Known bugs
The Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
Listeners don't show iteration counts when a If Controller has a condition which is always false from the first iteration (see
Bug 52496
).
A workaround is to add a sampler at the same level as (or superior to) the If Controller.
For example a Test Action sampler with 0 wait time (which doesn't generate a sample),
or a Debug Sampler with all fields set to False (to reduce the sample size).
Webservice sampler does not consider the HTTP response status to compute the status of a response, thus a response 500 containing a non empty body will be considered as successful, see
Bug 54006
.
To workaround this issue, ensure you always read the response and add a Response Assertion checking text inside the response.
Changing language can break part of the configuration of the following elements (see
Bug 53679
):
CSV Data Set Config (sharing mode will be lost)
Constant Throughput Timer (Calculate throughput based on will be lost)
The numbers that appear to the left of the green box are the number of active threads / total number of threads,
these only apply to a locally run test; they do not include any threads started on remote systems when using client-server mode, (see
Bug 54152
).
Note that there is a bug in Java on some Linux systems that manifests
itself as the following error when running the test cases or JMeter itself:
[java] WARNING: Couldn't flush user prefs:
java.util.prefs.BackingStoreException:
java.lang.IllegalArgumentException: Not supported: indent-number
This does not affect JMeter operation.
Incompatible changes
JMeter requires now a Java 6 runtime or higher.
Some configuration defaults have changed to improve performances by default (see
Bug 54412
),
see description in New and Noteworthy section.
Webservice sampler now adds to request the headers that are set through Header Manager, these were previously ignored
jdbcsampler.cachesize
property has been removed, it previously limited the size of a per connection cache of Map < String,
PreparedStatement > , it also limited the size of this
map which held the PreparedStatement for SQL queries. This limitation provoked a bug
Bug 53995
.
It has been removed so now size of these 2 maps is not limited anymore. This change changes behaviour as starting from
this version no PreparedStatement will be closed during the test.
Starting with this version, there are some important changes on JSR223 Test Elements:
JSR223 Test Elements that have an invalid filename (not existing or unreadable) will make test fail instead of
making the element silently work
In JSR223 Test Elements: responseCodeOk, responseMessageOK and successful are set before
script is executed, if responseData is set it will not be overriden anymore by a toString() on script return value
View Results Tree now considers response with missing content type as text.
In remote Test mode, JMeter now exits in error if one of the remote engines cannot be configured,
previously it started the test with available engines.
Bug fixes
HTTP Samplers and Proxy
Don't log spurious warning messages when using concurrent pool embedded downloads with Cache Manager or CookieManager
Bug 54057
- Proxy option to set user and password at startup (-u and -a) not working with HTTPClient 4
Bug 54187
- Request tab does not show headers if request fails
Bug 54058
- In HTTP Request Defaults, the value of field "Embedded URLs must match: is not saved if the check box "Retrieve All Embedded Resources" is not checked.
Bug 54375
- Regular Expression Extractor : When regex syntax is wrong, post processing is stopped
Functions
I18N
General
Bug 53975
- Variables replacement doesn't work with option "Delay thread creation until needed"
Bug 54055
- View Results tree: = signs are stripped from parameter values at HTTP tab
Bug 54129
- Search Feature does not find text although existing in elements
Bug 54023
- Unable to start JMeter from a root directory and if the full path of JMeter installation contains one or more spaces (Unix/linux)
Bug 54172
- Duplicate shortcut key not working and CTRL+C / CTRL+V / CTRL+V do not cancel default event
Bug 54057
- Proxy option to set user and password at startup (-u and -a) not working with HTTPClient 4
Bug 54267
- Start Next Thread Loop setting doesn't work in custom thread groups
Bug 54413
- DataStrippingSampleSender returns 0 for number of bytes of any response
Improvements
HTTP Samplers
Bug 54185
- Allow query strings in paths that start with HTTP or HTTPS
Other samplers
Bug 54004
- Webservice Sampler : Allow adding headers to request with Header Manager
Bug 54106
- JSR223TestElement should check for file existence when a filename is set instead of using Text Area content
Bug 54107
- JSR223TestElement : Enable compilation and caching of Script Text
Bug 54109
- JSR223TestElement : SampleResult properties should be set before entering script to allow user setting different code
Bug 54230
- TCP Sampler, additions of "Close Connection", "SO_LINGER" and "End of line(EOL) byte value" options
Bug 54182
- Support sending of ByteMessage for JMS Publisher.
Controllers
Bug 54131
- ForEach Controller : Add start and end index for looping over variables
Bug 54155
- ModuleController : Add a shortcut button to unfold the tree up to referenced controller and highlight it
Listeners
Bug 54200
- Add support of several document types (like Apache OpenOffice's files, MS Office's files, PDF's files, etc.)
to the elements View Results Tree, Assertion Response and Regular Expression Extractor (using Apache Tika)
Bug 54226
- View Results Tree : Show response even when server does not return ContentType header
Thread Group: New Option
Delay thread creation until needed
New Option "Delay thread creation until needed" that will create and start threads when needed instead of creating them on Test startup
This new feature allows running tests with a huge number of short lived threads.
HTTP Cookie Manager (IPv6 support)
Add HTTPClient 4 cookie implementation in JMeter.
Cookie Manager has now the default HC3.1 implementation and a new choice HC4 implementation (compliant with IPv6 address)
Memory and performance improvements
Significant improvements have been done in this version on memory usage of JMeterThread
JSR223 Elements (enable using Groovy, scala, … as scripting languages) have been improved to enable:
usage of Compilable interface when available to boost CPU usage
caching of Compilation when scripts are used as Files
HTTP Request: HTTPClient 4 is now the default implementation
HTTPClient 4 is now the default HTTP Request implementation (and for Proxy element when generating HTTP requests).
Previously the default was the HTTP Java implementation (i.e. the implementation provided by the JVM)
HTTP Request
Add Embedded URL Filter to HTTP Request Defaults Control (it was already present for HTTP Requests)
Miscellanous
CSV Dataset : Embedded new lines are now supported in quoted data
JMX files now contain the version of JMeter that created the file
JMeter Version is now available as property "jmeter.version"
Reporting Improvements:
Response Time Graph
Add a new visualizer Response Time Graph to draw a line graph showing the evolution of response time for a test
Settings for Response Time Graph
View Results in Table
Add latency to View Result in Table listener
Aggregate Graph
Small improvements: legend at left or right is now on 1 column (instead of 1 large line), …
GUI and ergonomy Improvements:
HTTP Proxy Server simplifications
HTTPS Spoofing options have been removed from Proxy as HTTPS recording is directly available since JMeter 2.4.
HTTP Proxy Server
Allow URL Filters to be pasted from clipboard
Find in JMeter
CTRL + F for the new Find feature
ESC key now closes popups.
User Interface in GNOME 3
Display 'Apache JMeter' title in app title bar in Gnome 3
Known bugs
The Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
Listeners don't show iteration counts when a If Controller has a condition which is always false from the first iteration (see
Bug 52496
).
A workaround is to add a sampler at the same level as (or superior to) the If Controller.
For example a Test Action sampler with 0 wait time (which doesn't generate a sample),
or a Debug Sampler with all fields set to False (to reduce the sample size).
Changing language can break part of the configuration of the following elements (see
Bug 53679
):
CSV Data Set Config (sharing mode will be lost)
Constant Throughput Timer (Calculate throughput based on will be lost)
Note that there is a bug in Java on some Linux systems that manifests
itself as the following error when running the test cases or JMeter itself:
[java] WARNING: Couldn't flush user prefs:
java.util.prefs.BackingStoreException:
java.lang.IllegalArgumentException: Not supported: indent-number
This does not affect JMeter operation.
Incompatible changes
When using CacheManager, JMeter now caches responses for GET queries provided header Cache-Control is different from "no-cache" as described in specification.
Furthermore it doesn't put anymore in Cache deprecated entries for "no-cache" responses. See
Bug 53521
and
Bug 53522
A major change has occurred on JSR223 Test Elements, previously variables set up before script execution where stored in ScriptEngineManager which was created once per execution,
now ScriptEngineManager is a singleton shared by all JSR223 elements and only ScriptEngine is created once per execution, variables set up before script execution are now stored
in Bindings created on each execution, see
Bug 53365
.
JSR223 Test Elements using Script file are now Compiled if ScriptEngine supports this feature, see
Bug 53520
.
Shortcut for Function Helper Dialog is now CTRL+F1 (CMD + F1 for Mac OS), CTRL+F (CMD+F1 for Mac OS) now opens Search Dialog.
By default, the TestCompiler now stores details of which pairs it has seen in Controller instances rather than in a static Set.
[
Bug 53796
]
This gives much better memory behaviour for delayed start test plans, as memory used is proportional to the number of concurrent threads.
With the static Set memory usage was proportional to the total thread count.
This change is very unlikely to cause a problem.
The original behaviour can be restored by setting the property
TestCompiler.useStaticSet=true
HTTPS Spoofing options have been removed from Proxy as HTTPS recording is directly available since JMeter 2.4.
Bug fixes
HTTP Samplers and Proxy
Bug 53521
- Cache Manager should cache content with Cache-control=private
Bug 53522
- Cache Manager should not store at all response with header "no-cache" and store other types of Cache-Control having max-age value
Bug 53838
- Pressing "Stop" does not interrupt the TCP sampler
Bug 53911
- JmeterKeystore does not allow for key down the list of certificate
Other Samplers
Bug 53348
- JMeter JMS Point-to-Point Request-Response sampler doesn't work when Request-queue and Receive-queue are different
Bug 53357
- JMS Point to Point reports too high response times in Request Response Mode
Bug 53440
- SSL connection leads to ArrayStoreException on JDK 6 with some KeyManagerFactory SPI
Bug 53742
- When jmeter.save.saveservice.sample_count is set to true, elapsed time read by listener is always equal to 0
Bug 53774
- RequestViewRaw does not show headers unless samplerData is non-null
Bug 53802
- IdleTime values are not saved to CSV log
Bug 53874
- View Results Tree : If some parameter containing special characters like % is not encoded, RequestViewHTTP fails with java.lang.IllegalArgumentException: URLDecoder: Illegal hex characters in escape (%) pattern and Response is not displayed
Bug 53931
- Define HTTPClient 4 for the default HTTP Request (and Proxy element to generate the HTTP requests). Before the default, it was the HTTP Java Sampler
Bug 53934
- Removes HTTPS spoofing options in JMeter HTTP Proxy Server. Since JMeter 2.4, the HTTPS protocol is directly supported by the proxy
Other samplers
Bug 55310
- TestAction should implement Interruptible
Bug 53318
- Add Embedded URL Filter to HTTP Request Defaults Control
Bug 53782
- Enhance JavaSampler handling of JavaSamplerClient cleanup to use less memory
Bug 53168
- OS Process - allow specification of stdout/stderr/stdin
Bug 53844
- JDBC related elements should check class of Variable Name supposed to contain JDBC Connection Configuration to avoid ClassCastException
Controllers
Bug 53671
- tearDown thread group to run even if shutdown test happens
Listeners
Bug 53566
- Don't log partial responses to the jmeter log
Bug 53716
- Small improvements in aggregate graph: legend at left or right is now on 1 column (instead of 1 large line), no border to the reference's square color, reduce width on some fields
Bug 53718
- Add a new visualizer 'Response Time Graph' to draw a line graph showing the evolution of response time for a test
Bug 53738
- Keep track of number of threads started and finished
Bug 53753
- Summariser: no point displaying fractional time in most cases
Bug 53749
- TestListener interface could perhaps be split up.
This should reduce per-thread memory requirements and processing,
as only test elements that actually use testIterationStart functionality now need to be handled.
Bug 53941
- Add latency to View Result table listener
Bug 53755
- Adding a HttpClient 4 cookie implementation in JMeter.
Cookie Manager has now the default HC3.1 implementation and a new choice HC4 implementation (compliant with IPv6 address)
Functions
Bug 51527
- __time() function : add another option to __time() to provide *seconds* since epoch
I18N
General
Bug 53364
- Sort list of Functions in Function Helper Dialog
Bug 53418
- New Option "Delay thread creation until needed" that will create and start threads when needed instead of creating them on Test startup
Bug 42245
- Show clear passwords in HTTP Authorization Manager
Bug 53616
- Display 'Apache JMeter' title in app title bar in Gnome 3
Bug 53759
- ClientJMeterEngine performs unnecessary traverse using SearchByClass(TestListener)
A new System Sampler that can be used to execute commands on the local machine.
OS Process Sampler results example with DNS lookup command 'dig'
JMS Samplers improvements
Addition of a "Non Persistent Delivery" option to send "Non-Persistent" (Guaranteed to be delivered at most once. Message loss is not a concern.) JMS messages
Support sending of JMS Object Messages to enable sending Objects unmarshalled from XML by XStream
Enable setting JMS Properties through JMS Publisher sampler
Test Action sampler
Allow premature exit from a loop
Webservice Sampler improvements
Add a jmeter property soap.document_cache to control size of Document Cache
Make Maintain HTTP Session configurable
Aggregate graph: Clustered Bar char with average, median, 90% line, min and max columns
Aggregate graph changes to Clustered Bar chart, add more columns (median, 90% line, min, max) and options, fixed some bugs
New settings for aggregate graph
Improvements of HTML report design generated by JMeter Ant task in extras folder
HTML report example
HTML report example with some assertion errors
Mailer Visualizer
Enable authentication, and connection security with SSL or TLS
Improve GUI design
Add internationalisation (i18n) support
New Visual Indicator of number of ERROR/FATAL messages in logs
Indicator shows number of ERROR/FATAL messages in logs, it can be clicked to toggle Log Viewer panel
Dialog box to show detail of a parameter row
Add a detail button on parameters table to show detail of a Row
Detail box example
Plugin writers
New interface org.apache.jmeter.engine.util.ConfigMergabilityIndicator has been introduced to tell whether a ConfigTestElement can be merged in Sampler (see
Bug 53042
):
public boolean applies(ConfigTestElement configElement);
New interface org.apache.jmeter.protocol.http.proxy.SamplerCreator to allow plugging HTTP based samplers that differ from default HTTP Samplers through Proxy during Recording Phase (see
Bug 52674
):
public String[] getManagedContentTypes();
public HTTPSamplerBase createSampler(HttpRequestHdr request, Map pageEncodings, Map formEncodings);
The Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
Listeners don't show iteration counts when a If Controller has a condition which is always false from the first iteration (see
Bug 52496
).
A workaround is to add a sampler at the same level as (or superior to) the If Controller.
For example a Test Action sampler with 0 wait time (which doesn't generate a sample),
or a Debug Sampler with all fields set to False (to reduce the sample size).
Incompatible changes
When doing replacement of User Defined Variables, Proxy will not substitute partial values anymore when "Regexp matching" is used. It will use Perl 5 word matching ("\b")
In User Defined Variables, Test Plan, HTTP Sampler Arguments Table, Java Request Defaults, JMS Sampler and Publisher, LDAP Request Defaults and LDAP Extended Request Defaults, rows with
empty Name and Value are no more saved.
JMeter now expands the Test Plan tree to the testplan level and no further and selects the root of the tree. Furthermore default value of onload.expandtree is false.
Graph Full Results Listener has been removed.
When calling "Clear All" command, if Log Viewer is displayed its content will be cleared.
Bug fixes
HTTP Samplers and Proxy
Bug 52613
- Using Raw Post Body option, text gets encoded
Bug 52781
- Content-Disposition header garbled even if browser compatible headers is checked (HC4)
Bug 52796
- MonitorHandler fails to clear variables when starting a new parse
Bug 52871
- Multiple Certificates not working with HTTP Client 4
Bug 52885
- Proxy : Recording issues with HTTPS, cookies starting with secure are partly truncated
Bug 52886
- Proxy : Recording issues with HTTPS when spoofing is on, secure cookies are not always changed
Bug 52897
- HTTPSampler : Using PUT method with HTTPClient4 and empty Content Encoding and sending files leads to NullPointerException
Bug 53145
- HTTP Sampler - function in path evaluated too early
Mailer Visualizer has been internationalized. French translation added. (see
Bug 53246
)
General
Bug 45839
- Test Action : Allow premature exit from a loop
Bug 52614
- MailerModel.sendMail has strange way to calculate debug setting
Bug 52782
- Add a detail button on parameters table to show detail of a Row
Bug 52674
- Proxy : Add a Sampler Creator to allow plugging HTTP based samplers using potentially non textual POST Body (AMF, Silverlight, …) and customizing them for others
Bug 52934
- GUI : Open Test plan with the tree expanded to the testplan level and no further and select the root of the tree
Bug 52941
- Improvements of HTML report design generated by JMeter Ant task extra
Bug 53042
- Introduce a new method in Sampler interface to allow Sampler to decide wether a config element applies to Sampler
Bug 52771
- Documentation : Added RSS feed on JMeter Home page under link "Subscribe to What's New"
Bug 42784
- Show the number of errors logged in the GUI
Bug 53256
- Make Clear All command clean LogViewer content
Bug 53261
- Make "Error/fatal" counter added in
Bug 42784
open Log Viewer panel when Warn Indicator is clicked
Non-functional changes
Upgraded to rhino 1.7R3 (was js-1.7R2.jar).
Note: the Maven coordinates for the jar were changed from rhino:js to org.mozilla:rhino.
This does not affect JMeter directly, but might cause problems if using JMeter in a Maven project
with other code that depends on an earlier version of the Rhino Javascript jar.
Bug 52675
- Refactor Proxy and HttpRequestHdr to allow Sampler Creation by Proxy
Bug 52680
- Mention version in which function was introduced
Bug 52788
- HttpRequestHdr : Optimize code to avoid useless work
JMeter Ant (ant-jmeter-1.1.1.jar) task was upgraded from 1.0.9 to 1.1.1
Updated to httpcomponents-client 4.1.3 (from 4.1.2)
Updated JMeter distributed testing guide (jmeter_distributed_testing_step_by_step.pdf). Changes source format to OpenOffice odt (from sxw)
Version 2.6
New and Noteworthy
Toolbar
A new toolbar on JMeter's main window
JMeter start test button
A new menu option and button allow to start a test ignoring the Pause Timers
JMeter GUI Look and Feel
Allow System or CrossPlatform LAF to be set from options menu
JMeter GUI - duplicate node
Add "duplicate node" in context menu
JMeter tree view - search facility
Functionality to search by keyword in Samplers Tree View
HTTP Request - raw request pane
Improve HTTP Request GUI to better show parameters without name (GWT RPC request or SOAP request for example)
HTTP Request - other changes
Allow multiple selection in arguments panel
Allow to add (paste) entries from the clipboard to an arguments list
Ability to move variables up or down in HTTP Request
HTTP Request - file protocol
Better support for file: protocol in HTTP sampler
Retrieve embedded resources with file: protocol
HTTP Request - Ignore embedded resources failed
Enable "ignore failed" for embedded resources
Parent success with a embedded resource failed
View Results in Table - child sample display
Add option to TableVisualiser to display child samples instead of parent
Key Store - multiple certificates
Allowing multiple certificates (JKS)
Aggregate graph improvements
Some improvements on Aggregate Graph Listener:
new GUI for settings
dynamic graph size
allow to change fonts for title graph and legend
allow to change bar color (background and text values)
allow to draw or not bars outlines
allow to select only some samplers by a regexp filter
allow to define Y axis maximum scale
Aggregate Graph bar
Counter - new reset option
Add an option to reset counter on each Thread Group iteration
Functions
Add a new function __RandomString to generate random Strings
Add a new function __TestPlanName returning the name of the current "Test Plan"
Add a new function __machineIP returning IP address
Add a new function __jexl2 to support Jexl2
User Defined Variable improvements
Add a comment field in User Defined Variables
Allow to add (paste) entries from the clipboard to an arguments list
Ability to move up or down variables in User Defined Variables
View Results Tree
In View Results Tree rather than showing just a message if the results are to big, show as much of the result as are configured
Controllers - change elements
Add ability to Change Controller elements
JDBC pre- and post-processor
Add JDBC pre- and post-processor
JDBC transaction isolation option
Allow to set the transaction isolation in the JDBC Connection Configuration
Poisson Timer
Add a Poisson based timer
GUI and OS interaction
Support for file Drag and Drop.
Confirm Remove Dialog box
Add a dialog box to confirm removing the element(s) when Remove action is called
The dialogue can be skipped by setting the JMeter property
confirm.delete.skip=true
Remote batching support
Use external store to hold samples during distributed testing,
Added DiskStore remote sample sender: like Hold, but saves samples to disk until end of test
JMS Subscriber sampler
With JMS Subscriber, ability to use Selectors
New Logger Panel
A new Log Viewer has been added to the GUI and can be enabled from menu Options → Log Viewer:
This Log Viewer shows the jmeter.log file, and useful (for example) to debug BeanShell/BSF scripts:
The menu item Options / Choose Language is now fully functional
The menu item Options / Choose Language now changes all the displayed text to the new language provided
all messages are translated. You can help on this by translating into your language.
Legacy JMX and JTL Avalon format support restored
Support for reading/writing the original Avalon XML format of JMX (script) and JTL (sample result) files was dropped in JMeter version 2.4.
JMeter can now read the Avalon format files again, however there is no support for saving files in the old format.
JMeter jars available from Maven repository
JMeter jars are now available from Maven repository.
Known bugs
The Include Controller has some problems in non-GUI mode (see Bugs 40671, 41286, 44973, 50898).
In particular, it can cause a NullPointerException if there are two include controllers with the same name.
The Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
Listeners don't show iteration counts when a If Controller has a condition which is always false from the first iteration (see
Bug 52496
).
A workaround is to add a sampler at the same level as (or superior to) the If Controller.
For example a Test Action sampler with 0 wait time (which doesn't generate a sample),
or a Debug Sampler with all fields set to False (to reduce the sample size).
Incompatible changes
JMeter versions since 2.1 failed to create a container sample when loading embedded resources.
This has been corrected; can still revert to the
Bug 51939
behaviour by setting the following property:
httpsampler.separate.container=false
Mirror server now uses default port 8081, was 8080 before 2.5.1.
TCP Sampler handles SocketTimeoutException, SocketException and InterruptedIOException differently since 2.6, when
these occurs, Sampler is marked as failed.
Sample Sender implementations now resolve their configuration on Client side since 2.6.
This behaviour can be changed with property sample_sender_client_configured (set it to false).
The HTTP User Parameter Modifier test element has been removed; it has been deprecated for a long time.
Bug fixes
HTTP Samplers and Proxy
Bug 51932
- CacheManager does not handle cache-control header with any attributes after max-age
Bug 52221
- Nullpointer Exception with use Retrieve Embedded Resource without HTTP Cache Manager
Bug 52310
- variable in IPSource failed HTTP request if "Concurrent Pool Size" is enabled
Bug 52371
- API Incompatibility - Methods in HTTPSampler2 now require PostMethod instead of HttpMethod[Base]. Reverted to original types.
Bug 49950
- Proxy : IndexOutOfBoundsException when recording with Proxy server
Bug 52409
- HttpSamplerBase#errorResult modifies sampleResult passed as parameter;
fix code which assumes that a new instance is created (i.e. when adding a sub-sample)
Bug 52507
- Delete Http User Parameters modifier (deprecated, obsolete)
Other Samplers
Bug 51996
- JMS Initial Context leak newly created Context when Multiple Thread enter InitialContextFactory#lookupContext at the same time
Bug 51691
- Authorization does not work for JMS Publisher and JMS Subscriber
Bug 52036
- Durable Subscription fails with ActiveMQ due to missing clientId field
Bug 52044
- JMS Subscriber used with many threads leads to javax.naming.NamingException: Something already bound with ActiveMQ
Bug 52072
- LengthPrefixedBinaryTcpClientImpl may end a sample prematurely
Bug 52390
- AbstractJDBCTestElement:Memory leak and synchronization issue in perConnCache
Controllers
Bug 51865
- Infinite loop inside thread group does not work properly if "Start next loop after a Sample error" option set
Bug 51868
- A lot of exceptions in jmeter.log while using option "Start next loop" for thread
Bug 51866
- Counter under loop doesn't work properly if "Start next loop on error" option set for thread group
Bug 52296
- TransactionController + Children ThrouputController or InterleaveController leads to ERROR sampleEnd called twice java.lang.Throwable: Invalid call sequence when TPC does not run sample
Bug 52330
- With next-Loop-On-Error after error samples are not executed in next loop
Listeners
Bug 52357
- View results in Table does not allow for multiple result samples
Bug 52491
- Incorrect parsing of Post data parameters in Tree Listener / Http Request view
Bug 52087
- TCPClient interface does not allow for partial reads
Bug 52115
- SOAP/XML-RPC should not send a POST request when file to send is not found
Bug 40750
- TCPSampler : Behaviour when sockets are closed by remote host
Bug 52396
- TCP Sampler in "reuse connection mode" reuses previous sampler's connection even if it's configured with other host, port, user or password
Bug 52048
- BSFSampler, BSFPreProcessor and BSFPostProcessor should share the same GUI
Controllers
Listeners
Bug 52022
- In View Results Tree rather than showing just a message if the results are to big, show as much of the result as are configured
Bug 52201
- Add option to TableVisualiser to display child samples instead of parent
Bug 52214
- Save Responses to a file - improve naming algorithm
Bug 52340
- Allow remote sampling mode to be changed at run-time
Bug 52452
- Improvements on Aggregate Graph Listener (GUI and settings)
Resurrected OldSaveService to allow reading Avalon format JTL (result) files
Bug 51816
- Comment Field in User Defined Variables control.
Bug 52052
- Using a delimiter to separate result-messages for JMS Subscriber
Bug 52103
- Add automatic scrolling option to table visualizer
Bug 52097
- Save As should point to same folder that was used to open a file if MRU list is used
Bug 52085
- Allow multiple selection in arguments panel
Bug 52099
- Allow to set the transaction isolation in the JDBC Connection Configuration
Bug 52116
- Allow to add (paste) entries from the clipboard to an arguments list
Bug 52160
- Don't display TestBeanGui items which are flagged as hidden
Bug 51886
- SampleSender configuration resolved partly on client and partly on server
Bug 52161
- Enable plugins to add own translation rules in addition to upgrade.properties.
Loads any additional properties found in META-INF/resources/org.apache.jmeter.nameupdater.properties files
Bug 46921
- Add Ability to Change Controller elements
Bug 52240
- TestBeans should support Boolean, Integer and Long
Bug 52241
- GenericTestBeanCustomizer assumes that the default value is the empty string
Bug 52242
- FileEditor does not allow output to be saved in a File
Bug 51093
- when loading a selection previously stored by "Save Selection As", show the file name in the blue window bar
Bug 50086
- Password fields not Hidden in JMS Publisher, JMS Subscriber, Mail Reader sampler, SMTP sampler and Database Configuration
Bug 29352
- Use external store to hold samples during distributed testing, Added DiskStore remote sample sender: like Hold, but saves samples to disk until end of test.
Bug 52333
- Reduce overhead in calculating SampleResult#nanoTimeOffset
Bug 52346
- Shutdown detects if there are any non-daemon threads left which prevent JVM exit.
Bug 52471
- Improve Mirror Server performance by Using Pool of threads instead of launching a Thread for each request
Resurrected OldSaveService to allow reading Avalon format JMX files (removed in 2.4)
Add a dialog box to confirm removing the element(s) when Remove action is called
Bug 41788
- Log viewer (console window) needed as an option
Add option to change the pause time (default 2000ms) in the daemon thread which checks for successful JVM exit.
The thread is not now started unless the pause time is greater than 0.
Non-functional changes
fixes to build.xml: support scripts; localise re-usable property names
Bug 51923
- Counter function bug or documentation issue ? (fixed docs)
Update velocity.jar to 1.7 (from 1.6.2)
Update js.jar to 1.7R3 (from 1.6R5)
Update commons-codec 1.5 ⇒ 1.6
Update commons-io 2.0.1 ⇒ 2.1
Update commons-jexl 2.0.1 ⇒ 2.1.1
Update jdom 1.1 ⇒ 1.1.2
Update junit 4.9 ⇒ 4.10
Bug 51954
- Generated documents include entries which cause extra blank lines
Bug 52075
- JMeterProperty.clone() currently returns Object; it should return JMeterProperty
Updated httpcore to 4.1.4
Bug 49753
- Please publish jMeter artifacts on Maven central repository
Version 2.5.1
Summary of main changes
HttpClient4 sampler now re-uses connections properly (previously it would use one per sample, which could quickly cause resource exhaustion).
Various fixes to JMS samplers
Functions are no longer spuriously invoked when used with a Configuration element
WebService sampler GUI has been re-organized for better design and more user-friendliness. Some improments on WSDL configuration assistant
Better handling of test shutdown. System.exit now only called if there is no other option; even this can be disabled.
Known bugs
The Include Controller has some problems in non-GUI mode.
In particular, it can cause a NullPointerException if there are two include controllers with the same name.
The Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
The If Controller may cause an infinite loop if the condition is always false from the first iteration.
A workaround is to add a sampler at the same level as (or superior to) the If Controller.
For example a Test Action sampler with 0 wait time (which doesn't generate a sample),
or a Debug Sampler with all fields set to False (to reduce the sample size).
The menu item Options / Choose Language does not change all the displayed text to the new language.
[The behaviour has improved, but language change is still not fully working]
To override the default local language fully, set the JMeter property "language" before starting JMeter.
Incompatible changes
The HttpClient4 and Commons HttpClient 3.1 samplers previously used a retry count of 3.
This has been changed to default to 1, to be compatible with the Java implementation.
The retry count can be overridden by setting the relevant JMeter property, for example:
httpclient4.retrycount=3
httpclient3.retrycount=3
Bug fixes
HTTP Samplers and Proxy
Fix HttpClient 4 sampler so it reuses HttpClient instances and connections where possible.
Temporary fix to HC4 sampler to work round HTTPCLIENT-1120.
Bug 51863
- Lots of ESTABLISHED connections with HttpClient 4 implementation (vs HttpClient 3.1 impl)
Bug 51750
- Retrieve all embedded resources doesn't follow IFRAME
Bug 51752
- HTTP Cache is broken when using "Retrieve all embedded resources" with concurrent pool
Bug 39219
- HTTP Server: You can't stop it after File→Open
Bug 51775
- Port number duplicates in Host header when capturing by HttpClient (3.1 and 4.x)
Bug 50617
- Monitor Results legend show "dead" server although values from the server are retrieved
Other Samplers
Bug 50424
- Web Methods drop down list box inconsistent
Bug 43293
- Java Request fields not cleared when creating new sampler
Bug 51830
- Webservice Soap Request triggers too many popups when Webservice WSDL URL is down
WebService(SOAP) request - add a connect timeout to get the wsdl used to populate Web Methods when server doesn't response
Bug 51841
- JMS : If an error occurs in ReceiveSubscriber constructor or Publisher, then Connections will stay open
Bug 51691
- Authorization does not work for JMS Publisher and JMS Subscriber
Bug 51840
- JMS : Cache of InitialContext has some issues
Bug 51885
- Allow a JMeter Variable as input to XPathExtractor
Functions
I18N
General
Bug 51822
- (part 1) save 1 invocation of GuiPackage#getCurrentGui
Added AsynchSampleSender which sends samples from server to client asynchronously.
Upgraded to htmlparser 2.1; JavaMail 1.4.4; JUnit 4.9
Non-functional changes
Bug 49976
- FormCharSetFinder visibility is default instead of public.
Bug 50917
- Property CookieManager.save.cookies not honored when set from test plan
Improve error logging when Javascript errors are detected.
Updated documentation footer
Version 2.5
Summary of main changes
The HTTP implementation can now be selected at run-time, and JMeter now also supports Apache HttpComponents HttpClient 4.x.
Note that Commons HttpClient 3.1 is no longer actively developed, and support may be removed from JMeter in a future release.
The HTTP sampler now allows concurrent downloads of embedded resources in an HTML page
The HTTP Sampler can now report the size of a request before decompression.
The JMS and Mail samplers have been improved.
The new Test Fragment Test Element makes using Include Controllers easier
There are various improvements to the View Results Tree Listener
Bug 30563
- Thread Group should have a start next loop option on Sample Error
There are two new Thread Group types - setUp and tearDown - which are run before and after the main Thread groups.
Client-Server mode now supports external stop/shutdown via UDP
multiple JMeter server instances can be started on the same host without needing to change the port property.
Bug 50516
- "Host" header in HTTP Header Manager is not included in generated HTTP request
Known bugs
The Include Controller has some problems in non-GUI mode.
In particular, it can cause a NullPointerException if there are two include controllers with the same name.
Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
The menu item Options / Choose Language does not change all the displayed text to the new language.
[The behaviour has improved, but language change is still not fully working]
To override the default local language fully, set the JMeter property "language" before starting JMeter.
Incompatible changes
Unsupported methods are no longer converted to GET by the Commons HttpClient sampler.
Removed method public static long currentTimeInMs().
This has been replaced by the instance method public long currentTimeInMillis().
ProxyControl.getSamplerTypeName() now returns a String rather than an int.
This is internal to the workings of the JMeter Proxy & its GUI, so should not affect any user code.
Bug fixes
HTTP Samplers and Proxy
Bug 50178
- HeaderManager added as child of Thread Group can create concatenated HeaderManager names and OutOfMemoryException
Bug 50392
- value is trimmed when sending the request in Multipart
Bug 50686
- HeaderManager logging too verbose when merging instances
Bug 50516
- "Host" header in HTTP Header Manager is not included in generated HTTP request
Bug 50544
- In Apache Common Log the HEAD requests cause problems.
Bug 51268
- HTTPS request through an invalid proxy causes NullPointerException and does not show in result tree.
Rather than delegating to the JMeter thread handler for "unexpected" failures, ensure all Exceptions generate a sample error.
Bug 50088
- fix getAvgPageBytes in SamplingStatCalculator so it returns what it should
Bug 50203
Cannot set property "jmeter.save.saveservice.default_delimiter=\t"
mirror-server.sh - fix classpath to use : separator (not ;)
Bug 50286
- URL Re-writing Modifier: extracted jsessionid value is incorrect when is between XML tags
System.nanoTime() tends to drift relative to System.currentTimeMillis().
Change SampleResult to recalculate offset each time.
Also enable reversion to using System.currentTimeMillis() only.
Bug 50425
- Remove thread groups from Controller add menu
Bug 50675
- CVS Data Set Config incompatible with Remote Start
Fixed RMI startup to provide location of JMX file relative to user.dir.
Bug 50221
- Renaming elements in the tree does not resize label
Bug 51002
- Stop Thread if CSV file is not available. JMeter now treats IOError as EOF.
Define sun.net.http.allowRestrictedHeaders=true by default. This fixes
Bug 51238
.
Bug 51645
- CSVDataSet does not read UTF-8 files when file.encoding is UTF-8
Improvements
HTTP Samplers
AJP Sampler now implements Interruptible
Allow HTTP implementation to be selected at run-time
Bug 50684
- Optionally disable Content-Type and Transfer-Encoding in Multipart POST
Bug 50943
- Allowing concurrent downloads of embedded resources in html page
Bug 50170
- Bytes reported by http sampler is after GUnZip
Add optional properties to allow change the method to get response size
Hiding the proxy password on HTTP Sampler (just on GUI, not in JMX file)
Other samplers
Bug 49622
- Allow sending messages without a subject (SMTP Sampler)
Bug 49603
- Allow accepting expired certificates on Mail Reader Sampler
Bug 49975
- New function returning the name of the current sampler
I18N
Add French translation for the new labels and reduce size for some labels (by abbreviation) on HTTP Sample
General
Bug 30563
- Thread Group should have a start next loop option on Sample Error
Bug 50347
- Eclipse setup instructions should remind user to download dependent jars
Bug 50490
- Setup and Post Thread Group enhancements for better test flow.
All BeansShell test elements now have the script variables "prev" and "Label" defined.
Bug 50708
- Classpath jar order in NewDriver not alphabetically
Bug 50659
- JMeter server does not support concurrent tests - prevent client from starting another
Added remote shutdown functionality
Client JMeter engine now supports external stop/shutdown via UDP
UDP shutdown can now use a range of ports, from jmeterengine.nongui.port=4445 to jmeterengine.nongui.maxport=4455,
allowing multiple JMeter instances on the same host without needing to change the port property.
Updated to httpcore 4.1.3 and httpclient 4.1.2
Non-functional changes
Bug 50008
- Allow BatchSampleSender to be subclassed
Bug 50450
- use System.array copy in jacobi solver as, being native, is more performant.
Bug 50487
- runSerialTest verifies objects that never need persisting
Use Thread.setDefaultUncaughtExceptionHandler() instead of private ThreadGroup
Update to Commons Net 3.0
Version 2.4
Summary of main changes
JMeter now requires at least Java 1.5.
HTTP Proxy can now record HTTPS sessions.
JUnit sampler now supports JUnit4 annotations.
Added JSR223 (javax.script) test elements.
MailReader Sampler can now use any protocol supported by the underlying implementation.
An SMTP Sampler has been added.
JMeter now allows users to provide their own Thread Group implementations.
View Results Tree now supports more display options, including search and Regex Testing.
StatCalculator performance is much improved; Aggregate Report etc. need far less memory.
JMS samplers have been extensively reworked, and should no longer lose messages.
Correlation processing is improved.
JMS Publisher and Subscriber now support both Topics and Queues.
Many other improvements have been made, please see below and in the manual.
Known bugs
The Include Controller has some problems in non-GUI mode.
In particular, it can cause a NullPointerException if there are two include controllers with the same name.
Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
The menu item Options / Choose Language does not change all the displayed text to the new language.
[The behaviour has improved, but language change is still not fully working]
To override the default local language fully, set the JMeter property "language" before starting JMeter.
Incompatible changes
HTTP Redirect now defaults to "Follow Redirects" rather than "Redirect Automatically".
This is to enable JMeter to track cookies that may be sent during redirects.
This does not affect existing test plans; it only affects the default for new HTTP Samplers.
The Avalon file format for JMX and JTL files is no longer supported.
Any such files will need to be converted by reading them in JMeter 2.3.4 and resaving them.
The XPath Assertion and XPath Extractor elements no longer fetch external DTDs by default; this can be changed in the GUI.
JMSConfigGui has been renamed as JMSSamplerGui.
This does not affect existing test plans.
The constructor public SampleResult(SampleResult res) has been changed to become a true "copy constructor".
It no longer calls addSubResult(). This may possibly affect some 3
rd
party add-ons.
Bug fixes
HTTP Samplers and Proxy
Bug 47445
- Using Proxy with https-spoofing secure cookies need to be unsecured
Bug 47442
- Missing replacement of https by http for certain conditions using https-spoofing
Bug 48451
- Error in: SoapSampler.setPostHeaders(PostMethod post) in the else branch
Bug 48542
- SoapSampler uses wrong response header field to decide if response is gzip encoded
Bug 48709
- TCP Sampler Config setting "classname" has no effect
Controllers
Bug 47385
- TransactionController should set AllThreads and GroupThreads
Bug 47940
- Module controller incorrectly creates the replacement Sub Tree
Bug 47592
- Run Thread groups consecutively with "Stop test" on error, JMeter will not mark to finished
Bug 48786
- Run Thread groups consecutively: with "Stop test now" on error or manual stop, JMeter leaves the green box active
Bug 48727
- Cannot stop test if all thread groups are disabled
Listeners
Bug 48603
- Mailer Visualiser sends two emails for a single failed response
Correct calculation of min/max/std.dev for aggregated samples (Summary Report)
Bug 48889
- Wrong response time with mode=Statistical and num_sample_threshold > 1
Bug 47398
- SampleEvents are sent twice over RMI in distributed testing and non gui mode
Assertions
Functions
I18N
General
Bug 47646
- NullPointerException in the "Random Variable" element
Disallow adding any child elements to JDBC Configuration
BeanInfoSupport now caches getBeanDescriptor() - should avoid an NPE on non-Sun JVMs when using CSVDataSet (and some other TestBeans)
Bug 48350
- Deadlock on distributed testing with 2 clients
Bug 48901
- Endless wait by adding Synchronizing Timer
Bug 49149
- usermanual/index.html has typo in link to "Regular Expressions" page
Bug 49394
- Classcast Exception in ActionRouter.postActionPerformed
Bug 48136
- Essential files missing from source tarball.
Source archives now contain all source files, including source files previously only provided in the binary archives.
Bug 48331
- XpathExtractor does not return XML string representations for a Nodeset
Bug 47474
- View Results Tree support for plugin renderers
Allow Idle Time to be saved to sample log files
Bug 48259
- Improve StatCalculator performance by using TreeMap
Listeners using SamplingStatCalculator have much reduced memory needs
as the Sample cache has been moved to the new CachingStatCalculator class.
In particular, Aggregate Report can now handle large numbers of samples.
Aggregate Report and Summary Report now allow column headers to be optionally excluded
Bug 49506
- Add .csv File Extension in open dialog box from "read from file" functionality of listeners
Bug 49545
- Formatted (parsed) view of Sample Result in Results Tree
Beanshell, JavaMail and JMS API (Apache Geronimo) jars are now included in the binary archive.
Add TestBean Table Editor support
Removed all external libraries from SVN; added download_jars Ant target
Updated various jar files:
BeanShell - 2.0b4 ⇒ 2.0b5
Commons Codec - 1.3 ⇒ 1.4
Commons-Collections - 3.2 ⇒ 3.2.1
JTidy ⇒ r938
JUnit - 3.8.2 ⇒ 4.8.1
Logkit - 1.2 ⇒ 2.0
Xalan Serializer = 2.7.1 (previously erroneously shown as 2.9.1)
Xerces xml-apis = 1.3.04 (previously erroneously shown as 2.9.1)
Some jar files were renamed.
Version 2.3.4
Summary of main changes
This is a minor bug-fix release, mainly to correct some bugs that were accidentally added in 2.3.3.
Known bugs
The Include Controller has some problems in non-GUI mode.
In particular, it can cause a NullPointerException if there are two include controllers with the same name.
Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
The menu item Options / Choose Language does not change all the displayed text to the new language.
[The behaviour has improved, but language change is still not fully working]
To override the default local language fully, set the JMeter property "language" before starting JMeter.
Bug fixes
HTTP Samplers and Proxy
Bug 47321
- HTTPSampler2 response timeout not honored
Other Samplers
Bug 47290
- Infinite loop on connection factory lookup (JMS)
JDBC Sampler should not close Prepared or Callable statements as these are cached
Change ResultCollector to only warn if the directory was not created
Fix some synchronisation issues in ResultCollector and SampleResult (wrong locks were being used)
I18N
Fixed bug introduced in 2.3.3: JMeter does not start up if there is no messages.properties file for the default Locale.
General
Fix problems with remote clients - bug introduced in 2.3.3
Bug 47377
- Make ClassFinder more robust and close zipfile resources
Fix some errors in generating the documentation (latent bug revealed in 2.3.3 when Velocity was upgraded)
Improvements
Other samplers
Bug 47266
- FTP Request Sampler: allow specifying an FTP port, other than the default
Version 2.3.3
Summary of main changes
The handling of test closedown is much improved.
The gradual "Shutdown" command now waits until all threads have stopped,
and does not report an error if threads don't stop within 5 seconds.
The immediate "Stop" command can now be used if "Shutdown" takes too long.
Also the immediate "Stop" command is able to interrupt samplers which support the new Interruptible interface (e.g. HTTP and SOAP, FTP).
This allows immediate completion of pending responses.
Non-GUI mode tests can also now be sent a "Shutdown" or "Stop" message.
Test Action
now supports a "Stop Now" action,
as do the
Thread Group
and
Result Status Action Handler
Post Processor elements.
HTTP Cookie handling is improved, and HTTP POST can now use variable file names correctly.
HTTP, SOAP/XML-RPC and WebService(SOAP) sampler character encodings updated to be more consistent.
HTTP Samplers now support connection and response timeouts (requires JVM 1.5 for the HTTP Java sampler).
Together with the closedown improvements described above, this should avoid most cases where a test run hangs.
Multiple Header Manager elements are now supported for a single HTTP sampler.
The Proxy Server is improved, and no longer stores "Host" headers by default.
JDBC Request can optionally save the results of Select statements to variables.
JDBC Request now handles quoted strings and UTF-8, and can handle arbitrary variable types.
There are several new
functions
:
__char() function: allows arbitrary Unicode characters to be entered in fields.
__unescape() function: allows Java-escaped strings to be used.
_unescapeHtml() function: decodes Html-encoded text.
__escapeHtml() function: encodes text using Html-encoding.
A reference to a missing function - e.g. ${__missing(a)} - is now treated the same as a missing variable.
Previously the function name - and leading { - were dropped. This makes it easier to debug test plans.
Some Assertions can now be applied to sub-samples as well as (or instead of) just the parent sample.
There is a new
Random Variable
Configuration element.
JMS samplers are much improved (see details below). The
TCP Sampler
now supports some additional clients and is a bit more flexible.
Client-server mode has been improved, and the server can optionally use a fixed RMI port, which should help with setting up firewalls.
Various I18N changes have been made; language change works better (though not perfect yet).
There are improved French translations as well as new Polish and Brazilian Portugese translations.
The BeanShell jar is now included with the binary archive; there is no need to download it separately.
Known bugs
The Include Controller has some problems in non-GUI mode.
In particular, it can cause a
NullPointerException
if there are two include controllers with the same name.
Once Only controller behaves correctly under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
The menu item
Options → Choose Language
does not change all the displayed text to the new language.
[The behaviour has improved, but language change is still not fully working]
To override the default local language fully, set the JMeter property "
language
" before starting JMeter.
Incompatible changes
When loading sample results from a file, previous results are no longer cleared.
This allows one to merge multiple files.
If the previous behaviour is required,
use the menu item
Run → Clear (Ctrl + Shift + E)
or
Run → Clear All (Ctrl + E)
before loading the file.
The test elements "Save Results to a file" and "Generate Summary Results" are now shown as Listeners.
They were previously shown as Post-Processors, even though they are implemented as Listeners.
The Cookie Manager no longer saves incoming cookies as variables by default.
To save cookies as variables, define the property "
CookieManager.save.cookies=true
".
Also, cookies names are prefixed with "
COOKIE_
" before they are stored (this avoids accidental corruption of local variables)
To revert to the original behaviour, define the property "
CookieManager.name.prefix=
" (one or more spaces).
The Counter element is now shown as a Configuration element.
It was previously shown as a Pre-Processor, even though it is implemented as a Config item.
The above changes only affect the icons that are displayed and the locations in the GUI pop-up menus.
They do not affect test plans or test behaviour.
The PreProcessors are now invoked directly by the JMeterThread class,
rather than by the TestCompiler#configureSampler() method. (JMeterThread handles the PostProcessors).
This does not affect test plans or behaviour, but could perhaps affect 3
rd
party add-ons (very unlikely).
Moved the Scoping Rules sub-section from Section 3. "Building a Test Plan" to Section 4. "Elements of a test plan"
The While controller now trims leading and trailing spaces from the condition value before it is compared
with
LAST
, blank or false.
The "threadName" variable in the _jexl() and __javaScript() functions was previously misspelt as "theadName".
The following deprecated methods were removed from JOrphanUtils: booleanToString(boolean) and valueOf(boolean).
Java 1.4+ has these methods in the Boolean class.
Bug 45458
- Point to Point JMS in combination with authentication
Bug 45460
- JMS TestPlan elements depend on resource property
Various ReceiveSubscriber thread-safety fixes
JMSPublisher and Subscriber fixes: thread-safety, support dynamic locale changes, locale independence for JMX attribute values
FTP Sampler now logs out before disconnecting.
TCP sampler now calls setupTest() and teardownTest() methods
Bug 45887
- TCPSampler: timeout property incorrectly set
Controllers
Fix NPE when using nested Transaction Controllers with parent samples
Fix processing of Transaction Controller parent mode so current sampler is set to actual sampler
Bug 44941
- Throughput controllers should not share global counters
Bug 47120
- Throughput Controller: change percent executions to total executions, the value is stored in a String and interpreted as 1 execution
Bug 47150
- ThreadGroup with a loop count of zero causes infinite loop
Bug 47009
- Insert parent caused child controller name to be reset
Bug 47165
- Using duplicate Module Controller names in command line mode causes NPE
Listeners
Mailer Visualizer documentation now agrees with code i.e. failure/success counts need to be exceeded to trigger the mail.
Mailer Visualizer now shows the failure count
Mailer Visualiser - fix parsing of multiple e-mail address when using Test button
Bug 45976
- incomplete result file when using remote testing with more than 1 server
Fix Summariser so it works in client server mode
Bug 34096
- Duplicate samples not eliminated when writing to CSV files
Save "Include group Name in Label" setting in Aggregate and Summary reports
The JMeter variable "sample_variables" is sent to all server instances to ensure the data is available to the client.
CSVSaveService - check for EOF while reading quoted string
Assertions
Bug 45749
- Response Assertion does not work with a substring that happens to be an invalid RE
Bug 45904
- Allow 'Not' Response Assertion to succeed with null sample
Functions
Fix regex function - was failing to process $m$mid$n$ correctly
Protect against possible NPE in RegexFunction if called during test shutdown.
Avoid NPE if XPath function does not match any nodes
Correct the variable name "theadName" to "threadName" in the __jexl() and __javaScript() functions
A reference to a missing function - e.g. ${__missing(a)} - is now treated the same as a missing variable. Previously the function name - and leading { - were dropped.
I18N
Fixed language change handling for menus (does not yet work for TestBeans)
Add HeaderAsPropertyRenderer to support header resource names; use this to fix locale changes in various GUI elements
Fix incorrect GUI classifications:
"Save Results to a file" and "Generate Summary Results" are now shown as Listeners.
"Counter" is now shown as a Configuration element.
Added locales.add property to allow for new Locales
General
Allow spaces in JMeter path names (apply work-round for
Java Bug 4496398
)
Process JVM_ARGS last in script files so users can override default settings
Bug 46636
- Allow server mode to optionally use a fixed rmi port
Make some samplers interruptible: HTTP (both), SoapSampler, FTPSampler
Test Action now supports "Stop Now" action, as do the Thread Group and Result Status Post Processor elements
The Menu items Stop and Shutdown now behave better. Shutdown will now wait until all threads exit.
In GUI mode it can be cancelled and Stop run instead.
Stop now reports if some threads will not exit, and exits if running in non-GUI mode
Add UDP server to wait for shutdown message if running in non-GUI mode; add UDP client to send the message.
Introduce AbstractListenerGui class to make it easier to create Listeners with no visual output
Assertions are run after PostProcessors; change order of pop-up menus accordingly
Remove unnecessary clone() methods from function classes
Moved PreProcessor invocation to JMeterThread class
Made HashTree Map field final
Improve performance of calling ResultCollector#isSampleWanted() for multiple samples
Updated to new versions of: xmlgraphics-commons (1.3.1), jdom (1.1), xstream (1.3.1), velocity (1.6.2)
Version 2.3.2
Summary of main changes
Bug fixes
Version 2.3.1 changed the way binary and text content types were determined as far as the View Results Tree Listener was concerned:
originally everything except "image/" content types were considered text, but 2.3.1 introduced a check
for specific content types. This has caused problems,
as several popular types were omitted and these were no longer shown by default in the Response tab.
Rather than try to list all the possible text types, JMeter now just checks for the following binary types:
image/*
audio/*
video/*
All other types are now assumed to be text.
JMeter 2.3.1 introduced a bug in the Cookie Manager
- if "Clear Cookie each iteration" was selected, all threads would see the same cookies.
This bug has been corrected.
Improvements
The Proxy server can now record binary requests.
By default the content types
application/x-amf and application/x-java-serialized-object
will be treated as binary and saved in a file.
To change the content types, update the property
proxy.binary.types
.
The CSV Dataset configuration element has new file sharing options: per thread group, per thread, per identifier.
This allows for more flexible file processing, e.g. each thread can process the same data in the same order.
Switch Controller now works properly with functions and variables,
and the condition can now be a name instead of a number.
Simple Controller now works properly under a While Controller
CSV fields in JTL files can now contain delimiters.
CSV and XML files can now contain additional variables (define the JMeter property
sample_variables
).
Response Assertion can now match on substrings (i.e. not regular expression).
Regex extractor can operate on variables.
XPath processing is improved; Tidy errors are handled better.
Save Table Data buttons added to Summary and Aggregate reports to allow easy saving of the calculated data.
HTTP samplers can now save just the MD5 hash of responses, rather than the entire response.
As a special case, if the HTTP Sampler path starts with "http://" or "https://" then this is used as the full URL,
overriding the host and port fields.
The HTTP Samplers can now POST multiple files.
Webservice(SOAP) Sampler can now load local WSDL files using the "file:" protocol.
A simple HTTP Cache Manager has been added. This needs further development.
View Results Tree Listener now uses Tidy to display XML.
This should allow more content to be displayed succesfully.
It also avoids the need to download remote DTD files, which can slow the rendering considerably.
MailReader sampler now supports POP3S and IMAPS protocols. Individual mails are now added as sub-samples.
Various improvements to the BSF Sampler: now supports Jexl, and Javascript bug works properly.
Added BSF PreProcessor, PostProcessor and Assertion test elements.
All now have access to "props" JMeter Properties object.
Number of classes loaded in non-GUI mode is much reduced.
Known bugs
The Include Controller has some problems in non-GUI mode.
In particular, it can cause a NullPointerException if there are two include controllers with the same name.
Once Only controller behaves OK under a Thread Group or Loop Controller,
but otherwise its behaviour is not consistent (or clearly specified).
The menu item Options / Choose Language does not change all the displayed text to the new language.
To override the default local language, set the JMeter property "language" before starting JMeter.
Incompatible changes
To reduce the number of classes loaded in non-GUI mode,
Functions will only be found if their classname contains the string
'.functions.' and does not contain the string '.gui.'.
All existing JMeter functions conform to this restriction.
To revert to earlier behaviour, comment or change the properties classfinder.functions.* in jmeter.properties.
The reference value parameter for intSum() is now optional.
As a consequence, if a variable name is used, it must not be a valid integer.
The supplied TCPClient implementation no longer treats tcp.eolByte=0 as special.
To skip EOL checking, set tcp.eolByte=1000 (or some other value which is not a valid byte)
Leading and trailing spaces are trimmed from variable names in function calls.
For example, ${__Random(1,63, LOTTERY )} will use the variable 'LOTTERY' rather than ' LOTTERY '.
Synchronization has been removed from the RunningSample class (it was not fully threadsafe anyway).
Developers of 3
rd
party add-ons that use the class may need to synchronize access.
Bug fixes
Check that the CSV delimiter is reasonable.
Fix Switch Controller to work properly with functions and variables
Bug 44011
- application/soap+xml not treated as a text type
Bug 43427
- Simple Controller is only partly executed in While loop
Bug 33954
- Stack Overflow in If/While controllers (may have been fixed previously)
Bug 42204
- add thread group name to Aggregate and Summary reports
FTP Sampler sets latency = time to login
FTP Sampler sets a URL if it can
Bug 41921
- add option for samplers to store MD5 of response; done for HTTP Samplers.
Regex Function can now also be applied to a variable rather than just the previous sample result.
Remove HTML Parameter Mask,HTTP User Parameter Modifier from menus as they are deprecated
Bug 44807
- allow session ids to be terminated by backslash
Bug 44784
- allow for broken server returning additional charset
Added TESTSTART.MS property / variable = test start time in milliseconds
Add POP3S and IMAPS protocols to Mail Reader Sampler.
Mail Reader Sampler now creates a sub-sample for each mail.
The supplied TCPClient implementation no longer treats tcp.eolByte=0 as special.
To skip EOL checking, set tcp.eolByte=1000 (or some other value which is not a valid byte)
JUnit sampler GUI now also finds Test classes defined in user.classpath
Leading and trailing spaces are trimmed from variable names in function calls.
For example, ${__Random(1,63, LOTTERY )} will use the variable 'LOTTERY' rather than ' LOTTERY '
Webservice(SOAP) Sampler can now load local WSDL files using the file: protocol
Bug 44872
- Add "All Files" filter to Open File dialogs
Mirror server can now be run independently (mirror-server.cmd and mirror-server.sh)
Bug 19128
- Added multiple file POST support to HTTP Samplers
Allow use of special name LAST to mean the last test run; applies to -t, -l, -j flags
Better handling of MirrorServer startup problems and improved unit test.
Build process now detects missing 3
rd
party libraries and reports need for both binary and source archives
Skip BeanShell tests if jar is not present
Update to Xerces 2.9.1, Xalan 2.7.1, Commons IO 1.4, Commons Lang 2.4, Commons-Logging 1.1.1, XStream 1.3, XPP3 1.1.4c
Use properties for log/logn function descriptions
Check that all jmx files in the demos directory can be loaded OK
Update copyright to 2008; use copy tag instead of numeric character in HTML output
Methods called from constructors must not be overridable: make GUI init methods private
Make static variables final if possible
Split changes into current and previous
Version 2.3.1
Summary of changes
JMeter Proxy
The Proxy spoof function was broken in 2.3; it has been fixed.
Spoof now supports an optional parameter to limit spoofing to particular URLs.
This is useful for HTTPS pages that have insecure content - e.g. images/stylesheets may be accessed using HTTP.
Spoofed responses now drop the default port (443) from https links to make them work better.
Ignored proxy samples are now visible in Listeners - the label is enclosed in [ and ] as an indication.
Proxy documentation has been improved.
GUI changes
The Add menus show element types in the order in which they are processed
- see
Test Plan Execution Order
.
It is no longer possible to add test elements to inappropriate parts of the tree
- e.g. samplers cannot be added directly under a test plan.
This also applies to Paste and drag and drop.
The File menu now supports a "Revert" option, which reloads the current file.
Also the last few file names used are remembered for easy reloading.
The Options Menu now supports Collapse All and Expand All items to collapse and expand the test tree.
Remote testing
The JMeter server now starts the RMI server directly (by default).
This simplifies testing, and means that the RMI server will be stopped when the server stops.
Functions can now be used in Listener filenames (variables do not work).
Command-line option -G can now be used to define properties for remote servers.
Option -X can be used to stop a remote server after a non-GUI run.
Server can be set to automatically exit after a single test (set property server.exitaftertest=true).
Other enhancements
JMeter startup no longer loads as many classes; this should reduce memory requirements.
Parameter and file support added to all BeanShell elements.
Javascript function now supports access to JMeter objects;
Jexl function always did have access, but the documentation has now been included.
New functions __eval() and __evalVar() for evaluating variables.
CSV files with the correct header column names are now automatically recognised when loaded.
There is no need to configure the properties.
The hostname can now be saved in CSV and XML output files.
New "Successes only" option added when saving result files.
Errors / Successes only option is now supported when loading XML and CSV files.
General documentation improvements.
HTTP
PUT and DELETE should now work properly.
Cookie Manager no longer clears manually entered cookies.
Now handles the META tag http-equiv charset
JDBC
JDBC Sampler now allows INOUT and OUT parameters for Called procedures.
JDBC Sampler now allows per-thread connections - set Max Connections = 0 in JDBC Config.
Incompatible changes
JMeter server now creates the RMI registry by default.
If the RMI registry has already been started externally, this will generate a warning message, but the server will continue.
This should not affect JMeter testing.
However, if you are also using the RMI registry for other applications there may be problems.
For example, when the JMeter server shuts down it will stop the RMI registry.
Also user-written command files may need to be adjusted (the ones supplied with JMeter have been updated).
To revert to the earlier behaviour, define the JMeter property:
server.rmi.create=false
.
The Proxy server removes If-Modified-Since and If-None-Match headers from generated Header Managers.
To revert to the previous behaviour, define the property proxy.headers.remove with no value
Bug fixes
Bug 43430
- Count of active threads is incorrect for remote samples
Throughput Controller was not working for "all thread" counts
If a POST body is built from parameter values only, these are now encoded if the checkbox is set.
Bug 43584
- Assertion Failure Message contains a comma that is also used as the delimiter for CSV files
HTTP Mirror Server now always returns the exact same content, it used to return incorrect data if UTF-8 encoding was used for HTTP POST body, for example
Bug 43612
- HTTP PUT does not honor request parameters
Bug 42012
- Variable Listener filenames do not get processed in remote tests.
Filenames can now include function references; variable references do not work.
Ensure Listener nodes get own save configuration when copy-pasted
Correct Proxy Server include and exclude matching description - port and query are included, contrary to previously documented.
Aggregate Graph and Aggregate Report Column Header is KB/Sec; fixed the values to be KB rather than bytes
Fix SamplingStatCalculator so it no longer adds elapsed time to endTime, as this is handled by SampleResult.
This corrects discrepancies between Summary Report and Aggregate Report throughput calculation.
Default HTTPSampleResult to ISO-8859-1 encoding
Fix default encoding for blank encoding
Fix Https spoofing (port problem) which was broken in 2.3
Fix HTTP (Java) sampler so http.java.sampler.retries means retries, i.e. does not include initial try
Fix SampleResult dataType checking to better detect TEXT documents
Improvements
Add run_gui Ant target, to package and then start the JMeter GUI from Ant
Add File→Revert to easily drop the current changes and reload the project file currently loaded
Bug 42555
- [I18N] Proposed corrections for the french translation
Bug 43727
- Test Action does not support variables or functions
The Proxy server removes If-Modified-Since and If-None-Match headers from generated Header Managers by default.
To change the list of removed headers, define the property proxy.headers.remove as a comma-separated list of headers to remove
The javaScript function now has access to JMeter variables and context etc. See
JavaScript function
Use drop-down list for BSF Sampler language field
Add hostname to items that can be saved in CSV and XML output files.
Errors only flag is now supported when loading XML and CSV files
Ensure ResultCollector uses SaveService encoding
Proxy now rejects attempts to use it with https
Proxy spoofing can now use RE matching to determine which urls to spoof (useful if images are not https)
Proxy spoofing now drops the default HTTPS port (443) when converting https: links to http:
Add Successes Only logging and display
The JMeter log file name is formatted as a SimpleDateFormat (applied to the current date) if it contains paired single-quotes, .e.g. 'jmeter_'yyyyMMddHHmmss'.log'
Added Collapse All and Expand All Option menu items
Allow optional definition of extra content-types that are viewable as text
Non-functional Improvements
Functor code tightened up; Functor can now be used with interfaces, as well as pre-defined targets and parameters.
Save graphics function now prompts before overwriting an existing file
Debug Sampler and Debug PostProcessor added.
Fixed up method names in Calculator and SamplingStatCalculator
Tidied up Listener documentation.
Version 2.3
Fixes since 2.3RC4
Bug fixes
Fix NPE in SampleResultConverter - XStream PrettyPrintWriter cannot handle nulls
If Java HTTP sampler sees null ResponseMessage, replace with HTTP header
Bug 43332
- 2.3RC4 does not clear Guis based on TestBean
Bug 42948
- Problems with Proxy gui table fields in Java 1.6
Fixup broken jmeter-server script
Bug 43364
- option to revert If Controller to pre 2.3RC3 behaviour
Bug 43449
- Statistical Remote mode does not handle Latency
Bug 43450
(partial fix) - Allow SampleCount and ErrorCount to be saved to/restored from files
Improvements
Add nameSpace option to XPath extractor
Add NULL parameter option to JDBC sampler
Add documentation links for Rhino and BeanShell to functions; clarify variables and properties
Ensure uncaught exceptions are logged
Look for user.properties and system.properties in JMeter bin directory if not found locally
Fixes since 2.3RC3
Fixed NPE in Summariser (bug introduced in 2.3RC3)
Fixed setup of proxy port (bug introduced in 2.3RC3)
Fixed errors when running non-GUI on a headless host (bug introduced in 2.3RC3)
Bug 43054
- SSLManager causes stress tests to saturate and crash (bug introduced in 2.3RC3)
Clarified HTTP Request Defaults usage of the port field
The JMeter remote server does not support multiple concurrent tests - each remote test should be run in a separate server.
Otherwise tests may fail with random Exceptions, e.g. ConcurrentModification Exception in StandardJMeterEngine.
See
Bug 43168
.
The default HTTP Request (not HTTPClient) sampler may not work for HTTPS connections via a proxy.
This appears to be due to a Java bug, see
Bug 39337
.
To avoid the problem, try a more recent version of Java, or switch to the HTTPClient version of the HTTP Request sampler.
Transaction Controller parent mode does not support nested Transaction Controllers.
Doing so may cause a Null Pointer Exception in TestCompiler.
Thread active counts are always zero in CSV and XML files when running remote tests.
The property file_format.testlog=2.1 is treated the same as 2.2.
However JMeter does honour the 3 testplan versions.
Bug 22510
- JMeter always uses the first entry in the keystore.
Remote mode does not work if JMeter is installed in a directory where the path name contains spaces.
BeanShell test elements leak memory.
This can be reduced by using a file instead of including the script in the test element.
Variables and functions do not work in Listeners in client-server (remote) mode so they cannot be used
to name log files in client-server mode.
CSV Dataset variables are defined after configuration processing is completed,
so they cannot be used for other configuration items such as JDBC Config.
(see
Bug 40394
)
Summary of changes (for more details, see below)
Some of the main enhancements are:
Htmlparser 2.0 now used for parsing
HTTP Authorization now supports domain and realm
HttpClient options can be specified via httpclient.parameters file
HttpClient now behaves the same as Java Http for SSL certificates
HTTP Mirror Server to allow local testing of HTTP samplers
HTTP Proxy supports XML-RPC recording, and other proxy improvements
__V() function allows support of nested variable references
LDAP Ext sampler optionally parses result sets and supports secure mode
FTP Sampler supports Ascii/Binary mode and upload
Transaction Controller now optionally generates a Sample with subresults
HTTPS session contexts are now per-thread, rather than shared. This gives better emulation of multiple users
BeanShell elements now support ThreadListener and TestListener interfaces
Coloured icons in Tree View Listener and elsewhere to better differentiate failed samples.
The main bug fixes are:
HTTPS (SSL) handling now much improved
Various Remote mode bugs fixed
Control + C
and
Control + V now work in the test tree
Latency and Encoding now available in CSV log output
Test elements no longer default to previous contents; test elements no longer cleared when changing language.
Incompatible changes (usage):
N.B. The javax.net.ssl properties have been moved from jmeter.properties to system.properties,
and will no longer work if defined in jmeter.properties.
The new arrangement is more flexible, as it allows arbitrary system properties to be defined.
SSL session contexts are now created per-thread, rather than being shared.
This generates a more realistic load for HTTPS tests.
The change is likely to slow down tests with many SSL threads.
The original behaviour can be enabled by setting the JMeter property:
https.sessioncontext.shared=true
The LDAP Extended Sampler now uses the same panel for both Thread Bind and Single-Bind tests.
This means that any tests using the Single-bind test will need to be updated to set the username and password.
Bug 41140
: JMeterThread behaviour was changed so that PostProcessors are run in forward order
(as they appear in the test plan) rather than reverse order as previously.
The original behaviour can be restored by setting the following JMeter property:
jmeterthread.reversePostProcessors=true
The HTTP Authorization Manager now has extra columns for domain and realm,
so the temporary work-round of using '\' and '@' in the username to delimit the domain and realm
has been removed.
Control + Z no longer used for Remote Start All - this
now uses
Control + Shift + R
HttpClient now uses pre-emptive authentication.
This can be changed by setting the following:
The port field in HTTP Request Defaults is no longer ignored for https samplers if it is set to 80.
Incompatible changes (development):
N.B.
The clear() method was defined in the following interfaces: Clearable, JMeterGUIComponent and TestElement.
The methods serve different purposes, so two of them were renamed:
the Clearable method is now clearData() and the JMeterGUIComponent method is now clearGui().
3
rd
party add-ons may need to be rebuilt.
Calulator and SamplingStatCalculator classes no longer provide any formatting of their data.
Formatting should now be done using the jorphan.gui Renderer classes.
Removed deprecated method JMeterUtils.split() - use JOrphanUtils version instead.
Removed method saveUsingJPEGEncoder() from SaveGraphicsService.
It was unused so far, and used the only Sun-specific class in JMeter.
New functionality/improvements:
Add Domain and Realm support to HTTP Authorization Manager
HttpClient now behaves the same as the JDK http sampler for invalid certificates etc
Added httpclient.parameters.file to allow HttpClient parameters to be defined
Bug 33964
- Http Requests can send a file as the entire post body if name/type are omitted
Bug 41705
- add content-encoding option to HTTP samplers for POST requests
Bug 40933
,
Bug 40945
- optional RE matching when retrieving embedded resource URLs
The time stamp is now set to the sampler start time (it was the end).
To revert to the previous behaviour, change the property
sampleresult.timestamp.start
to false (or comment it)
The JMX output format has been simplified and files are not backwards compatible
The JMeter.BAT file no longer changes directory to JMeter home, but runs from the current working directory.
The jmeter-n.bat and jmeter-t.bat files change to the directory containing the input file.
Listeners are now started slightly later in order to allow variable names to be used.
This may cause some problems; if so define the following in jmeter.properties:
jmeterengine.startlistenerslater=false
The GUI now expands the tree by default when loading a test plan.
This can be disabled by setting the JMeter property
onload.expandtree=false
Known problems:
Post-processors run in reverse order (see
Bug 41140
)
Module Controller does not work in non-GUI mode
Aggregate Report and some other listeners use increasing amounts of memory as a test progresses
Does not always handle non-default encoding properly
Spaces in the installation path cause problems for client-server mode
Change of Language does not propagate to all test elements
SamplingStatCalculator keeps a List of all samples for calculation purposes;
this can cause memory exhaustion in long-running tests
Does not properly handle server certificates if they are expired or not installed locally
New functionality:
Report function
XPath Extractor Post-Processor. Handles single and multiple matches.
Simpler JMX file format (2.2)
BeanshellSampler code can update ResponseData directly
Bug 37490
- Allow UDV as delay in Duration Assertion
Slow connection emulation for HttpClient
Enhanced JUnitSampler so that by default assert errors and exceptions are not appended to the error message.
Users must explicitly check append in the sampler
Enhanced the documentation for webservice sampler to explain how it works with CSVDataSet
Enhanced the documentation for javascript function to explain escaping comma
Allow CSV Data Set file names to be absolute
Report Tree compiler errors better
Don't reset Regex Extractor variable if default is empty
includecontroller.prefix property added
Regular Expression Extractor sets group count
Can now save entire screen as an image, not just the right-hand pane
Bug 38901
- Add optional SOAPAction header to SOAP Sampler
New BeanShell test elements: Timer, PreProcessor, PostProcessor, Listener
__split() function now clears next variable, so it can be used with ForEach Controller
Bug 38682
- add CallableStatement functionality to JDBC Sampler
Make it easier to change the RMI/Server port
Add property jmeter.save.saveservice.xml_pi to provide optional xml processing instruction in JTL files
Add bytes and URL to items that can be saved in sample log files (XML and CSV)
The Post-Processor "Save Responses to a File" now saves the generated file name with the
sample, and the file name can be included in the sample log file.
Change jmeter.bat DOS script so it works from any directory
New -N option to define nonProxyHosts from command-line
New -S option to define system properties from input file
Bug 38681
- Include controller now works in non-GUI mode
Add write(OS,IS) implementation to TCPClientImpl
Sample Result converter saves response code as "rc". Previously it saved as "rs" but read with "rc"; it will now also read with "rc".
The XSL stylesheets also now accept either "rc" or "rs"
Fix counter function so each counter instance is independent (previously the per-user counters were shared between instances of the function)
Fix TestBean Examples so that they work
Fix JTidy parser so it does not skip body tags with background images
Fix HtmlParser parser so it catches all background images
Bug 39252
set SoapSampler sample result from XML data
Bug 38694
- WebServiceSampler not setting data encoding correctly
Result Collector now closes input files read by listeners
Bug 25505
- First HTTP sampling fails with "HTTPS hostname wrong: should be 'localhost'"
Bug 25236
- remove double scrollbar from Assertion Result Listener
Bug 31696
Duration not working correctly when using Scheduler
JMeterContext now uses ThreadLocal - should fix some potential NPE errors
Version 2.0.1
Bug fix release. TBA.
Version 2.0
HTML parsing improved; now has choice of 3 parsers, and most embedded elements can now be detected and downloaded.
Redirects can now be delegated to URLConnection by defining the JMeter property HTTPSamper.delegateRedirects=true (default is false)
Stop Thread and Stop Test methods added for Samplers and Assertions etc. Samplers can call setStopThread(true) or setStopTest(true) if they detect an error that needs to stop the thread of the test after the sample has been processed
Thread Group Gui now has an extra pane to specify what happens after a Sampler error: Continue (as now), Stop Thread or Stop Test.
This needs to be extended to a lower level at some stage.
Added Shutdown to Run Menu. This is the same as Stop except that it lets the Threads finish normally (i.e. after the next sample has been completed)
Remote samples can be cached until the end of a test by defining the property hold_samples=true when running the server.
More work is needed to be able to control this from the GUI
Proxy server has option to skip recording browser headers
Proxy restart works better (stop waits for daemon to finish)
Scheduler ignores start if it has already passed
Scheduler now has delay function
added Summariser test element (mainly for non-GUI) testing. This prints summary statistics to System.out and/or the log file every so oftem (3 minutes by default). Multiple summarisers can be used; samples are accumulated by summariser name.
Extra Proxy Server options:
Create all samplers with keep-alive disabled
Add Separator markers between sets of samples
Add Response Assertion to first sampler in each set
Test Plan has a comment field
Help Page can now be pushed to background
Separate Function help page
New / amended functions
__property() and __P() functions
__log() and __logn() - for writing to the log file
_StringFromFile can now process a sequence of files, e.g. dir/file01.txt, dir/file02.txt etc
_StringFromFile() funtion can now use a variable or function for the file name
New / amended Assertions
Response Assertion now works for URLs, and it handles null data better
Response Assertion can now match on Response Code and Response message as well
HTML Assertion using JTidy to check for well-formed HTML
If Controller (not fully functional yet)
Transaction Controller (aggregates the times of its children)
New Samplers
Basic BSF Sampler (optional)
BeanShell Sampler (optional, needs to be downloaded from www.beanshell.org
Basic TCP Sampler
Optionally start BeanShell server (allows remote access to JMeter variables and methods)
Version 1.9.1
TBA
Version 1.9
Sample result log files can now be in CSV or XML format
New Event model for notification of iteration events during test plan run
New Javascript function for executing arbitrary javascript statements
Many GUI improvements
New Pre-processors and Post-processors replace Modifiers and Response-Based Modifiers.
Compatible with jdk1.3
JMeter functions are now fully recursive and universal (can use functions as parameters to functions)
Integrated help window now supports hypertext links
New Random Function
New XML Assertion
New LDAP Sampler (alpha code)
New Ant Task to run JMeter (in extras folder)
New Java Sampler test implementation (to assist developers)
More efficient use of memory, faster loading of .jmx files
New SOAP Sampler (alpha code)
New Median calculation in Graph Results visualizer
Default config element added for developer benefit
Various performance enhancements during test run
New Simple File recorder for minimal GUI overhead during test run
New Function: StringFromFile - grabs values from a file
New Function: CSVRead - grabs multiple values from a file
Functions now longer need to be encoded - special values should be escaped
with "\" if they are literal values
New cut/copy/paste functionality
SSL testing should work with less user-fudging, and in non-gui mode
Mailer Model works in non-gui mode
New Througput Controller
New Module Controller
Tests can now be scheduled to run from a certain time till a certain time
Remote JMeter servers can be started from a non-gui client. Also, in gui mode, all remote servers can be started with a single click
ThreadGroups can now be run either serially or in parallel (default)
New command line options to override properties
New Size Assertion
Version 1.8.1
Bug Fix Release. Many bugs were fixed.
Removed redundant "Root" node from test tree.
Re-introduced Icons in test tree.
Some re-organization of code to improve build process.
View Results Tree has added option to view results as web document (still buggy at this point).
New Total line in Aggregate Listener (still buggy at this point).
Improvements to ability to change JMeter's Locale settings.
Improvements to SSL Manager.
Version 1.8
Improvement to Aggregate report's calculations.
Simplified application logging.
New Duration Assertion.
Fixed and improved Mailer Visualizer.
Improvements to HTTP Sampler's recovery of resources (sockets and file handles).
Improving JMeter's internal handling of test start/stop.
Fixing and adding options to behavior of Interleave and Random Controllers.
New Counter config element.
New User Parameters config element.
Improved performance of file opener.
Functions and other elements can access global variables.
Help system available within JMeter's GUI.
Test Elements can be disabled.
Language/Locale can be changed while running JMeter (mostly).
View Results Tree can be configured to record only errors.
Various bug fixes.
Version 1.7.3
New Functions that provide more ability to change requests dynamically during test runs.
New language translations in Japanese and German.
Removed annoying Log4J error messages.
Improved support for loading JMeter 1.7 version test plan files (.jmx files).
JMeter now supports proxy servers that require username/password authentication.
Dialog box indicating test stopping doesn't hang JMeter on problems with stopping test.
GUI can run multiple remote JMeter servers (fixes GUI bug that prevented this).
Dialog box to help created function calls in GUI.
New Keep-alive switch in HTTP Requests to indicate JMeter should or should not use Keep-Alive for sockets.
HTTP Post requests can have GET style arguments in Path field. Proxy records them correctly now.
New User-defined test-wide static variables.
View Results Tree now displays more information, including name of request (matching the name
in the test tree) and full request and POST data.
Removed obsolete View Results Visualizer (use View Results Tree instead).
Performance enhancements.
Memory use enhancements.
Graph visualizer GUI improvements.
Updates and fixes to Mailer Visualizer.
Version 1.7.2
JMeter now notifies user when test has stopped running.
HTTP Proxy server records HTTP Requests with re-direct turned off.
HTTP Requests can be instructed to either follow redirects or ignore them.
Various GUI improvements.
New Random Controller.
New SOAP/XML-RPC Sampler.
Version 1.7.1
JMeter's architecture revamped for a more complete separation between GUI code and
test engine code.
Use of Avalon code to save test plans to XML as Configuration Objects
All listeners can save data to file and load same data at later date.
Version 1.7Beta
Better XML support for special characters (Tushar Bhatia)
Non-GUI functioning & Non-GUI test plan execution (Tushar Bhatia)
Removing Swing dependence from base JMeter classes
Internationalization (Takashi Okamoto)
AllTests bug fix (neth6@atozasia.com)
ClassFinder bug fix (neth6@atozasia.com)
New Loop Controller
Proxy Server records HTTP samples from browser
(and documented in the user manual)
Multipart Form support
HTTP Header class for Header customization
Extracting HTTP Header information from responses (Jamie Davidson)
Mailer Visualizer re-added to JMeter
JMeter now url encodes parameter names and values
listeners no longer give exceptions if their gui's haven't been initialized
HTTPS and Authorization working together
New Http sampling that automatically parses HTML response
for images to download, and includes the downloading of these
images in total time for request (Neth neth6@atozasia.com)
HTTP responses from server can be parsed for links and forms,
and dynamic data can be extracted and added to test samples
at run-time (documented)
New Ramp-up feature (Jonathan O'Keefe)
New visualizers (Neth)
New Assertions for functional testing
Version 1.6.1
Fixed saving and loading of test scripts (no more extra lines)
Can save and load special characters (such as "&" and "<").
Can save and load timers and listeners.
Minor bug fix for cookies (if you cookie value
contained an "=", then it broke).
URL's can sample ports other than 80, and can test HTTPS,
provided you have the necessary jars (JSSE)
Version 1.6 Alpha
New UI
Separation of GUI and Logic code
New Plug-in framework for new modules
Enhanced performance
Layering of test logic for greater flexibility
Added support for saving of test elements
Added support for distributed testing using a single client
Version 1.5.1
Fixed bug that caused cookies not to be read if header name case not as expected.
Clone entries before sending to sampler - prevents relocations from messing up
information across threads
Minor bug fix to convenience dialog for adding parameters to test sample.
Bug prevented entries in dialog from appearing in test sample.
Added xerces.jar to distribution
Added junit.jar to distribution and created a few tests.
Started work on new framework. New files in cvs, but do not effect program yet.
Fixed bug that prevent HTTPJMeterThread from delaying according to chosen timer.
Version 1.5
Abstracted out the concept of the Sampler, SamplerController, and TestSample.
A Sampler represents code that understands a protocol (such as HTTP,
or FTP, RMI, SMTP, etc..). It is the code that actually makes the
connection to whatever is being tested. A SamplerController
represents code that understands how to organize and run a group
of test samples. It is what binds together a Sampler and its test
samples and runs them. A TestSample represents code that understands
how to gather information from the user about a particular test.
For a website, it would represent a URL and any information to be sent
with the URL.
The UI has been updated to make entering test samples more convenient.
Thread groups have been added, allowing a user to setup multiple test to run
concurrently, and to allow sharing of test samples between those tests.
It is now possible to save and load test samples.
… and many more minor changes/improvements …
Apache JMeter 1.4.1-dev
Cleaned up URLSampler code after tons of patches for better readability. (SM)
Made JMeter send a special "user-agent" identifier. (SM)
Fixed problems with redirection not sending cookies and authentication info and removed
a warning with jikes compilation. Thanks to Wesley Tanaka for the patches (SM)
Fixed a bug in the URLSampler that caused to skip one URL when testing lists of URLs and
a problem with Cookie handling. Thanks to Graham Johnson for the patches (SM)
Fixed a problem with POST actions. Thanks to Stephen Schaub for the patch (SM)
Apache JMeter 1.4
- Jul 11 1999
Fixed a problem with POST actions. Thanks to Brendan Burns for the patch (SM)
Added close button to the About box for those window managers who don't provide it.
Thanks to Jan-Henrik Haukeland for pointing it out. (SM)
Added the simple Spline sample visualizer (JPN)
Apache JMeter 1.3
- Apr 16 1999
Run the Garbage Collector and run finalization before starting to sampling to ensure
same state every time (SM)
Fixed some NullPointerExceptions here and there (SM)
Added HTTP authentication capabilities (RL)
Added windowed sample visualizer (SM)
Fixed stupid bug for command line arguments. Thanks to Jorge Bracer for pointing this out (SM)
Apache JMeter 1.2
- Mar 17 1999
Integrated cookie capabilities with JMeter (SM)
Added the Cookie manager and Netscape file parser (SD)
Fixed compilation error for JDK 1.1 (SD)
Apache JMeter 1.1
- Feb 24 1999
Created the opportunity to create URL aliasing from the properties file as well as the
ability to associate aliases to URL sequences instead of single URLs (SM) Thanks to
Simon Chatfield for the very nice suggestions
and code examples.
Removed the TextVisualizer and replaced it with the much more useful FileVisualizer (SM)
Added the known bug list (SM)
Removed the Java Apache logo (SM)
Fixed a couple of typos (SM)
Added UNIX makefile (SD)
Apache JMeter 1.0.1
- Jan 25 1999
Removed pending issues doc issues (SM)
Fixed the unix script (SM)
Added the possibility of running the JAR directly using "java -jar
ApacheJMeter.jar" with Java 2 (SM)
Some small updates: fixed Swing location after Java 2(tm) release, license update and
small cleanups (SM)