DataDog

Configuration Parameters

The configuration parameters for sending metrics to DataDog and its EU counterpart are as follows:

warning!

As of Jan. 2021, all keys on the configuration parameters object are in camel case. So, please update your test run script(s). Also, the datadogeu provider is now set using region key.

The metrics parameter allows you to specify built-in and custom metrics to be exported to the APM provider. By default, only the basic metrics listed below are exported. These defaults also match the official k6 dashboard for Datadog, which you can read more about on visualization of metrics in Datadog.

• data_sent
• data_received
• http_req_duration
• http_reqs
• iterations
• vus

📖 Use case

A typical use case is to only export custom metrics defined in the script. To do that you should specify the names of your custom metrics in the metrics parameter, and set includeDefaultMetrics to false.

If you want to export metrics with more granularity, consider using a lower number for the resampleRate, like 1.

The apm key (inside ext.loadimpact) accepts a list of APM configurations (objects). Exporting metrics to APM platforms will be simultaneous and near real-time. Also, there is a 2nd pass (of metrics exports), at the end of each test run, that ensures data reliability and accuracy. Please note that the data exported in real-time may appear incorrect until the test is finished.

Example Configuration Object

All the above configuration parameters are passed like this in your test run.

export let options = {
  ext: {
    loadimpact: {
      apm: [
        {
          provider: "datadog",
          apiKey: "<Datadog Provided API key>",
          appKey: "<Datadog Provided App key>",
          metrics: ["http_req_sending", "my_rate", "my_gauge", ...],
          includeDefaultMetrics: true,
          includeTestRunId: false
        },
      ]
    },
  },
};

Supported Regions

These are the supported regions for DataDog integration:

DataDog Setup

This guide will walk you through creating an apiKey and an appKey on Datadog. Note that the apiKey and appKey for different regions of datadog won't work on other regions.