Get startedSign in

Datadog integration

Connect Datadog to a workbench and query metrics, logs, and traces

Use the Datadog integration to give a workbench read-only access to the metrics, logs, and traces already stored in your Datadog account. After you configure the connection once, you can attach it to one or more workbenches and investigate Datadog data with natural-language prompts.

This guide uses the Plural Console UI. For the complete list of integrations and general tool behavior, see Workbench tools.

Prerequisites

Before you begin, make sure you have:

  • A Datadog account that is already receiving the metrics, logs, or traces you want the workbench to query. Installing a Datadog Agent is not required specifically for this integration; Plural queries your Datadog account through the Datadog API.
  • Permission in Plural Console to create a configured tool and edit the target workbench.
  • The hostname for your Datadog site, such as datadoghq.com. Enter only the hostname, without https://.
  • A Datadog API key and application key. Use dedicated, read-only credentials where possible.
  • An existing workbench, or permission to create one. See Setting up a workbench.
Warning:

The Console currently labels Application key as optional, but Datadog queries require both an API key and an application key. Configure both keys before using the integration.

Create credentials in Datadog

Create the organization API key:

  1. Open your account menu in Datadog and select Organization Settings.
  2. Select API Keys, then click New Key.
  3. Enter a descriptive name, create the key, and copy its value.

For the application key, a service account is recommended because its credentials are not tied to an individual user's lifecycle:

Edit on Github