> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Datadog

> Query Datadog monitors, dashboards, metrics, and logs

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `DD_API_KEY` is sent as the `DD-API-KEY` header.
* **Docs**: [https://docs.datadoghq.com/api/latest/authentication/](https://docs.datadoghq.com/api/latest/authentication/)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable     | Required | Description                                                                                                                      |
| ------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `DD_API_KEY` | Yes      | Datadog API key [Docs](https://docs.datadoghq.com/account_management/api-app-keys/).                                             |
| `DD_APP_KEY` | Yes      | Datadog application key (scoped to the user who created it) [Docs](https://docs.datadoghq.com/account_management/api-app-keys/). |

## Setup

1. **Find your Datadog site**: Check the URL you use to access Datadog (e.g. app.datadoghq.com → site datadoghq.com, app.datadoghq.eu → datadoghq.eu). Tools take a 'site' parameter that defaults to datadoghq.com.
2. **Create an API key**: In Organization Settings → API Keys ([https://app.datadoghq.com/organization-settings/api-keys](https://app.datadoghq.com/organization-settings/api-keys)), create a key and add it to your .env as DD\_API\_KEY.
3. **Create an application key**: In Organization Settings → Application Keys, create a key and add it as DD\_APP\_KEY. Application keys inherit the permissions of the user who created them; read access to monitors, dashboards, metrics, and logs is required.
4. **Verify access**: Run the Validate API Key tool, then List Monitors.

* Datadog authenticates with two headers: DD-API-KEY and DD-APPLICATION-KEY - both env vars are required
* If your org is not on datadoghq.com, pass your site (e.g. datadoghq.eu) as the 'site' parameter on each tool call

Provider API reference: [https://docs.datadoghq.com/api/latest/](https://docs.datadoghq.com/api/latest/)

## Tools

| Tool                     | Access | Description                                        |
| ------------------------ | ------ | -------------------------------------------------- |
| Validate API Key         | Read   | Check that the configured Datadog API key is valid |
| List Monitors            | Read   | List monitors with optional name or tag filtering  |
| Get Monitor              | Read   | Get details and current state of a monitor         |
| Mute Monitor             | Write  | Mute notifications for a monitor                   |
| List Dashboards          | Read   | List all dashboards                                |
| Query Timeseries Metrics | Read   | Query timeseries metric data over a time window    |
| Search Logs              | Read   | Search log events with a Datadog log query         |

## Example prompts

* List my Datadog monitors that are currently in Alert state.
* Search Datadog logs for errors in the last 15 minutes and summarize them.