Public Status Page: Your System's Voice During an Outage
A public status page is a dedicated site for communicating your service's health, turning "is it down?" support tickets into a single source of truth. It's used to report outages, degradation, and scheduled maintenance for public-facing services.
WHY IT EXISTS: During a service outage, customers get frustrated and flood support channels with inquiries. A public status page centralizes communication, deflects repetitive support tickets, and demonstrates transparency, which helps manage customer expectations and preserve trust. It shifts the conversation from "what's happening?" to a shared understanding of the problem and its resolution status.
THE MENTAL MODEL: Think of a public status page as the airport departure board for your services. Instead of individual passengers asking airline staff about a delayed flight, everyone can look at a single, authoritative screen. It shows which "flights" (services or components) are on time, delayed (degraded), or canceled (down), and provides updates on the situation.
HOW IT WORKS: A status page breaks a system down into individual "components" like 'API', 'Website', or 'Database'. Each component has a status: operational, degraded performance, partial outage, or major outage. When an incident occurs, the team creates an "incident" on the page, links it to the affected components, and posts updates as they investigate and resolve the issue. Many teams automate this by integrating monitoring tools to trigger status changes automatically when alerts fire. Users can often subscribe to receive updates via email, SMS, or webhooks.
WHEN TO USE IT: Use a status page for any service where external users depend on its availability. It's critical for SaaS products, APIs, e-commerce platforms, and infrastructure providers. It's also used to communicate scheduled maintenance, giving users advance notice of planned downtime. The goal is proactive, one-to-many communication.
WHEN NOT TO USE IT: A status page is not a replacement for detailed internal incident management tools or private postmortems. While a public postmortem summary can be shared, the granular technical details of an investigation belong in internal systems. Also, avoid using it for user-specific issues; it's for problems affecting a broad set of customers. For internal-only services, a private status page is more appropriate.
ONE CANONICAL EXAMPLE: A cloud provider's API starts returning 500 errors. Their monitoring system automatically detects the spike and updates the status page, changing the 'API' component to 'Major Outage'. The on-call engineer posts an initial update: "We are investigating an increase in API errors." As they diagnose the issue, they post further updates until the service is restored, finally publishing a brief postmortem explaining the root cause.
Read the original → support.atlassian.com
Get five bites like this every day.
Tezvyn delivers a daily feed of 60-second tech bites with quizzes to lock in what you learn.