Observability Integrations

Aurora integrates with leading observability platforms to provide comprehensive monitoring, alerting, and incident management across your infrastructure.

​

Available Integrations

​

Datadog

​

Authentication Method

API Key + Application Key

​

Setup Overview

1. Create API Key
   • Go to Datadog > Organization Settings > API Keys
   • Click + New Key, name it Aurora
   • Copy the key
2. Create Application Key
   • Go to Organization Settings > Application Keys
   • Click + New Key, name it Aurora
   • Copy the key
3. Identify Your Site

   Site	URL
   US1	datadoghq.com
   US3	us3.datadoghq.com
   US5	us5.datadoghq.com
   EU	datadoghq.eu

4. Enter Credentials in Aurora UI
   • API Key, Application Key, and Site are entered via the UI
   • No environment variables needed

​

Webhook Configuration

Receive Datadog alerts in Aurora:

1. Get Webhook URL from Aurora UI
   • Format: https://your-aurora-domain/datadog/webhook/{user_id}
2. Configure in Datadog
   • Go to Integrations > Webhooks > + New
   • Name: aurora
   • URL: Paste Aurora webhook URL
3. Use in Monitors
   • Add @webhook-aurora to monitor notifications

​

Troubleshooting

“Datadog connector not working” — Check that API and Application keys are correctly configured in the UI.

​

Grafana

​

Authentication Method

API Token (supports Grafana Cloud and self-hosted)

​

Setup Overview

​

For Grafana Cloud:

1. Create Service Account
   • Go to Grafana Cloud > your stack
   • Administration > Service accounts > Add service account
   • Name: Aurora, Role: Viewer
2. Generate Token
   • Click Add service account token
   • Copy the token
3. Enter Token in Aurora UI
   • No environment variables needed

​

For Self-Hosted Grafana:

1. Create API Token
   • Go to Configuration > API Keys
   • Click Add API key
   • Name: Aurora, Role: Viewer
   • Copy the key
2. Enter Token and URL in Aurora UI

​

Webhook Configuration

Receive Grafana alerts in Aurora:

1. Get Webhook URL from Aurora UI
   • Format: https://your-aurora-domain/grafana/alerts/webhook/{user_id}
2. Configure Contact Point
   • Go to Alerting > Contact points > + Add contact point
   • Type: Webhook
   • URL: Paste Aurora webhook URL
3. Route Alerts
   • Go to Notification policies
   • Route alerts to the Aurora contact point

​

Troubleshooting

“Grafana connector not working” — Check that the API token is correctly configured in the UI.

​

PagerDuty

​

Authentication Methods

OAuth 2.0 or API Token (API Token recommended for development)

​

Option A: API Token (Recommended)

1. Create API Key
   • Go to PagerDuty > Integrations > API Access Keys
   • Click Create New API Key
   • Select Read or Write permissions
   • Copy the token
2. Enter Token in Aurora UI
   • No environment variables needed

​

Option B: OAuth

1. Create OAuth App
   • Go to Integrations > Developer Mode > My Apps
   • Click Create New App
   • Name: Aurora
   • Enable OAuth 2.0
   • Redirect URL: http://localhost:5000/pagerduty/oauth/callback
   • Copy Client ID and Client Secret
2. Configure Environment Variables
   NEXT_PUBLIC_ENABLE_PAGERDUTY_OAUTH=true
   PAGERDUTY_CLIENT_ID=your-client-id
   PAGERDUTY_CLIENT_SECRET=your-client-secret
   
3. Restart Aurora
   make down
   make dev
   
4. Connect via OAuth Flow in Aurora UI

​

Webhook Configuration

Receive PagerDuty incidents in Aurora:

​

Local Development Setup

1. Set Up Port Forwarding
   ngrok http 5080
   
2. Configure Environment Variable
   NGROK_URL=https://abc123.ngrok-free.app
   
3. Restart Aurora Services
4. Get Webhook URL from Aurora UI (will use ngrok URL)
5. Configure in PagerDuty
   • Go to Integrations > Generic Webhooks (v3) > New Webhook
   • Paste webhook URL
   • Set scope: Account or specific services
   • Subscribe to events:
     • incident.triggered
     • incident.acknowledged
     • incident.resolved
     • incident.custom_field_values.updated
   • Click Add Webhook

​

Production Setup

Webhook URL format: https://your-aurora-domain/pagerduty/webhook/{user_id} No port forwarding needed in production.

​

Troubleshooting

“PagerDuty OAuth is not enabled” — Set NEXT_PUBLIC_ENABLE_PAGERDUTY_OAUTH=true. “Missing OAuth credentials” — Verify all PAGERDUTY_* env vars are set. “Webhook not receiving events” — Verify:

• NGROK_URL is set correctly (local dev)
• ngrok tunnel is running
• Webhook URL matches Aurora UI
• Test notification was sent from PagerDuty

​

Netdata

​

Authentication Method

API Token

​

Setup Overview

1. Create API Token
   • Go to Netdata Cloud > Account Settings > API Tokens
   • Click Create Token
   • Name: Aurora
   • Copy the token
2. Enable Netdata Integration
   NEXT_PUBLIC_ENABLE_NETDATA=true
   
3. Restart Aurora
   make down
   make dev
   
4. Enter Token in Aurora UI

​

Webhook Configuration

Receive Netdata alerts in Aurora:

1. Get Webhook URL from Aurora UI
   • Format: https://your-aurora-domain/netdata/alerts/webhook/{user_id}
2. Configure in Netdata Cloud
   • Go to Space settings > Alert notifications > Add configuration
   • Method: Webhook
   • URL: Paste Aurora webhook URL

​

Troubleshooting

“Netdata connector not enabled” — Ensure NEXT_PUBLIC_ENABLE_NETDATA=true and restart Aurora.

​

Dynatrace

​

Next Steps