> ## Documentation Index
> Fetch the complete documentation index at: https://docs.obsy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Alerts overview

> Receive, view, and act on alerts from Datadog, Grafana, and New Relic.

Obsy acts as a **central alert hub**. Alerts from your monitoring platforms arrive via webhook, get normalized into a common format, trigger RCA, and optionally create incidents — all without you having to log in to three different tools.

## How alert routing works

```
Datadog / Grafana / New Relic
         ↓ webhook
  Obsy (per-org URL)
         ↓
  Normalized Alert entity
         ↓
  ┌──────┴──────┐
  │             │
RCA          Auto-create
triggered    incident rule
             check
```

## Alert fields

| Field               | Description                                        |
| ------------------- | -------------------------------------------------- |
| **Name**            | Title of the alert from the source platform        |
| **Source**          | datadog, grafana, or newrelic                      |
| **Severity**        | critical, warning, or info                         |
| **Signal type**     | errors, latency, traffic, or saturation (inferred) |
| **Service**         | Extracted from alert tags or labels                |
| **Environment**     | Extracted from `env` / `environment` tags          |
| **Status**          | firing or resolved                                 |
| **Linked incident** | Set when an incident is created from this alert    |

## Viewing alerts

Go to **Alerts** in the sidebar. Use the filters at the top to narrow by status, severity, source, or service. Click any alert to see the raw payload, labels, and linked incident or RCA.

## Alert status lifecycle

```
(Alert fires)
     ↓
  firing
     ↓
  acknowledged  ← manual or from incident assignment
     ↓
  resolved  ← when platform sends recovery
```

## Getting started with alert routing

<CardGroup cols={3}>
  <Card title="Datadog" icon="d" href="/alerts/datadog">
    Set up the `@webhook-obsy` handle in Datadog monitors.
  </Card>

  <Card title="Grafana" icon="chart-line" href="/alerts/grafana">
    Add Obsy as a Grafana Alerting contact point.
  </Card>

  <Card title="New Relic" icon="n" href="/alerts/newrelic">
    Configure a New Relic Workflow to POST to Obsy.
  </Card>
</CardGroup>