Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time


Performance test dashboard

Dashboard app for organizing, analyzing, benchmarking and reporting of test results of performance tests executed with Gatling Tool, JMeter or LoadRunner (see LR2Graphite and LRLauncher). The load related metrics are stored in Graphite together with for instance resource usage metrics of the application under test. Any metric stored in Graphite can be benchmarked between test runs, to provide automated assertions on the performance of an application when running tests from a continuous integration pipeline.

Automated test result analysis and benchmarking

The targets-io dashboard can automatically benchmark test results to prevent you from spending a lot of time analysing your continuous performance test runs. The dashboard does the following benchmarks:

  • Requirements: check if the results meet the requirements set for a metric.
  • Benchmark to previous test run: check if metric deviations, compared to the last test run, stay within configured allowed deviation. This benchmark will give you immediate feedback on the last commits on your code.
  • Benchmark to fixed baseline: check if metric deviations, compared to fixed baseline (for instance your current live version), stay within configured allowed deviation.

The requirements / benchmark thresholds can be set on any of the metrics you have configured in your dashboard. The consolidated test run results are exposed via a REST API and can be used to pass or fail your build in your CI server.


To set up a local demo environment take the following instruction steps for Linux Ubuntu:

  • Install docker
  • Install docker compose
  • Clone this repository: git clone
  • Change directory into targets-io: cd targets-io
  • Run init script to prepare Graphite volumes on host: sudo ./
  • Run start up script: sudo ./ localhost # set host ip here if running on server


Another approach is to use Vagrant and VirtualBox to create a virtual machine. This way the setting up of the environment is completely automated. You can use the following steps:

  • Install Vagrant and VirtualBox
  • Install the vagrant-docker-compose plugin using the command line: vagrant plugin install vagrant-docker-compose
  • Use this Vagrantfile to generate a box. Place file in a directory of your choosing and use command line in that directory: vagrant up.

shortcut using curl: curl -O && vagrant up

The end result will be 9 started docker containers:

Container Description Exposed port
targets-io Performance dashboard application 80
mongodb Database to store dashboard configurations 27017
graphite Time based series database 8070
jenkins CI server to start demo scripts 8080
mean Demo application to run performance tests against 3001
redis Used for caching calls to Graphite -
logstash Used for parsing Gatling logs -
graylog Used for browsing Targets-io, demo app and Gatling logs 8090
elasticsearch Used by Graylog -

Open the targets-io performance dashboard via


First restore the pre-configured demo dashboard configurations via the menu in the right top of the screen

Select the configuration file from the repo (targets-io/demo/targets-io-demo.json) and click "upload me". After reloading the page you should see one "Product": "MEAN"

To start one of the demo scripts open the Jenkins console


Log in using the credentials admin/targets-io

Assertions demo

To see a demo of the automated assertion of benchmark results of a test run, start the TARGETS-IO-GATLING-DEMO job (click "Build now"). This will trigger the Gatling demo script

  • After the first run has finished, go to http://localhost/#!/browse/MEAN/GATLING-NIGHTLY/to check the results.
  • Rerun the the TARGETS-IO-GATLING-DEMO job.
  • When this build passes it means all your configured requirements / benchmark thresholds (see explanation above) have passed for this run. If the job fails, check the job logs to find out why and examine http://localhost/#!/browse/MEAN/GATLING-NIGHTLY/ to investigate. You can drill down the consolidated results by clicking on the passed/failed icons.

Graylog integration demo

In the demo environment the Gatling logs are parsed by Logstash and send to Graylog (and Graphite). The demo application also sends logs to Graylog, so you can correlate errors in Gatling to errors logged in the application. In order to do this you have to manually enable a listener in Graylog:

  • Log into Graylog with credentials admin/admin
  • Select System - Inputs from the menu
  • Select GELF UDP from the dropdown list and click "Launch new input"
  • Provide a name, select the node and launch the input.

To correlate Gatling and application errors use the following search query:

type:gatling_log AND facility:MEAN

You can also drilldown from Targets-io to Graylog from the Gatling - errors tab in the graphs view for a test run.

JMeter integration demo

The TARGETS-IO-JMETER-DEMO job triggers the JMeter demo script to demo how to integrate a JMeter script in the framework.

LoadRunner integration demo

The TARGETS-IO-LOADRUNNER-DEMO job triggers the LoadRunner TruClient demo script to demo how to integrate a LoadRunner script in the framework. This requires a Windows Jenkins Agent to be connected as "LOADRUNNER-SLAVE". Please refer to the LR2Graphite documentattion on how to setup this machine.

Update your demo environment

The targets-io image on Docker hub is updated frequently. To deploy the latest version in your demo environment, use sudo docker-compose stop targetsio, sudo docker-compose pull targetsio and sudo docker-compose up -d to update!


Wiki (in progress)

Libraries / Dependencies