Operations / Field guide

Incident status

Tell customers what is affected and when to expect an update.

Customers need a live answer

CUSTOMER-FACING STATUSInvestigating delaysAPI requestsDEGRADED12:10 · Delays identifiedNext update by 12:40

An incident update names the impact and next update time.

01 / CONTEXT

Why it matters

A status page is a communication workflow, not a substitute for monitoring. Customers need affected capabilities, current impact and the next update time in language they can act on.

When a service fails, customers need to know whether their experience is affected and when the next update will arrive. An honest status page reduces uncertainty even before a fix is ready.

02 / DESIGN

Decisions to make

  • Define which incidents merit public or customer-specific updates.
  • Choose who can publish and approve updates.
  • Set an update cadence that is sustainable during response.
  • Define who can declare and update an incident.
  • Choose whether component status reflects real measurements or manual assessment.
03 / IMPLEMENTATION

Build checklist

  • Prepare status components and incident templates before an outage.
  • Keep the communication system separate from the failing product path.
  • Reconcile the final timeline and follow-up actions after resolution.
  • Publish timestamps, impact, current work and next update time.
  • Review the incident timeline after resolution and link to a postmortem when appropriate.
04 / WATCH FOR

Common mistakes

  • Publishing a green status page because the monitor missed a customer-visible failure.
  • Marking all systems operational while customers still see failures.
  • Letting status updates go silent during a long incident.
05 / GO DEEPER

Tools & references

4 starting points to compare or study. Check fit, maintenance, terms and current capabilities before choosing one.

BUILDING THIS NOW?

Explore the SaaSLayer approach.

See the services and developer guides behind our AWS backed SaaS building blocks.

Read SaaSLayer docs
NEXT FEATURERate limits