Skip to content

Advanced Configuration Files

The Configuration files tree gives you access to all files used to configure Gatling's tasks execution.

Warning

Modifying these files may break the application! USE WITH CAUTION!

Directory Structure

Here is the directory structure of the configuration folders and files:

Gatling Files

Conf Files

The conf directory contains 3 sub-folders: GATLING_DEBUG, GATLING_RECORD and GATLING_RUN. As their names indicates, the GATLING_RUN folder has all Gatling's configuration for when you run a load test, and the DEBUG folder for when you debug a test. The RECORD folder has all Gatling's configuration for when you import an HAR file.

These folders contains:

Info

The gatling.conf of the RUN folder is configured to use the Graphite connector (gatling.data.graphite).

Note

The logback.xml file of the DEBUG folder is configured to redirect printed out messages to the executions logs.

It also generates the galting.log file.

Result Files

The results folder contains all results ran on Kraken, one sub-folder for each test or HAR import (named with the automatically generated task id).

These result sub-folders always contain a result.json file:

{
  "id": "ea5ef73a-8566-445f-ad62-1806a95d9891",
  "startDate": 1560326711581,
  "endDate": 1560326783284,
  "status": "COMPLETED",
  "runDescription": "BasicSimulation",
  "type": "DEBUG"
}

It stores the result id, status, start and en date as well as the description and the type of test (run, debug or HAR import).

Apart from this file, the contents of these result sub-folders vary depending of the type of test:

  • For HAR import, only a debug folder is present, it contains the result of the HAR to debug entries convertions.
  • For test debugs, a gatling.log file is also generated and parsed by the kraken-log-parser Docker container to generate the debug chunks.
  • For test executions, additional sub-folders contains the HTML report generated by Gatling for each host.

Grafana Files

The grafana folder only contains the default Grafana dashboard: grafana-gatling-dashboard.json.

{
  "annotations": {
    "list": [
      {
        "builtIn": 1,
        "datasource": "-- Grafana --",
        "enable": true,
        "hide": true,
        "iconColor": "rgba(0, 211, 255, 1)",
        "name": "Annotations & Alerts",
        "type": "dashboard"
      }
    ]
  }
  [...]
}

You may edit this file to change the default dashboard generated each time you run a load test.

The easiest way is to update a generated dashboard directly in Grafana and then export it as a new JSON file.

Telegraf Files

The telegraf folder only contains the telegraf.conf file, used to configure Telegraf when running a load test with Gatling.