> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Arvo-AI/aurora/llms.txt
> Use this file to discover all available pages before exploring further.

# Observability Integrations

> Integrate Aurora with Datadog, Grafana, PagerDuty, Netdata, and Dynatrace for monitoring and alerting

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

## Available Integrations

<CardGroup cols={2}>
  <Card title="Datadog" icon="chart-simple" href="#datadog">
    API Key + Application Key authentication
  </Card>

  <Card title="Grafana" icon="chart-line" href="#grafana">
    API Token (Cloud or self-hosted)
  </Card>

  <Card title="PagerDuty" icon="bell" href="#pagerduty">
    OAuth or API Token
  </Card>

  <Card title="Netdata" icon="chart-area" href="#netdata">
    API Token for Netdata Cloud
  </Card>

  <Card title="Dynatrace" icon="chart-mixed" href="/integrations/observability/dynatrace">
    Application performance monitoring with AI-powered problem detection
  </Card>
</CardGroup>

## Datadog

### Authentication Method

API Key + Application Key

### Setup Overview

1. **Create API Key**
   * Go to [Datadog](https://app.datadoghq.com/) > 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.

<Tip>
  Both Read and Write permissions work for Application Keys. Choose based on your security requirements.
</Tip>

## Grafana

### Authentication Method

API Token (supports Grafana Cloud and self-hosted)

### Setup Overview

#### For Grafana Cloud:

1. **Create Service Account**
   * Go to [Grafana Cloud](https://grafana.com/) > 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.

<Note>
  For self-hosted Grafana, ensure Aurora can reach your Grafana instance URL.
</Note>

## 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](https://app.pagerduty.com/) > 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**
   ```bash theme={null}
   NEXT_PUBLIC_ENABLE_PAGERDUTY_OAUTH=true
   PAGERDUTY_CLIENT_ID=your-client-id
   PAGERDUTY_CLIENT_SECRET=your-client-secret
   ```

3. **Restart Aurora**
   ```bash theme={null}
   make down
   make dev
   ```

4. **Connect via OAuth Flow** in Aurora UI

### Webhook Configuration

Receive PagerDuty incidents in Aurora:

#### Local Development Setup

<Warning>
  PagerDuty webhooks cannot reach `localhost:5080` directly. Use a tunnel service like ngrok.
</Warning>

1. **Set Up Port Forwarding**
   ```bash theme={null}
   ngrok http 5080
   ```

2. **Configure Environment Variable**
   ```bash theme={null}
   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](https://app.netdata.cloud/) > Account Settings > API Tokens
   * Click Create Token
   * Name: `Aurora`
   * Copy the token

2. **Enable Netdata Integration**
   ```bash theme={null}
   NEXT_PUBLIC_ENABLE_NETDATA=true
   ```

3. **Restart Aurora**
   ```bash theme={null}
   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.

<Tip>
  Netdata provides real-time infrastructure monitoring with minimal overhead. Perfect for monitoring Aurora itself.
</Tip>

## Dynatrace

<Note>
  Dynatrace integration is coming soon. Check back for updates or [contact us](https://github.com/your-repo/issues) to request priority support.
</Note>

## Next Steps

<CardGroup cols={2}>
  <Card title="Communication Tools" icon="comments" href="/integrations/communication">
    Connect Slack and Confluence for team collaboration
  </Card>

  <Card title="CI/CD Integrations" icon="code-branch" href="/integrations/ci-cd">
    Integrate with GitHub, Jenkins, and Bitbucket
  </Card>
</CardGroup>