Automatically generating nice graphs at end of your Load Test with Apache JMeter and JMeter-Plugins



You are using Apache JMeter for your Load Tests.

Once test has ended, you would like your favorite tool to automatically generate for you nice and meaningful graphs so that you can faster analyze your test results and include them in your report.

Apache JMeter is great in many ways but its core lacks this built-in feature, but it’s plugin Architecture will let us add it easily.

Hopefully a great must have Open Source and free third-party library called JMeter-Plugins comes to the rescue.

Before version 1.1.3 of JMeter-Plugins, you could use JMeterPluginsCMD Command Line Tool to generate your graphs in a shell, but this was not optimal.

As users of both Apache JMeter and JMeter-Plugins, we decided to contribute this new feature to JMeter-Plugins.

Our philosophy is :

  • « If you use an Open-Source and free project, be grateful, always contribute in a way »

About author:

Philippe Mouawad works as an Architect and technical expert for Ubik-Ingenierie where he leads among other things the development of UbikLoadPack a set of Commercial Plugins for Apache JMeter allowing to load test different protocols like HLS, GWT, Flex.
Philippe is a committer on the Apache JMeter project and member of the PMC since October 2011.
Finally he is a co-author of a french book on JMeter called Maîriser JMeter: Du test de charge à Devops.

Feature Overview

To automatically generate your reports just add a new Listener called « jp@gc Graphs Generator« .


















You can define the following properties:

PropertyDescription/Possible Values

Graph width in pixels

for PNG only – width of the image, default is 800
Graph height in pixelsfor PNG only – height of the image, default is 600
granulation time for samples

granulation time for samples
relative-times <true/false>use relative X axis times, no will set absolute times
Aggregate all Rows into one

Paint gradient background

Paint markers

paint markers
Paint zeroing lines

paint zeroing lines
paint-markers <yes/no>paint markers on data points (since 1.1.3)
prevent-outliers <yes/no>prevent outliers on distribution graph
Limit number of points in row

limit number of points in row
Force Y axis limitForce input value as Y axis limit
Low count limit

hide points with sample count below input limit
success-filter <true/false/Undefined>filter samples by success flag (since 0.5.6), possible values are:

  • true: Only successful samples will be graphed
  • false : Only failing samples will be graphed
  • Undefined means no filtering on success flag will occur.
Include only samplesComma-separated list of samples to be graphed
Exclude samplesExclude from report samples with specified labels, comma-separated

enable/disable auto-scale multipliers for perfmon/composite graph
line thickness for graph rowsline thickness for graph rows

JMeter Setup:

JMeter-Plugin installation:

  • Use JMeter version >= 2.10
  • Download extras bundle and unzip it, copy lib/ext/JMeterPlugins-Extras.jar to <jmeter home>/lib/ext.
  • Restart jmeter.

JMeter Configuration:

Edit <jmeter home>/bin/ and ensure you set these properties:

# This will enable correct graphs display 

# which deal with threads after reloading the results file.;

# This is needed to ensure all results are 

# available when Listener runs

Test Plan setup:

If using distributed testing, ensure you add to your Thread Group names:

${__machineName()}_My Threadgroup name

Test Plan example:

We will use a test plan you can easily create with Templates…> Building a Web Test Plan

We just added an Http Cookie Manager and removed Graph Results listener.

We end up with this, the only listener is the new jp@gc Graphs Generator


Let’s run plan:

Now run this plan in NON-GUI mode as per JMeter Best-Practices using following command-line:

./jmeter -t GraphsReportListener-GenerationAtEndOfTestNonGUI.jmx -n

  -l /data/jmeter/test-results.csv


Notice the following:

  1. -t GraphsReportListener-GenerationAtEndOfTestNonGUI.jmx : Means use following jmx file GraphsReportListener-GenerationAtEndOfTestNonGUI.jmx
  2. -n : Means NON GUI
  3. -l /data/jmeter/test-results.csv : Means output results in following file
  4. -JTEST_RESULTS_FILE=/data/jmeter/test-results.csv : Notice we set the same value as output file in 3). We set this because in « jp@gc Graphs Generator » we have used __P function in JMeter to replace TEST_RESULTS_FILE by the value we input in -J:
    • ${__P(TEST_RESULTS_FILE,/data/jmeter/test-results.csv)}



In this configuration, notice we have decided to only include 2 samples:

  • Home Page
  • Changes

In a real worl scenario, you would use Transaction Controller for meaningful transaction names and only include those in your report.


At end of test JMeter automatically generated in <jmeter home>/bin folder the following files:




Response Times over time:


Hits Per Second:


Bytes throughput over time:


Latencies over time:


Response codes per second:


Response times distribution:


Response times percentiles:


Threads state over time:


Time vs Threads:


Transactions per second:


Throughput vs Threads:


Other Features

Graphs Generator Listener can also generate CSV files besides PNG files.

Graph Generator Listener can even generate graphs for existing results, to do so, create a fake plan like the following:


Run it in GUI or NON-GUI mode, the graphs will be generated.

Ensure you use the same properties configuration you used during the test that generated the results you are graphing.


With this new Graphs Generator Listener , you can now easily:

  • Generate meaningful and sexy graphs at the end of your test
  • Generate meaningful and sexy graphs for existing results any time you want
  • Output CSVs with computed datas at end of your test if you want to use custom graphs
  • Output CSVs with computed datas for existing results any time you want if you want to use custom graphs

About us:


    Comments are closed.