> For the complete documentation index, see [llms.txt](https://good-alchemy.gitbook.io/fabric-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://good-alchemy.gitbook.io/fabric-documentation/guides/running-github-integrated-incident-responses.md).

# Fabric for incidents

An incident is a critical and urgent bug that needs a quick response.

**In an incident, time is critical.**

[Fabric](https://www.tryfabric.com/) can create an issue and spin up an [Issue Room](/fabric-documentation/reference/issue-rooms.md) in seconds for your team to collaborate in. The Issue Room becomes your command center, and helps your team close your incident as quickly as possible.

## Our customizable incident workflow

With Fabric's [Templates](https://docs.tryfabric.com/reference/templates), you can set up a workflow that adds labels, assignees, notifies the right people, and opens a war room ([Issue Room](https://docs.tryfabric.com/reference/issue-rooms))... all automatically.

While the incident is ongoing, Fabric will send Pull Request notifications to your Issue Room, so everyone can see the progress at a code level.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-MhplngnZuFcMAo58-3O%2F-MhprEZJD3GDkBEuOqed%2FScreen%20Shot%202021-08-23%20at%209.53.23%20PM.png?alt=media\&token=6bec9995-4440-4c7a-ac69-4cd94e8d9583)

Lastly, when the issue gets closed out, Fabric will [archive the Issue Room, ](/fabric-documentation/reference/issue-rooms.md#auto-archiving-issue-rooms)and all the messages will have been backed up to the issue.

## Better incidents with Fabric <a href="#benefits-of-fabric-for-incidents" id="benefits-of-fabric-for-incidents"></a>

### Integrate closely with GitHub <a href="#deep-github-integration" id="deep-github-integration"></a>

When you run incident management on Fabric, every incident is a GitHub issue, and every message is an GitHub issue comment. This follows SRE best practices of having everything back up to the issue.

### Zero-click war room creation <a href="#quick-war-room-creation" id="quick-war-room-creation"></a>

Using our [🚨 Incident Template](/fabric-documentation/recommended-templates/setting-up-an-incident-workflow.md) or a custom one, you can tell Fabric to always spin up an Issue Room.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mht2zGj-EcFB-J1VciI%2F-Mht6Oa9oLxDcYq_i0GE%2FScreen%20Shot%202021-08-24%20at%201.02.38%20PM.png?alt=media\&token=be799c61-cc4d-42df-89e2-0411e38e9894)

Fabric will create an Issue Room for each new issue created with this Template.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mht2zGj-EcFB-J1VciI%2F-Mht6fOqEjkokU456Dxs%2FScreen%20Shot%202021-08-24%20at%201.04.12%20PM.png?alt=media\&token=608cb149-e2ac-454b-adbd-5a8389d74dc8)

The created Issue Room gets attached to the issue. We preview the last comment.

### Keep up to date on PRs <a href="#channel-notifications" id="channel-notifications"></a>

Since your Issue Room is your command center, any updates on the issue in GitHub will send to that Slack channel.

If someone comments in GitHub, it'll notify the room.

Anyone looking at the issue in GitHub will see a link to the Issue Room at the top of the issue.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mht2zGj-EcFB-J1VciI%2F-Mht74aXFX48DdhGyWV7%2FScreen%20Shot%202021-08-24%20at%201.05.57%20PM.png?alt=media\&token=3144a37d-b240-42ee-a0e7-256fd6d357ab)

If someone comments in GitHub, it'll notify the room. They'll also see a link to the Room.

#### Linked Pull Requests <a href="#linked-pull-requests" id="linked-pull-requests"></a>

When a [connected Pull Request](https://docs.tryfabric.com/reference/issues#closing-on-pull-request-merge) is opened, closed, or merged, it'll notify the channel.

No need to DM the channel when a review is needed.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mht2zGj-EcFB-J1VciI%2F-Mht8GXpCnH_S9iWz28G%2FScreen%20Shot%202021-08-24%20at%201.09.47%20PM.png?alt=media\&token=12087389-d578-4aca-b435-7f1728b1e031)

### Your timeline is built for you <a href="#builds-your-timeline" id="builds-your-timeline"></a>

Slack has second-level timestamping, so you'll be able to see exactly when certain things happened.

