Skip to main content
Integrate Aurora with Datadog to automatically track alerts, query metrics and logs, and perform root cause analysis on monitoring data.

​
Authentication

Datadog uses API Key + Application Key authentication.

​
Prerequisites

  • A Datadog account (US1, US3, US5, EU, AP1, AP2, or Gov)
  • Organization admin access to create API keys

​
Setup Steps

1

Create API Key

  1. Go to Datadog and click your avatar
  2. Navigate to Organization Settings > API Keys
  3. Click + New Key
  4. Name it Aurora and copy the generated key
2

Create Application Key

  1. In Organization Settings, go to Application Keys
  2. Click + New Key
  3. Name it Aurora and copy the generated key
3

Identify Your Site

Determine which Datadog site you’re using:
SiteURL
US1datadoghq.com
US3us3.datadoghq.com
US5us5.datadoghq.com
EUdatadoghq.eu
AP1ap1.datadoghq.com
AP2ap2.datadoghq.com
Govddog-gov.com
4

Connect to Aurora

  1. In Aurora, navigate to Integrations > Datadog
  2. Enter your API Key, Application Key, and site
  3. Click Connect

​
Configuration

No environment variables are required. API keys are entered through the Aurora UI and stored securely in Vault.

​
Webhook Setup (Optional)

To receive real-time alerts from Datadog monitors:
1

Get Webhook URL

In Aurora’s Datadog integration page, copy your unique webhook URL:
https://your-aurora-domain/datadog/webhook/{user_id}
2

Configure Webhook in Datadog

  1. In Datadog, go to Integrations > Webhooks
  2. Click + New
  3. Name it aurora
  4. Paste your Aurora webhook URL
  5. Save the webhook
3

Add to Monitors

In any Datadog monitor notification, add @webhook-aurora to automatically send alerts to Aurora.

​
Development with ngrok

For local development, webhooks cannot reach localhost:5080 directly. Set up port forwarding:
.env
NGROK_URL=https://your-ngrok-url.ngrok-free.app
Start ngrok: 
ngrok http 5080

​
What Aurora Can Query

Once connected, Aurora can:

​
Logs

  • Search logs with Datadog query syntax
  • Filter by time range, sources, tags
  • Access structured log attributes
  • Retrieve up to 500 logs per query
API Endpoint: POST /datadog/logs/search Example Query: 
{
  "query": "service:web-app status:error",
  "from": "2026-03-03T10:00:00Z",
  "to": "2026-03-03T11:00:00Z",
  "limit": 50
}

​
Metrics

  • Query timeseries metrics
  • Aggregate by tags and dimensions
  • Define custom time ranges and intervals
  • Use Datadog metric query language
API Endpoint: POST /datadog/metrics/query Example Query: 
{
  "query": "avg:system.cpu.user{*} by {host}",
  "fromMs": 1709463600000,
  "toMs": 1709467200000,
  "interval": 60
}

​
Events

  • List Datadog events by time range
  • Filter by priority, sources, tags
  • Access event metadata and context
API Endpoint: GET /datadog/events Parameters:
  • start - Unix timestamp (default: 1 hour ago)
  • end - Unix timestamp (default: now)
  • priority - Filter by priority level
  • sources - Comma-separated source names
  • tags - Comma-separated tags

​
Monitors

  • List all monitors with pagination
  • Filter by name, tags, status
  • View monitor state and downtime info
  • Access group states
API Endpoint: GET /datadog/monitors Parameters:
  • page - Page number (default: 0)
  • page_size - Results per page (max: 100)
  • name - Filter by monitor name
  • tags - Filter by monitor tags
  • status - Filter by status (Alert, Warn, OK, etc.)
  • group_states - Filter by group state (default: all)
  • with_downtimes - Include downtime info (default: true)

​
Webhook Events

  • Receive real-time monitor alerts
  • Auto-create incidents from triggers
  • Correlate related alerts
  • Generate AI-powered root cause analysis
Ingested Data:
  • Event type and title
  • Monitor status (alert, warn, resolved)
  • Scope and tags
  • Metrics and queries
  • Snapshots and links

​
Troubleshooting

Connection Failed
  • Verify API Key and Application Key are correct
  • Ensure keys have not been revoked
  • Check that you selected the correct site/region
Webhook Not Receiving Events
  • Verify NGROK_URL is set correctly (for local development)
  • Ensure ngrok tunnel is running
  • Check webhook is configured in Datadog with correct URL
  • Send a test notification from Datadog webhook settings
Rate Limit Errors
  • Datadog API rate limits apply per organization
  • Reduce query frequency or use longer time windows
  • Check Datadog API usage in your account settings

​
API Reference

Base Path: /datadog
MethodEndpointDescription
POST/connectConnect Datadog account
GET/statusCheck connection status
DELETE/disconnectRemove Datadog connection
POST/logs/searchSearch logs
POST/metrics/queryQuery metrics
GET/eventsList events
GET/monitorsList monitors
GET/events/ingestedView webhook events
POST/webhook/{user_id}Receive webhooks
GET/webhook-urlGet webhook URL
For detailed information, see the Datadog API documentation.

Build docs developers (and LLMs) love

Get started for freeTalk to us