docs
Cloud

Creating and running a test

Analyzing Results

Manage

Integrations

Project and Team Management

Billing & User Menu

Cloud REST API

Cloud FAQ

k6.ioapp.k6.io

No results for “”

Powered byAlgolia
Cloud
Integrations
Cloud APM
DataDog

DataDog

suggest edits

With this integration, you can export test result metrics from the k6 Cloud to DataDog. That allows querying, visualizing and correlating k6 metrics with other monitored metrics in Datadog.

⭐️  Cloud APM integrations are available on Pro and Enterprise plans, as well as the annual Team plan and Trial.

DataDog settings

To set up the integration on the k6 Cloud, you need the following DataDog settings:

  • API key
  • Application key

Follow this guide to get your API and application keys.

Supported Regions

The supported regions for the DataDog integration are:

  • eu: Europe.
  • us: rest of the world (default).

API and Application keys for a DataDog region won't work on a different region.

k6 Cloud test configuration

You have to enable the DataDog integration for each test that you want to export its test result metrics.

Once you have set up the DataDog settings in the test, you can run a cloud test as usual. When running the cloud test, the k6 Cloud will continuously send the test results metrics to DataDog.

Currently, there are two options to set up the Cloud APM settings in the test:

Configuration using the test builder

First, you have to configure the DataDog integration for an organization. Click the Cloud APM option on the left sidebar menu under the Manage section, and select DataDog from the list.

Cloud APM - DataDog Form UI

In this form, set the API and application keys that you copied previously from DataDog. For more information on the other input fields, see configuration parameters.

Save the DataDog configuration for the current organization.

Note that configuring the DataDog settings for an organization does not enable the integration. You have to enable it manually for each test using the test builder.

now, create a new test with the test builder or select a test - previously created with the test builder. click the cloud apm option on the test builder sidebar to enable the integration for the test.

Cloud APM - DataDog Test Builder UI

Configuration in the k6 script

If you script your k6 tests, you can also configure the Cloud APM settings using the apm option in the k6 script.

The parameters to export the k6 metrics to DataDog are as follows:

export const options = {
  ext: {
    loadimpact: {
      apm: [
        {
          provider: 'datadog',
          apiKey: '<Datadog Provided API key>',
          appKey: '<Datadog Provided App key>',


          // optional parameters
          region: 'us',


          metrics: ['http_req_sending', 'my_rate', 'my_gauge'], // ...
          includeDefaultMetrics: true,
          includeTestRunId: false,
        },
      ],
    },
  },
};

Configuration parameters

NameDescription
provider(required)For this integration, the value must be datadog.
apiKey(required)DataDog API key.
appKey(required)DataDog application key.
regionThe region supported by DataDog. See the list of supported regions. Default is us.
includeDefaultMetricsWhether it exports the default APM metrics: data_sent, data_received, http_req_duration, http_reqs, iterations, and vus. Default is true.
metricsList of built-in and custom metrics to export.
includeTestRunIdWhether all the exported metrics include a test_run_id tag whose value is the k6 Cloud test run id. Default is false.
Be aware that enabling this setting might increase the cost of your APM provider.
resampleRateThe rate by which the metrics are resampled and sent to the APM provider in seconds. Default is 3 and acceptable values are integers between 1 and 10.

See also

previousAzure Monitor