Maintenance Windows

Maintenance windows let you schedule planned downtime so Warden suppresses notifications and shows the correct status on dashboards and status pages.

Creating a Maintenance Window

1. Navigate to Maintenance in the sidebar
2. Click Schedule Maintenance
3. Fill in the fields:
   • Title — a short description (e.g., “Database Migration”)
   • Affected Group — the group that will be impacted
   • Start Date & Time — when maintenance begins
   • End Date & Time — when maintenance is expected to end
   • Description — optional details about the planned work
4. Click Create

Times are displayed in your local timezone.

Maintenance Statuses

Status	Meaning
Scheduled	Maintenance is planned but hasn’t started yet
In Progress	Maintenance is currently active (between start and end time)
Completed	Maintenance is finished

How Maintenance Affects Monitoring

During an active maintenance window:

• Monitor checks continue running — data is still collected and recorded
• Notifications are suppressed — no down, degraded, or other alerts are sent for monitors in the affected group
• Dashboard shows maintenance status — the affected group displays a “Maintenance” badge instead of showing individual monitor failures
• Status pages show maintenance — public status pages display the maintenance window with its details

This means you won’t get paged for expected downtime, but you’ll still have historical data for the maintenance period.

Editing a Maintenance Window

1. Navigate to Maintenance in the sidebar
2. Find the window in the Scheduled tab
3. Click Edit
4. Update the title, description, affected group, or time range
5. Save

You can only edit maintenance windows that are not yet completed.

Ending Maintenance Early

If maintenance finishes ahead of schedule:

1. Find the active maintenance window in the Scheduled tab
2. Click End Now

This immediately sets the status to Completed and the end time to now. Notifications resume for the affected group.

Deleting a Maintenance Window

1. Find the maintenance window
2. Click Delete
3. Confirm the deletion

Deleting a scheduled or active maintenance window immediately removes it. Notifications resume for the affected group.

Scheduled vs History

The Maintenance page has two tabs:

Tab	Shows
Scheduled	Active and future maintenance windows
History	Completed maintenance windows

Ongoing maintenance windows show a pulsing Ongoing badge.

Maintenance on Status Pages

Active maintenance windows are shown on public status pages:

• The system status banner shows System Under Maintenance
• Affected groups display a maintenance icon with a blue “Maintenance” label
• The maintenance title and description are visible to status page visitors

Maintenance windows are public by default so users of your status pages are informed about planned work.

Maintenance vs Incidents

Feature	Maintenance	Incident
Purpose	Planned work	Unplanned disruptions
Requires end time	Yes	No (set when resolved)
Suppresses notifications	Yes	No
Public by default	Yes	No
Has timeline updates	No	Yes
Severity	Always minor	Minor, Major, or Critical
Statuses	Scheduled → In Progress → Completed	Investigating → Identified → Monitoring → Resolved

Permissions

• Admin and Editor can create, edit, and delete maintenance windows
• Viewer can view maintenance windows but cannot modify them
• Status Viewer can only see maintenance on their assigned status pages