And, because everything is backed up to a GitHub issue, you'll see it there, too.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mht8Wi6VTM9FDHNyEkj%2F-Mht8p204UsgoNt7KMFz%2FScreen%20Shot%202021-08-24%20at%201.09.29%20PM.png?alt=media\&token=c3491fbd-89aa-4bcb-b3d1-75166b1089dd)

### No fuss <a href="#gets-out-of-your-way" id="gets-out-of-your-way"></a>

We know that when you're running an incident, time is critical.

We try to get you and your teammates into the Issue Room as soon as possible, without having you jump through any hoops.

## Set up your incident template <a href="#how-do-i-set-up-an-incident-template" id="how-do-i-set-up-an-incident-template"></a>

### Go to your Fabric dashboard <a href="#go-to-your-fabric-dashboard" id="go-to-your-fabric-dashboard"></a>

To get to your Fabric dashboard, click `Fabric` under `Apps` in your Slack sidebar.

If you don't see `Fabric` there, search for `Fabric` in your Slack search bar, and then click on the `Home` tab.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mho_PCGHjtZUrL9zEFG%2F-MhohIxiHesj4aTv9MFl%2FScreen%20Shot%202021-08-23%20at%204.30.14%20PM.png?alt=media\&token=2d666e87-70c0-4189-92fc-a1799cb7b57b)

Find Fabric in the Slack sidebar or search for it in the Fabric search bar.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mho_PCGHjtZUrL9zEFG%2F-MhohP0rcYtALUMlL8RD%2FScreen%20Shot%202021-08-23%20at%204.30.21%20PM.png?alt=media\&token=4bff79f1-53d1-45b5-977e-28c4576b57c9)

This is your Fabric Dashboard.

### Go to your templates page <a href="#go-to-your-templates-page" id="go-to-your-templates-page"></a>

To get to your Templates Page, click on `Templates`.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mho_PCGHjtZUrL9zEFG%2F-MhoiJrZrz7lXR39Kqzz%2FScreen%20Shot%202021-08-23%20at%204.35.02%20PM.png?alt=media\&token=3c56265a-4f41-404f-a064-1877c9f641ce)

This is your Templates page.

### Select the incident template <a href="#select-the-incident-sample-template" id="select-the-incident-sample-template"></a>

Let's customize our [incident template. ](/fabric-documentation/recommended-templates/setting-up-an-incident-workflow.md)Click `Create a template from example`.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mho_PCGHjtZUrL9zEFG%2F-Mhoj-foVlI9oQ5DD5Eg%2FScreen%20Shot%202021-08-23%20at%204.37.43%20PM.png?alt=media\&token=8f121c94-9c26-447f-847e-bf5e671f66d2)

Choose `🚨 Incident`.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-Mholuquddk33GK--eZL%2F-Mhoqflhv_iz021jXB8p%2FCleanShot%202021-08-23%20at%2017.11.31%402x.png?alt=media\&token=5410e1be-9c6b-4955-90fc-cee630765707)

Choose `Start with this one` on the `🚨 Incident` Template.

![](https://gblobscdn.gitbook.com/assets%2F-MhaDNLIUpkpQasYP_hs%2F-MhsmTcClNuyB5Pl6VHU%2F-MhsmqldtjdgnnyyLQma%2FCleanShot%202021-08-24%20at%2011.33.16%402x.png?alt=media\&token=e6910241-3053-4b54-9066-4967bac4f275)

Here, you can customize all details of the `🚨 Incident` Template.

### Configure your template <a href="#configure-your-template" id="configure-your-template"></a>

Continue setting up your template with these details:

| Setting                           | Value                                                    |
| --------------------------------- | -------------------------------------------------------- |
| Name                              | 🚨 Incident                                              |
| Overview                          | Start an incident for a bug that needs a quick response. |
| Description                       | `- What’s going on?`                                     |
| Repository                        | \<your default repository>                               |
| Default labels                    | `bug`, `critical`                                        |
| Default assignees                 | \<add any default assignees>                             |
| Default project column            | \<add any project column>                                |
| Issue Feed                        | \<add your incidents channel, ex. `#feed-incidents`>     |
| Create Issue Rooms automatically? | ✅                                                        |
| Issue Room Prefix                 | `#incident-`                                             |
| Show label field?                 | ✅                                                        |
| Show assignee field?              | ✅                                                        |
| Show milestone field?             | ❌                                                        |
| Show project field?               | ✅                                                        |

​
