Datadog integration for Gatling

    Introduction

    The Datadog integration allows Gatling Enterprise Edition to send load-test metrics - such as response times, throughput, and error rates - directly into Datadog’s observability platform. Once enabled, performance data from Gatling Enterprise Edition is sent to Datadog, where it can be correlated with infrastructure and application metrics already collected in your Datadog account

    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.

    Prerequisites

    • A valid Datadog API key (for the metrics)
    • A valid Datadog Application key (for the events)
    • Your Datadog site
    • A Gatling Enterprise Edition account with private locations that can connect to the Datadog network.

    Install the Datadog integration

    The Datadog integration requires installation steps in your Datadog account and on your private locations control plane.

    1. See the official Datadog Integration documentation for installing Gatling Enterprise Edition in your Datadog account.

    2. See the official Datadog API/App key documentation for creating an API key and an Application key in your Datadog account.

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

    control-plane {
  locations = [
    {
      system-properties {
        "gatling.enterprise.dd.api.key" = "<your Datadog api key>"
        "gatling.enterprise.dd.application.key" = "<your Datadog application key>"
        "gatling.enterprise.dd.site" = "datadoghq.com"
      }
    }
  ]
}

    Uninstall the Datadog integration

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

    Events pushed to Datadog

    Gatling Enterprise Edition generates events for load test injection start and end.

    All events are available under the source:gatling-enterprise tag, and have the following tags:

    Short name Tag name Description
    Source source Source reference for Gatling Enterprise events
    Team team Name of the team that owns the test
    Phase phase Phase of the injection (start or end)
    Test test Test name
    Run ID run_id ID of the run

    See the official Datadog Events documentation for managing and displaying events.

    Metrics pushed to Datadog

    Gatling Enterprise Edition pushes the following list of load test metrics to Datadog:

    Short name Metric name Description
    User start gatling_enterprise.user.start_count Number of injected users
    User end gatling_enterprise.user.end_count Number of stopped users
    Concurrent user gatling_enterprise.user.concurrent Number of concurrent users
    Request gatling_enterprise.request.count Number of requests
    Response gatling_enterprise.response.count Number of responses
    Response time max gatling_enterprise.response.response_time.max Maximum response time
    Response time min gatling_enterprise.response.response_time.min Minimum response time
    Response time p95 gatling_enterprise.response.response_time.p95 Response time for the 95th percentile (95% of the requests)
    Response time p99 gatling_enterprise.response.response_time.p99 Response time for the 99th percentile (99% of the requests)
    Response time p999 gatling_enterprise.response.response_time.p999 Response time for the 99.9th percentile (99.9% of the requests)
    Response Code gatling_enterprise.response.code Response code, in the case of HTTP, the HTTP response status code
    Request Bits gatling_enterprise.bandwidth_usage.sent Outbound bandwidth usage
    Response Bits gatling_enterprise.bandwidth_usage.received Inbound bandwidth usage
    Request TCP open gatling_enterprise.tcp.open_count Number of opened TCP requests
    Request TCP close gatling_enterprise.tcp.close_count Number of closed TCP requests
    Response TCP gatling_enterprise.tcp.connection_count Number of TCP requests
    Response TCP connect time max gatling_enterprise.tcp.connect_time.min Minimum TCP response connect time
    Response TCP connect time min gatling_enterprise.tcp.connect_time.max Maximum TCP response connect time
    Response TCP connect time p95 gatling_enterprise.tcp.connect_time.p95 TCP response connect time for the 95th percentile (95% of the requests)
    Response TCP connect time p99 gatling_enterprise.tcp.connect_time.p99 TCP response connect time for the 99th percentile (99% of the requests)
    Response TLS handshake time p999 gatling_enterprise.tcp.connect_time.p999 TCP response connect time for the 99.9th percentile (99.9% of the requests)
    Response TLS gatling_enterprise.tls.handshake_count Number of TSL responses
    Response TLS handshake time max gatling_enterprise.tls.handshake_time.min Minimum TLS response handshake time
    Response TLS handshake time min gatling_enterprise.tls.handshake_time.max Maximum TLS response handshake time
    Response TLS handshake time p95 gatling_enterprise.tls.handshake_time.p95 TLS response handshake time for the 95th percentile (95% of the requests)
    Response TLS handshake time p99 gatling_enterprise.tls.handshake_time.p99 TLS response handshake time for the 99th percentile (99% of the requests)
    Response TLS handshake time p999 gatling_enterprise.tls.handshake_time.p999 TLS response handshake time for the 99.9th percentile (99.9% of the requests)

    Use metrics tags to enhance your Datadog dashboard

    Defaults Tags

    Gatling Enterprise Edition pushes the following tags to Datadog:

    Short name Tag name Description
    Team team Name of the team that owns the test
    Test test Test name
    Load generator load_generator Load generator reference integer starting with 0
    Scenario scenario Scenario name
    Status status Status of the run (OK or KO)
    Run ID run_id ID of the run

    Custom Tags

    You can add custom tags by adding system properties, either at the control-plane level or in your test configuration (except for no-code tests): gatling.enterprise.dd.tags.<custom_tag> = <your value>

    Edit this page on GitHub

    ← Integrating Other CI/CD Systems
    Dynatrace integration for Gatling →