> ## 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.

# Incidents overview

> Manage the full lifecycle of an incident from detection to resolution.

Obsy's incident module covers the entire incident lifecycle: detection (from alerts or manual creation), coordination (Slack channels, role assignments, timelines), resolution, and follow-up (postmortems).

## Incident lifecycle

```
Alert fires
    ↓
Auto-create rule matches (or manual creation)
    ↓
Incident created
    ↓
Slack channel opened (if configured)
    ↓
Roles assigned (commander, lead, comms)
    ↓
Timeline updated as team works
    ↓
Incident resolved
    ↓
Postmortem created
```

## Incident fields

| Field                 | Description                                                     |
| --------------------- | --------------------------------------------------------------- |
| **Title**             | Short description of the impact                                 |
| **Severity**          | SEV1 (critical) → SEV4 (low)                                    |
| **Status**            | Open → Investigating → Identified → Monitoring → Resolved       |
| **Affected services** | Services impacted, used to link status page components          |
| **Timeline**          | Chronological log of updates, Slack messages, and system events |
| **Root cause**        | Link to an RCA or manual notes                                  |
| **Slack channel**     | Dedicated channel created in your Slack workspace               |

## Severity levels

| Level               | Use when                                                    |
| ------------------- | ----------------------------------------------------------- |
| **SEV1 — Critical** | Complete outage, data loss, or severe customer impact       |
| **SEV2 — High**     | Major feature unavailable for a significant number of users |
| **SEV3 — Medium**   | Degraded performance or a non-critical feature is down      |
| **SEV4 — Low**      | Minor issue with a workaround available                     |

## Navigation

Go to **Incidents** in the sidebar to see all open and recent incidents. Click any row to open the incident detail view with the full timeline, roles, and linked RCA.

<CardGroup cols={2}>
  <Card title="Create an incident" icon="plus" href="/incidents/create">
    Manually open an incident or let alerts do it automatically.
  </Card>

  <Card title="Slack channels" icon="slack" href="/incidents/slack-channels">
    Auto-create a dedicated Slack channel for every incident.
  </Card>

  <Card title="Roles" icon="users" href="/incidents/roles">
    Assign commander, lead engineer, and comms roles.
  </Card>

  <Card title="Settings" icon="gear" href="/incidents/settings">
    Configure auto-create rules, Slack settings, and notification channels.
  </Card>
</CardGroup>