Datadog Integration
Overview
OpsWorker integrates with Datadog in two ways:
| Integration | Purpose |
|---|---|
| Alert webhook | Receive Datadog monitor alerts for investigation |
| API integration | Enable the Datadog AI Agent to query metrics, traces, and monitors |
Alert Webhook Setup
1. Create a Webhook in Datadog
- In Datadog, go to Integrations → Webhooks
- Click New Webhook
- Name:
opsworker - URL: Your OpsWorker webhook URL (from the portal)
- Leave payload as default
- Click Save
2. Add to Monitors
Add @webhook-opsworker to the notification text of monitors you want OpsWorker to investigate.
3. Verify
Trigger a test alert from a configured monitor. Check the OpsWorker portal for incoming signals.
API Integration Setup
The API integration enables the Datadog AI Agent to query metrics, traces, and monitors during investigations.
1. Create API and Application Keys
- In Datadog, go to Organization Settings → API Keys and create or copy an API key
- Go to Organization Settings → Application Keys and create an application key
2. Configure in OpsWorker
- In the OpsWorker portal, go to your cluster's integration settings
- Select Datadog
- Provide the API key and Application key
Supported Monitor Types
| Monitor Type | Alert Support | API Query Support |
|---|---|---|
| Metric | Yes | Yes |
| APM | Yes | Yes |
| Log | Yes | Yes |
| Process | Yes | Limited |
| Composite | Yes | Yes |
Next Steps
- Datadog Alerts Setup Guide — Detailed setup
- Datadog AI Agent — What the API integration enables