At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
DD_API_KEYis sent as theDD-API-KEYheader. - Docs: https://docs.datadoghq.com/api/latest/authentication/
Credentials
Set these per environment. See Connect an integration.Setup
- 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.
- Create an API key: In 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.
- 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.
- 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
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.