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
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.