The standard JMeter tool does not have a filter on the overall performance load test results.
Filters exist for some standard graphs and also when generating the HTML report, but it lacks a powerful global results filter tool.
It is often necessary to filter results to show only the pages and not all the URLs that make up the page. There are also "debug" or "JSR223 Groovy" samplers for intermediate calculations that are not pages and which are interesting to filter.
We can also make a global filter to remove the starting of threads (ramp-up) and the stopping of threads (ramp-down).
The filter allows you to remove from the results a warm-up period of the application at the beginning of the performance test, which often has quite high times during the first call and then significantly better times after the warm-up period.
The filter also allows for a ramp-up with several steps to filter the results step by step and therefore to have results over a time interval corresponding to the step.
The filter tool does not change the dates of the result file.
The filter tool also allows you to change the format of the output file by reading the input file in CSV or XML format and outputting a result file in CSV or XML format.
As standard with JMeter, it is quite difficult to compare the results of two or more test results. The Merge plugin greatly simplifies the comparison of multiple performance tests.
If we simply concatenate the results and there is not too much time difference between the end of the first and second performance tests, the graph results will be correct.
If the time gap between the two tests is significant, then the result will not be good visually for graphs with two blocks separated by a large space. The first performance test is at the beginning of the graph on the left, and the second performance test is at the end of the graph on the right.
The import of two result files for tests launched at quite distant times produced a graph result of KO.
The merge tool allows you to shift the start of the test to a fixed date so that the performance tests start on this fixed date and the graphs will be correct, but you have to display the times in relative duration and not in absolute date time.
You can also filter the same file 3 times with 3 different time filters by indicating the number of virtual users on a step as a prefix (, , ).
The output file (the result of merging the same file with time filters on the 3 trays) is reread in a summary report for example.
In this summary report, we find all the times on the 3 steps with the prefix of the label of the same load test.
The Filter tool is installed with the plugin management tool: Plugins Manager
URL of the plugins manager documentation. The name displayed in the plugins manager tool is: "Filter Results Tool."
The plugin installation will download the plugin library in .
Additionally, two shell scripts will be in :
An example command line to start filtering on a file is as follows:
In bold, the modification of the Java launch parameter with a maximum heap memory size of 1GB ():
Shell scripts are in .
The filter can also be done with the Maven plugin jmeter-graph-tool-maven-plugin.
In this example, the pom.xml file uses the plugin in version 1.2 and filters the result file twice.
Note that it is possible with one result filter to use a filter on labels and an offset range filter at the same time.
To install the Merge plugin, it is best to use the plugin manager (see earlier link).
The name displayed in the plugins manager tool is: "Merge Results."
The installation of the plugin will download the plugin library in .
Selection of 2 to 4 result files to merge (Input File Name): You must indicate the path to the result files to merge as well as the "Prefix label", the offset and label filters are optional.
The result file of the merge is indicated at the bottom (Merge and write results output file: Filename).
Then you must click on the "Merge" button to merge the files.
The mandatory parameters in the properties file are: