Skip to content

Commit a1306f5

Browse files
authored
docs: add uptime calculation explanation for status pages (#153)
1 parent 08f0ce9 commit a1306f5

1 file changed

Lines changed: 35 additions & 2 deletions

File tree

communicate/status-pages/overview.mdx

Lines changed: 35 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,9 @@ A service can be used by multiple status pages. When an incident is opened for a
2828

2929
### Connecting Services and Status Pages
3030

31-
To display a service on a Status Page, go to the Status Page editor and open the `Services` dropdown on the card you want to display your service on.
31+
To display a service on a Status Page, go to the Status Page editor and open the `Services` dropdown on the card you want to display your service on.
3232

33-
Select your service from the list and save your Status Page. The page will now display the selected service.
33+
Select your service from the list and save your Status Page. The page will now display the selected service.
3434

3535
You can also create new services directly from the dropdown by entering a new service name and pressing `Create`.
3636

@@ -40,6 +40,39 @@ You can display the same service on multiple pages. An incident declared on that
4040

4141
A Check can also be associated with a Service, and automatically open Incidents whenever it fails. [See incident automation for more details](/communicate/status-pages/incidents#incident-automation).
4242

43+
## Uptime calculation
44+
45+
Status pages display an uptime percentage for each service, as well as an overall uptime for each card. Here's how these values are calculated:
46+
47+
### Time window
48+
49+
Uptime is calculated based on the **last 90 days** of data. This provides a meaningful long-term view of service reliability while remaining recent enough to reflect current performance.
50+
51+
### Service uptime
52+
53+
Service uptime represents the percentage of time the service was operational within the 90-day window. The calculation is:
54+
55+
```
56+
Uptime = ((Total time - Downtime) / Total time) × 100
57+
```
58+
59+
For example, if a service had 1 day of downtime over 90 days, the uptime would be approximately 98.89%.
60+
61+
### Card uptime
62+
63+
The uptime shown for a card is the **average uptime** of all services displayed within that card.
64+
65+
### What affects uptime
66+
67+
Uptime is determined by **incidents**, not directly by check results. Here's how it works:
68+
69+
- **Manual incidents**: When you [create an incident](/communicate/status-pages/incidents#creating-an-incident) affecting a service, the incident duration counts as downtime.
70+
- **Automated incidents**: When [incident automation](/communicate/status-pages/incidents#incident-automation) is enabled for a check, any check failure that triggers an alert will automatically open an incident, which counts as downtime. The incident is resolved when the check recovers.
71+
72+
<Note>
73+
If you don't have incident automation enabled, check failures won't automatically affect your uptime. You would need to manually create incidents to reflect downtime in your uptime calculations.
74+
</Note>
75+
4376
## Best practices for status pages
4477

4578
### Service organization

0 commit comments

Comments
 (0)