gatling-scenario-graphs

A simple python script, which will consume the Gatling Logs to give a html page, which will have scenario based graphs.

User manual for gatling-scenario-graphs v1.0

Table of contents

• Requirements
• Setup from Scratch
• Quick Start
  • Command to run script
  • Checking out Graph
  • Exploring Graph

Requirements

• Python 3 or up
• Pandas Library
• Bokeh Library

If you are newbie, then please refer to section - Setup from Scratch

Setup from Scratch

If you are running for the first time or have no clue how to setup, then follow these steps:

• Setting up on Windows Machine:
  1. Download latest release of Python.
  2. Install Pandas.
  3. Install Bokeh:

      pip install bokeh
  

Quick Start

Step 1: Command to run script

python create_gatling_scenario_graphs.py -i <location of Gatling Log Files separated by ,> -o <output location of the Graph HTML Page> -p <percentile> -t <timezone +/- hrs>

Eg:

python create_gatling_scenario_graphs.py -i C:\Logs\simulation_log1.log,C:\Logs\simulation_log2.log -o C:\Graphs\LoadTest_run1.html -p 99 -t 10.5

Arguments o, p and t are optional. Default value of:

• o is same folder as that of script.
• p is 95 percentile
• t is 'O' (zero) - means it will take the same time as in Gatling Logs

More on Timezone Argument Eg: If your timezone is UTC(GMT) + 10.5, then 't' will be 10.5

Note: Log Files, should be given without any spaces

If successful, you should see something like below:

Step 2: Checking out Graph

A sample graph looks like this. Please find below some sample screenshots.

95th vs RPS (Requests Per Second)

95th vs Users

95th vs Errors

Step 3: Exploring Graph

Graph can be explored by using following tools:

• Zoom in
• Reset Graph
• Save Graph as PNG
• Hover

These tools can be found in the toolbar present under every plot. Toolbar looks like:

• Select/Deselect Transactions from Legend, as shown below:

• When Hover and Zoom are selected, a Graph looks like: