Skip to main content

​
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:
CapabilityDescription
Query MetricsFetch time-series metrics for any Datadog metric
Search LogsSearch and analyze log data with filters
APM TracesRetrieve distributed traces for request analysis
View IncidentsAccess Datadog incident data
Check MonitorsReview 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

  1. Log in to your Datadog account
  2. Navigate to Organization Settings → API Keys
  3. Create or copy an existing API Key
  4. Navigate to Organization Settings → Application Keys
  5. Create or copy an existing Application Key
2

Add Integration in AccelOS

  1. Go to Integrations in AccelOS
  2. Click Datadog
  3. 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:
PermissionWhy It’s Needed
metrics_readQuery metrics data
logs_readSearch log data
apm_readAccess APM traces
monitors_readView monitor status
incidents_readAccess incident data
Create a dedicated API key for AccelOS 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:
SiteURL
US1 (default)datadoghq.com
US3us3.datadoghq.com
US5us5.datadoghq.com
EUdatadoghq.eu
AP1ap1.datadoghq.com
US1-FEDddog-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

  • 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
  • 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
  • Check your Datadog site selection
  • Verify network connectivity to Datadog APIs