Incidents
Incidents let you tell visitors what is going on during an outage, and what happened after one. Your monitors show that something is down. An incident explains why, what you are doing about it, and when it is fixed.
Incidents are available on every plan, on every status page.
What visitors see
- Open incidents appear at the top of the status page, above the overall status, with their full timeline of updates.
- Past incidents resolved in the last 90 days are listed below your checks. Visitors can expand each one to read its updates. This gives prospective customers an honest record of how you handle outages.
The page updates live. Visitors who already have it open see a new update within seconds, without refreshing.
Statuses
Each update carries a status. The incident takes the status of its latest update.
| Status | Use it when |
|---|---|
| Investigating | You know something is wrong and are looking into it. |
| Identified | You found the cause and are working on a fix. |
| Monitoring | A fix is in place and you are watching the results. |
| Resolved | The incident is over. |
Posting a non-resolved update after a resolved one reopens the incident.
Posting an incident
- Go to Status Pages in the app.
- Open the ⋮ menu on the page and choose Incidents. You can also click Incidents in the footer of your own status page while signed in.
- Click New incident.
- Enter a title, a status and a message.
- Optionally pick the affected checks. Their names are shown on the incident.
- Click Post incident.
To keep visitors informed, open the incident and use Post an update. Pick Resolved when it is over.
Annotating a past outage
You can explain an outage after the fact:
- Create a new incident.
- Under Link to a detected outage, pick a check. The app lists the outages it detected for that check in the last 30 days.
- Pick the outage. The incident start time and the first update time are filled in from it, and the status is set to Resolved if the outage has ended.
- Write what happened and post.
You can also set the time of any update by hand (up to about a year back), for outages older than 30 days.
Editing and deleting
Open an incident to change its title, affected checks or linked outage, to edit or delete individual updates, or to delete the whole incident. An incident always keeps at least one update.
Limits
| Item | Limit |
|---|---|
| Title | 140 characters |
| Update message | 2,000 characters |
| Updates per incident | 50 |
| Past incidents shown publicly | Resolved in the last 90 days, up to 25 incidents in total |
Team accounts
Team members with the Editor role can post and edit incidents. Viewers can see them in the app but not change them.