Awesome

About Gatling report

This is a reporting tool that parses Galting result files (aka simulation.log) and creates HTML reports with Plotly charts or CSV output.

gatling-report examples

A report is a single standalone html file, here are some examples:

Simulation report: compact representation of response time for a bench, help to pinpoint slow requests.
Differential report: compare 2 bench result.
Trend report: follow the trend of bench results over time.
Default CSV output

Install

Download

Take the latest jar from nexus.

Building from sources

Create the all in one jar:

    mvn package

The jar file that include all its dependencies is located here:

    ./target/gatling-report-VERSION-capsule-full.jar

Usage

Help

    java -jar path/to/gatling-report-VERSION-capsule-fat.jar -h

Output CSV stats

The following command will output to stdout a CSV with stats per request.

    java -jar path/to/gatling-report-VERSION-capsule-fat.jar path/to/simulation.log
    
    scenario        request start   startDate       duration        end     count   successCount    errorCount      min     p50     p95     p99     max     avg     stddev  rps	apdex	rating
    sim50bench      _all    1446578664151   2015-11-03 20:24:24     62.16   1446578726313   2397    2397    0       0       10      598     940     1938    104.40  205     38.56	0.88	Good
    sim50bench      Logout  1446578664151   2015-11-03 20:24:24     62.16   1446578725039   21      21      0       1       2       15      17      17      2.38    3       0.34	1.00	Excellent
    ...

Header	Description
`scenario`	Name of the scenario in the simulation
`request`	Name of the request, `_all` is the total of all requests in the simulation
`start`	start timestamp of the simulation
`startDate`	start date of the simulation
`duration`	duration of the simulation
`end`	last request timestamp
`count`	total number of request
`successCount`	number of requests with the OK status
`errorCount`	number of requets with the KO status
`min`	minimum elapsed duration for the request
`p50`, `p95`, `p99`	percentile 50, 95 and 99
`avg`	average
`stddev`	standard deviation
`rps`	average request per second for the simulation duration
`apdex`	Apdex score converts many measurements into one number on a uniform scale of 0-to-1
`rating`	Apdex rating

You can also submit multiple simulation files, the output will concatenate stats.

    java -jar path/to/gatling-report-VERSION-capsule-fat.jar path/to/simulation.log [path/to/simulation2.log ...]

You can also submit gzipped simulation files:

    java -jar path/to/gatling-report-VERSION-capsule-fat.jar path/to/simulation.log.gz

Generate HTML report with Plotly charts

When using the -o REPORT_PATH option a report is generated.

When submitting a single simulation file it creates a simulation report:

   java -jar path/to/gatling-report-VERSION-capsule-fat.jar path/to/simulation.log.gz -o /path/to/report/directory

When submitting two simulations files it creates a differential report:

   java -jar path/to/gatling-report-VERSION-capsule-fat.jar path/to/ref/simulation.log.gz path/to/challenger/simuation2.log -o /path/to/report/directory

When submitting more than two simulations files it creates a trend report.

Customizing the report

You can use your own mustache template to customize the report:

    java -jar path/to/gatling-report-VERSION-capsule-fat.jar --template /my/template.mustache path/to/ref/simulation.log.gz -o /path/to/report/directory

Take example to the default templates located in src/main/resources.

Note that Plotly charts can be edited online.

Limitations

It has been tested successfully with default Gatling 2.5, 2.4, 2.3.1, 2.1.7, 3.0.0 and 3.2.1 and 3.3.0 simulation.log format.

About Nuxeo

Nuxeo provides a modular, extensible Java-based open source software platform for enterprise content management and packaged applications for document management, digital asset management and case management. Designed by developers for developers, the Nuxeo platform offers a modern architecture, a powerful plug-in model and extensive packaging capabilities for building content applications.

More information on: http://www.nuxeo.com/