Datadog Integration
Connect Datadog to enable the AI agent to query metrics, logs, APM traces, and incidents during investigations.
Capabilities
Once connected, the AI agent can:
| Capability | Description |
|---|---|
| Query Metrics | Fetch time-series metrics for any Datadog metric |
| Search Logs | Search and analyze log data with filters |
| APM Traces | Retrieve distributed traces for request analysis |
| View Incidents | Access Datadog incident data |
| Check Monitors | Review monitor status and alert history |
Prerequisites
- A Datadog account with API access
- An API Key and Application Key
- Read permissions for the data you want to query
Setup
1
Get Your API Keys
- Log in to your Datadog account
- Navigate to Organization Settings → API Keys
- Create or copy an existing API Key
- Navigate to Organization Settings → Application Keys
- Create or copy an existing Application Key
2
Add Integration in Autoheal
- Go to Integrations in Autoheal
- Click Datadog
- Enter a name (e.g., "Production Datadog")
3
Configure Credentials
Enter the following:
- API Key: Your Datadog API key
- Application Key: Your Datadog application key
- Site: Select your Datadog site (e.g.,
datadoghq.com,datadoghq.eu)
4
Test and Save
Click Test Connection to verify, then Save.
Required Permissions
The API key should have at least these permissions:
| Permission | Why It's Needed |
|---|---|
metrics_read | Query metrics data |
logs_read | Search log data |
apm_read | Access APM traces |
monitors_read | View monitor status |
incidents_read | Access incident data |
tip
Create a dedicated API key for Autoheal with only the permissions listed above. Avoid using keys with write permissions.
Datadog Sites
Select the correct site based on where your Datadog account is hosted:
| Site | URL |
|---|---|
| US1 (default) | datadoghq.com |
| US3 | us3.datadoghq.com |
| US5 | us5.datadoghq.com |
| EU | datadoghq.eu |
| AP1 | ap1.datadoghq.com |
| US1-FED | ddog-gov.com |
Example Queries
Once connected, you can ask the AI agent questions like:
Show me CPU usage for the payment service over the last hour
Search logs for errors in the checkout service since 2pm
What monitors are currently alerting?
Show me the slowest traces for the /api/orders endpoint
Troubleshooting
403 Forbidden Error
- Verify both API Key and Application Key are correct
- Check that the keys have the required permissions
- Ensure you're using the correct Datadog site
No Data Returned
- Verify the time range includes data
- Check that the metric/log query syntax is correct
- Ensure the API key has access to the requested data
Connection Timeout
- Check your Datadog site selection
- Verify network connectivity to Datadog APIs