# Uptime reports

Generate monthly uptime PDF reports from published events.

Source: https://statusdashboard.com/docs/reports/uptime

> This is a plan-gated feature. If it isn't available in your account, visit the [Billing](/docs/org-mgmt/billing) page or contact support to review your options.

Uptime reports summarize monthly availability for a status dashboard or a single org component, computed from **published** incidents and maintenance. Organization admins generate reports on demand on [Uptime reports](/app/reports/uptime) and download a browser-generated PDF.

The sections below describe the calculation methodology, the generation workflow, and how maintenance windows affect the uptime percentage.

***

## Methodology
| Topic             | Behavior                                                                                                                                                                                                 |
| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Source of truth   | **Published** incidents and maintenance only. Drafts and informational events are excluded.                                                                                                              |
| Period            | One **calendar month**. The current month is allowed; open intervals are clipped to the generation time (month-to-date).                                                                                 |
| Scope             | **Whole dashboard** (all components currently wired on that dashboard) or **single org component** (any component in your organization — not limited to one dashboard).                                  |
| Maintenance       | **Excluded by default** from the uptime percentage and contributing-events table. Enable **Include maintenance** to count maintenance windows.                                                           |
| Uptime %          | `100 × (1 − downtimeMinutes / periodMinutes)` using **merged overlapping intervals** per component (concurrent incidents are not double-counted).                                                        |
| Dashboard summary | **Unweighted mean** of each in-scope component's uptime percentage. Multi-component rollups do **not** sum downtime across components (that is not wall-clock); see each component row for its downtime. |
| Timezone          | Your browser's IANA timezone is sent with the request and printed on the PDF.                                                                                                                            |
| Precision         | Integer minutes (seconds rounded half up). Sub-minute noise is not SLA-grade probe sampling.                                                                                                             |
| Events table      | Lists every contributing event with **title and UUID**, original **start/end**, and **minutes in period** (duration clipped to the report month).                                                        |

## Workflow
1. Open [Uptime reports](/app/reports/uptime).
2. Choose **Whole dashboard** or **Single component**.
3. For whole dashboard: select a dashboard, month, and year.
4. For single component: the dashboard selector is disabled; pick an org component, month, and year.
5. Optionally include maintenance.
6. Click **Generate report** to preview summary metrics and contributing events.
7. Click **Download PDF** to save the report locally.

## Access
Uptime reports require:

* The **admin** role (same gate as status dashboard configuration).
* The **Uptime reports** plan entitlement. Included by default on **trial** and **pro** tiers.

If your organization does not have the entitlement, the page shows a feature-unavailable message.