Documentation Plugins Datadog data source

Datadog data source

Datadog is a popular monitoring and analytics tool. The Datadog data source plugin lets you query and visualize Datadog metrics, logs, traces, and events in Grafana.

Supported features

The Datadog data source supports the following features:

Requirements

The Datadog data source has the following requirements:

• A Datadog account.
• A Grafana Cloud Pro or Advanced plan, or an activated self-managed Grafana Enterprise license. Contracted Cloud customers should refer to their agreement.

Get started

The following documents help you get started with the Datadog data source:

• Install the Datadog data source
• Get started with Datadog on Grafana Cloud
• Configure the Datadog data source
• Datadog query editor
• Template variables
• Troubleshooting

Additional features

After you configure the Datadog data source, you can:

• Add Annotations to overlay Datadog events on your graphs.
• Configure and use Template variables for dynamic dashboards.
• Add Transformations.
• Set up Alerting to monitor your Datadog data.
• Use Grafana Assistant to query your Datadog data with natural language prompts.

Get an API key and application key from Datadog

The Datadog data source authenticates with an API key and an application key. Both are unique to your Datadog organization.

To create the keys, complete the following steps:

1. Sign in to your Datadog account.
2. To create an API key, refer to Add an API key or client token in the Datadog documentation.
3. To create an application key, refer to Add application keys in the Datadog documentation.

The application key works with the API key to grant access to the Datadog API. By default, an application key has the permissions of the user who created it. Some query types require specific Datadog permissions on the application key. For example, monitor queries require the monitors_read permission. For the full list of permissions by query type, refer to API key and application key permissions.

After you generate both keys, add them to the data source. For more information, refer to Configure the Datadog data source.

Grafana Assistant

If you have Grafana Assistant enabled, you can query your Datadog data source with natural language instead of building queries by hand. Assistant discovers the metrics, tags, and hosts available in your Datadog data source and runs queries on your behalf.

To query Datadog with Assistant, open Assistant and mention your Datadog data source with the @ prefix in your prompt. For example:

• Query @datadog-ds for average CPU usage grouped by host over the last hour.
• Search logs in @datadog-ds for errors in the web service over the last 30 minutes.

For the full list of supported prompts and data sources, refer to Query data in the Grafana Assistant documentation.

Import a dashboard for Datadog

The Datadog data source includes the following pre-built dashboards:

• Disk IO
• Docker
• System metrics
• Monitors explorer

For instructions on how to import dashboards in Grafana, refer to Import a dashboard.

To view the list of pre-built Datadog dashboards, complete the following steps:

1. Go to Connections in the sidebar menu.
2. Under Connections, click Data sources.
3. Type Datadog in the search bar and select the Datadog data source.
4. Go to the Dashboards tab to view the list of pre-built dashboards.
5. Click Import to import the pre-built dashboard.

Plugin updates

Always ensure that your plugin version is up-to-date so you have access to all current features and improvements. Navigate to Plugins and data > Plugins to check for updates. Grafana recommends upgrading to the latest Grafana version, and this applies to plugins as well.

To review the changes in each release, refer to the Datadog data source CHANGELOG.