InfluxDB integration for Gatling

Send load test metrics to InfluxDB.

Introduction#

The InfluxDB integration allows Gatling Enterprise Edition to send load-test metrics - such as response times, throughput, and error rates - directly into an InfluxDB time series database. Once enabled, performance data from Gatling Enterprise Edition is sent to InfluxDB, where it can be correlated with infrastructure and application metrics already collected in your InfluxDB database.

With this integration in place, you can:

• Monitor Gatling scenarios alongside server-level KPIs (CPU, memory, network) in a single dashboard.
• Investigate performance issues more effectively by overlaying load-test metrics on traces, logs, and resource utilization charts.

Compatibility#

This integration supports any backend compatible with the InfluxDB Line Protocol (ILP) over HTTP. This includes InfluxDB 1, 2 and 3, but also other products such as QuestDB.

Prerequisites#

• A valid Authorization header
• Your InfluxDB database (we support InfluxDB 1, 2 and 3)
• A Gatling Enterprise Edition account with private locations that can connect to the InfluxDB database.

Install the InfluxDB integration#

The InfluxDB integration requires installation steps on your private locations control plane.

In your control-plane configuration, in the section system-properties, add:

control-plane {
  locations = [
    {
      system-properties {
        "gatling.enterprise.influx.api.authorization" = "<your Authorization header>"
        "gatling.enterprise.influx.api.url" = "<your InfluxDB API url>"
        "gatling.enterprise.influx.useProxy" = "<true to use the same proxy as for the Gatling API>" # optional, default is false
      }
    }
  ]
}

// InfluxDB 1
Token <YOUR_API_TOKEN>

// InfluxDB 2
Token <YOUR_API_TOKEN>

// InfluxDB 3
Bearer <YOUR_API_TOKEN>

// InfluxDB 1
http(s)//host:port/api/v3/write_lp?db=mydb&precision=s

// InfluxDB 2
http(s)//host:port/api/v2/write?org=myorg&bucket=mybucket&precision=s

// InfluxDB 3
http(s)//host:port/write?db=mydb&precision=second

Uninstall the InfluxDB integration#

To remove the link between Gatling Enterprise Edition and InfluxDB, remove the lines containing gatling.enterprise.influx in your control-plane configuration.

Tables schema#

Gatling Enterprise Edition creates the following schema in your InfluxDB database:

Edit this page on GitHub