Gatling Enterprise

Supported OS Linux

Integration version1.1.0
Gatling Enterprise Overview dashboard - Responses and Requests
Gatling Enterprise Overview dashboard - Response Time
Gatling Enterprise Overview dashboard - Users

Overview

Gatling Enterprise is a load testing platform designed to help teams validate application scalability and performance under real-world traffic conditions.

With the Datadog integration, teams can investigate performance issues by correlating load test metrics such as response times, throughput, and errors with infrastructure data tracked in Datadog.

Gatling Enterprise sends metrics to Datadog, allowing engineering and SRE teams to centralize performance insights and improve decision-making around scalability and reliability.

Setup

Note: This integration is available for Gatling Enterprise customers. To learn more about Gatling Enterprise and get started for free, visit gatling.io/products.

  1. In Datadog, navigate to Integrations, select the Gatling Enterprise tile, and click Install Integration.

  2. In your Gatling control-plane installation, edit your configuration file. In the section system-properties, add the parameters as follows. Replace YOUR_API_KEY with your Datadog API key and use the correct Datadog site for your organization:

control-plane {
  locations = [
    {
      id = "prl_example"
      # ... other configuration for your location
      system-properties {
        "gatling.enterprise.dd.api.key" = "YOUR_API_KEY" # Fill your API key here
        "gatling.enterprise.dd.site" = "datadoghq.com"  # Replace with your Datadog site
      }
    }
  ]
}
  1. Deploy and restart your control plane

Data Collected

The Gatling Enterprise integration gathers all metrics for databases, nodes, and shards.

Metrics

gatling_enterprise.user.start_count
(count)		Number of injected users
Shown as user
gatling_enterprise.user.end_count
(count)		Number of stopped users
Shown as user
gatling_enterprise.user.concurrent
(count)		Number of concurrent users
Shown as user
gatling_enterprise.request.count
(count)		Number of requests
Shown as request
gatling_enterprise.response.count
(count)		Number of responses
Shown as response
gatling_enterprise.response.response_time.max
(gauge)		Maximum response time
Shown as second
gatling_enterprise.response.response_time.min
(gauge)		Minimum response time
Shown as second
gatling_enterprise.response.response_time.p95
(gauge)		Response time for the 95th percentiles (95% of the requests)
Shown as second
gatling_enterprise.response.response_time.p99
(gauge)		Response time for the 99th percentiles (99% of the requests)
Shown as second
gatling_enterprise.response.response_time.p999
(gauge)		Response time for the 99.9th percentiles (99.9% of the requests)
Shown as second
gatling_enterprise.response.code
(count)		HTTP status codes of the response
gatling_enterprise.request.bits
(count)		Outbound bandwidth usage
Shown as bit
gatling_enterprise.response.bits
(count)		Inbound bandwidth usage
Shown as bit
gatling_enterprise.request.tcp.open_count
(count)		Number of opened TCP requests
Shown as request
gatling_enterprise.request.tcp.close_count
(count)		Number of closed TCP requests
Shown as request
gatling_enterprise.response.tcp.count
(count)		Number of TCP requests
Shown as request
gatling_enterprise.response.tls.count
(count)		Number of TSL responses
Shown as response
gatling_enterprise.response.tcp.connect_time.min
(gauge)		Minimum TCP response connect time
Shown as second
gatling_enterprise.response.tcp.connect_time.max
(gauge)		Maximum TCP response connect time
Shown as second
gatling_enterprise.response.tcp.connect_time.p95
(gauge)		TCP response connect time for the 95th percentiles (95% of the requests)
Shown as second
gatling_enterprise.response.tcp.connect_time.p99
(gauge)		TCP response connect time for the 99th percentiles (99% of the requests)
Shown as second
gatling_enterprise.response.tcp.connect_time.p999
(gauge)		TCP response connect time for the 99.9th percentiles (99.9% of the requests)
Shown as second
gatling_enterprise.response.tls.handshake_time.min
(gauge)		Minimum TLS response handshake time
Shown as second
gatling_enterprise.response.tls.handshake_time.max
(gauge)		Maximum TLS response handshake time
Shown as second
gatling_enterprise.response.tls.handshake_time.p95
(gauge)		TLS response handshake time for the 95th percentiles (95% of the requests)
Shown as second
gatling_enterprise.response.tls.handshake_time.p99
(gauge)		TLS response handshake time for the 99th percentiles (99% of the requests)
Shown as second
gatling_enterprise.response.tls.handshake_time.p999
(gauge)		TLS response handshake time for the 99.9th percentiles (99.9% of the requests)
Shown as second

Uninstallation

  1. In Datadog, navigate to Integrations, select the Gatling Enterprise tile, and click Uninstall Integration.

  2. In your Gatling control-plane installation, edit your configuration file. In the section system-properties, remove the lines containing gatling.enterprise.dd.

  3. Deploy and restart your control plane.

Support

Need help? Contact Gatling Enterprise support.