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

# Incident Response Best Practices

> How strong teams run incident response, and how to configure Rootly to match.

A defined incident response process answers one question in advance: what happens next? When that's settled, responders spend their attention on the failure itself, not on working out who to notify, whether this warrants a status page update, or who's writing the timeline down. The coordination work still happens, accurately, without competing with the diagnosis. The best-run teams automate the predictable parts of that coordination outright, and lean on an agent for the parts that need judgment.

The practices below are the ones we see consistently across teams that respond well; not the most sophisticated setups, the most repeatable ones. Each section describes what good looks like, then points to the part of Rootly that makes it stick. Find the row you're in on the maturity table and fix the next thing.

|                 | Crawl                                      | Walk                                             | Run                                                                     |
| --------------- | ------------------------------------------ | ------------------------------------------------ | ----------------------------------------------------------------------- |
| Automation & AI | Every step is manual, reminders are tribal | Workflows cover the repeatable steps             | An agent handles lookups, updates, and gap-checking in-channel          |
| On-Call         | A schedule exists                          | No coverage gaps, holidays and overrides handled | Multi-level escalation, coverage requests and shadowing built in        |
| Severity        | Ad hoc judgment call                       | 3–4 defined levels with impact criteria          | Severity drives automation: comms, roles, paging                        |
| Roles           | Whoever picks it up                        | Commander named at declaration                   | Roles auto-assigned by service and severity                             |
| Playbooks       | Individual experiences from responders     | Docs exist somewhere                             | Playbooks attached to the incident, action items pre-assigned           |
| Comms           | Someone remembers to post                  | Templates and a cadence                          | Automated updates to responders, stakeholders, and customers separately |
| Retros          | For the bad ones                           | Clear trigger criteria, consistent template      | Every qualifying incident, action items tracked to close                |

### Make sure an urgent page always reaches a human

The most expensive failure isn't a slow response, it's a page nobody received. Before anything else, verify:

1. No gaps in your schedules. Coverage across time zones, holidays accounted for, overrides in place for planned time off.
   <Tip>
     For 24/7 schedules, use [Rootly's Gap Detector](/on-call/schedules#enabling-24%2F7-coverage). This will make sure someone is always on-call for the schedule.
   </Tip>
2. More than one level in every escalation policy. A single-level policy is a single point of failure. Level two should fire a short time after level one is paged and doesn't respond.
3. Critical alerts page a human target. Routing an alert with a High urgency to a Slack channel or a group with no on-call attached is the most common gap we find.
   <Tip>
     Build a Dynamic Escalation Path in Rootly to define separate paging logic for each urgency level: create a path that pages a Schedule for all High urgency Alerts, versus pages a Slack channel for all low urgency Alerts.
   </Tip>
4. Test the path. Trigger a test alert on each critical service quarterly and confirm who it woke up.

<Card title="Key features in Rootly On-Call:" type="check">
  In Rootly On-Call, make use of our [holiday calendars](/on-call/holiday-calendar#adding-a-holiday-calendar), [shift coverage requests](/on-call/request-coverage), and [shadowing](/on-call/on-call-shadowing) for new joiners. These features ensure you have complete coverage, and your alerts are always paging the right person.
</Card>

### Define a Severity matrix to quickly communicate incident impact

Severities are a simple way for your teammates to easily understand the impact of an incident. Define three or four levels.

Define each one by what the customer experiences, not by which team is involved or how stressed anyone is. Write the response expectation into the definition: who gets paged, how fast, who gets told.

A useful test: two engineers reading the same alert at 3am should pick the same severity without discussing it.

<Note>
  Ask the Rootly AI Agent to help you choose the right severity:`@Rootly what severity should this incident be set to? Update it for me.`

  The Rootly AI Agent uses the context of the current incident, past incidents, and the Severity matrix you've configured in Rootly to propose an appropriate severity.
</Note>

<Card title="Key features in Rootly Incident Response:" type="check">
  Define your [severities](https://rootly.com/account/severities) from a SEV0 (most urgent) to a SEV3 (least urgent). However, you can change the labels, and update each severity's description in Rootly if your teams are familiar with a different framework. This helps set expectations with your teams when a new incident is declared.

  Severities can also be used to automate different processes, like automatically paging someone on the leadership team for a SEV0. You can measure the rate of incidents by severity too: for example, see which services are experiencing the highest rate of SEV2 incidents due to gaps in the deploy process.
</Card>

### Assign individuals to roles as soon as possible

Coordination failures cost more time than technical ones. At minimum:

1. **Incident commander**: owns the response, doesn't debug. The single most valuable role to make non-optional.
2. **Communications lead**: owns updates to stakeholders and customers so the commander doesn't context-switch.
3. **Scribe**: captures the timeline as it happens, not from memory afterward.
   <Tip>
     Rootly's [AI Meeting Scribe](/ai/meeting-scribe) records and takes notes on your incident calls. This let's your human scribe focus on the incident and handle more impactful work, enabled by the AI Scribe's notes.
   </Tip>

Assign at declaration, not when someone notices they're missing. Where the assignment is predictable (like a service always mapping to the same team), automate it.

<Note>
  If you aren't sure who to assign to a role, ask the Rootly AI Agent:`@Rootly assign the incident roles for me.`
</Note>

<Card title="Key features in Rootly Incident Response:" type="check">
  Rootly's AI Agent can be used by each responder to help them investigate the incident. If you do not have the AI Agent on, enable it under the [AI & Agent settings](https://rootly.com/account/ai/configurations).

  [Incident Roles](https://rootly.com/account/incident-roles) are configurable per team and are assigned per incident. You can automatically assign individuals to each role when their team is associated with an incident.
</Card>

### Automate the first ten minutes with a playbook of steps

The teams that respond fastest aren't improvising faster; they've removed the need to improvise completely by building a playbook.

A good [playbook](/configuration/playbooks) is a short checklist of the first actions for a given failure mode, attached to the incident automatically, with each step already assigned to a role rather than a named person. Assigning to roles matters: named people go on vacation, roles don't.

This ensures a repeatable process every time an incident is declared, so your responding teams can focus without missing any critical steps.

<Card title="Key features in Rootly Incident Response:" type="check">
  [Playbooks](https://rootly.com/account/playbooks) attach to incidents based on conditions like impacted service and severity. Rootly will automatically create Action Items that carry the owners, due dates, and  fields based on the Playbook steps.
</Card>

### Structure your communications strategy

Responders, internal stakeholders, and customers need different things at different intervals. Most teams collapse them into one channel and then either spam responders or leave executives to interrupt the response team asking for updates.

Responders need the working channel, and don't mind the noise. Internal stakeholders need a scheduled update on a fixed cadence tied to severity. Every 30 minutes for SEV1, even if the update is "no change." Customers need a status page and honest, low-detail updates.

Template the updates. Nobody writes well under pressure, and hand-written updates are the first thing to slip when things get hard.

<Note>
  Use the Rootly AI Agent to help draft an update: `@Rootly update my status page with a summary of the current work the team is doing to resolve the issue.`

  <iframe src="https://www.loom.com/embed/02f24e8b0da04c40b7f97926cb6daa80" title="Loom video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
</Note>

<Card title="Key features in Rootly Incident Response:" type="check">
  Use the [Communications Module](/communications/overview) to proactively communicate with different audiences, like customers, partners, or other engineering teams, in a structured way that takes the guess work out of who gets sent what.

  [Status Pages](/configuration/status-pages) are used  for  updates that your audiences can consume on their own. Rootly's AI Agent can draft the update from the incident channel so the comms lead is editing rather than composing.
</Card>

### Automate the operational work, and use an agent for the rest

There are two kinds of work in an incident: solving the problem, and everything around solving the problem. The second kind is what makes a response feel heavy, yet it's necessary to keep teams moving in unison.

Rather than relying on a teammate to complete the operational tasks, which will distract them from their mitigation work, and increases the chances that things fall through the cracks, use an AI Agent embedded right in your incident channel to handle this work.

For example, useful things to ask the [Rootly Agent in Slack](/ai/rootly-in-slack/overview):

1. "What key events have happened so far?" - keeps teammates up-to-date, without distracting the rest of the team to draft an update.
2. "Is SEV2 right for this?" - a second opinion on severity with the incident's context.
3. "Has anyone else on the team mitigated a similar incident in the past week?" - make sure all the right stakeholders are working together.
4. "Did anything get missed? Create the action items for me and assign them to the relevant team." - nothing falls through the cracks, preventing a repeat incident from occurring in the future.
5. "Summarize where we are for someone joining" - status, current theory, open action items, who's involved.
6. "Draft a customer update" - and publish it to the status page after you confirm.
7. "Update the impacted services" - resolved from real service discovery, not guessed names.

<Card title="Key features in Rootly Incident Response:" type="check">
  [Rootly's AI Agent](/ai/ai) is available in Slack, Web, and our Mobile app to keep teammates up-to-date, and automate tasks for your teams. 

  Supercharge it with [Connectors](/ai/connectors/overview) to gather context in your external systems, the [AI Scribe](/ai/meeting-scribe) to keep everyone updated on the bridge conversation, and [AI-generated retrospectives](/ai/ai-in-retrospectives/overview) to pull all of the details together once the incident is resolved.
</Card>

### Reserve time to learn and reflect for the future

Define the trigger criteria in advance so nobody has to argue about whether an incident "deserves" a retrospective. For example, trigger criteria can include a severity threshold, customer impact, or incident duration. Then:

Run it within a week, while memory is fresh Use one template so retros are comparable to each other Focus on contributing factors and systems, not individual decisions Leave with action items that have owners and due dates, or don't bother

<Card title="Key features in Rootly Incident Response:" type="check">
  Rootly's [Retrospective Process](/retrospectives/configuring-retrospective-processes) builder lets you define the repeatable process for your teams to follow for each incident.

  Use the [Rootly Retrospective Editor](/ai/ai-in-retrospectives/overview) to draft the initial document, so that nothing gets missed.
</Card>

## Checklist to get started

Before you start adopting these practices, make sure you have the following set up in Rootly:

1. Rootly's [AI features](https://rootly.com/account/ai/surfaces/global) and [AI Agent](https://rootly.com/account/ai/surfaces/features). These will be used to help you focus on the incident, without losing the outcomes you benefit from in your incident response process.
2. [Connectors](/ai/connectors/overview): these power your AI Agent in Rootly to gather context from your external systems, like your CI/CD platform or cloud provider.
3. [Google Meet](/integrations/google-meet/google-meet) or [Zoom](/integrations/zoom/zoom) integration. Whatever your video conferencing tool is, Rootly will automatically spin up a room for each incident. Bonus: enable to [AI Scribe](/ai/meeting-scribe) to take notes and record your call!
4. Review your [Retrospective template](https://rootly.com/account/retrospective-processes). You'll already have a default template built by Rootly based on industry best practices: add any additional section(s) you'd like to capture in your retrospective for your team to reflect on.
