# Plan maintenance

> Keep alerts quiet during planned work with a weekly maintenance window or a one-off pause, and announce maintenance on your status page.

Source: https://upfour.io/docs/plan-maintenance

Afterwards up4 stays quiet while you do planned work, and your status page can tell visitors about it in advance.

- **Who:** Any role except **Viewer**
- **Time:** About ten minutes
- **What you need:** A monitor for the weekly window

To announce the work you also need a [status page](https://upfour.io/docs/publish-a-status-page.md).

## Choose how to plan it

| Your situation | Use |
| --- | --- |
| The same quiet time every week, such as a nightly backup | A weekly window on the monitor, described first. |
| One piece of work on one monitor, with no announcement | Open the monitor's **Actions** menu, choose **Pause**, then **Until…**. Checks stop now and resume by themselves at the time you pick, up to 90 days ahead. A paused monitor runs no checks. |
| Work you want to announce, once or repeating, for several components | Maintenance on a status page, described second. It can pause the affected monitors for you. |

**In up4:** Monitoring › Edit › Everything else › Maintenance window · [Open in up4](https://app.upfour.io/monitors)

## Mute alerts on a weekly schedule

### 1. [Open the monitor and select Edit](https://upfour.io/docs/plan-maintenance#edit)

Open the monitor from **Monitoring** and select **Edit**.

### 2. [Open the maintenance row](https://upfour.io/docs/plan-maintenance#row)

Under **Everything else**, open the row **Maintenance window**.

[![](https://upfour.io/docs/images/walk/en/plan-maintenance-row.webp)](https://upfour.io/docs/images/walk/en/plan-maintenance-row.webp)

### 3. [Switch the window on](https://upfour.io/docs/plan-maintenance#toggle)

Tick **Mute alerts on a recurring schedule**. up4 fills in 02:00 to 03:00 on all seven days.

[![](https://upfour.io/docs/images/walk/en/plan-maintenance-toggle.webp)](https://upfour.io/docs/images/walk/en/plan-maintenance-toggle.webp)

### 4. [Set the times and the time zone](https://upfour.io/docs/plan-maintenance#times)

Enter the start under **From** and the end under **Until**, then pick the **Timezone** the times are meant in. A window can run past midnight, for example from 23:00 to 01:00.

[![](https://upfour.io/docs/images/walk/en/plan-maintenance-times.webp)](https://upfour.io/docs/images/walk/en/plan-maintenance-times.webp)

### 5. [Pick the days](https://upfour.io/docs/plan-maintenance#days)

Under **On these days**, tick every weekday on which the window starts. You need at least one day: with none ticked, the form does not save and asks you to pick one. The sentence below the days repeats what you set.

[![](https://upfour.io/docs/images/walk/en/plan-maintenance-days.webp)](https://upfour.io/docs/images/walk/en/plan-maintenance-days.webp)

### 6. [Save](https://upfour.io/docs/plan-maintenance#save)

Select **Save changes**.

## How you know it worked

Open the monitor's page. Under **Check & settings**, open **Check**. There is a row **Maintenance** with your window in one sentence: the days, the times and the time zone.

Inside the window up4 does not run this monitor's checks. No result is stored, nobody is alerted and no incident opens. Outside the window the monitor behaves as before.

**In up4:** Status pages › Maintenance › Schedule maintenance · [Open in up4](https://app.upfour.io/status-pages)

## Announce maintenance on a status page

### 1. [Open the maintenance tab](https://upfour.io/docs/plan-maintenance#tab)

Open your status page from **Status pages**, go to the tab **Maintenance** and select **Schedule maintenance**.

### 2. [Describe the work](https://upfour.io/docs/plan-maintenance#describe)

Enter a **Title** and a **Description**. The description accepts markdown.

[![](https://upfour.io/docs/images/walk/en/plan-maintenance-describe.webp)](https://upfour.io/docs/images/walk/en/plan-maintenance-describe.webp)

### 3. [Set the window](https://upfour.io/docs/plan-maintenance#window)

Enter **Start date**, **Start time**, **End date** and **End time**. The page's time zone is preselected. Visitors see the window in their own time.

To repeat the window, set **Repeat** to **Every week** or **Every month**, and optionally an end date under **Until (optional)**. Repeats keep the local time, also across daylight saving changes.

[![](https://upfour.io/docs/images/walk/en/plan-maintenance-window.webp)](https://upfour.io/docs/images/walk/en/plan-maintenance-window.webp)

### 4. [Choose what happens to checks](https://upfour.io/docs/plan-maintenance#checks)

Under **During the window**, pick **Keep checking** or **Pause the affected monitors**. Keep checking leaves checks and alerts as they are. Pause the affected monitors pauses the monitors behind the components you pick next when the window starts and resumes them when it ends. Monitors you had paused yourself stay paused.

[![](https://upfour.io/docs/images/walk/en/plan-maintenance-checks.webp)](https://upfour.io/docs/images/walk/en/plan-maintenance-checks.webp)

### 5. [Choose the components](https://upfour.io/docs/plan-maintenance#components)

Tick the **Affected components** as your visitors know them. Pausing applies to the monitors among them.

[![](https://upfour.io/docs/images/walk/en/plan-maintenance-components.webp)](https://upfour.io/docs/images/walk/en/plan-maintenance-components.webp)

### 6. [Decide who is told and schedule it](https://upfour.io/docs/plan-maintenance#notify)

Leave **Notify subscribers** ticked to mail your subscribers, and choose a **Reminder to subscribers** if you want one. Select **Schedule maintenance**. If subscribers would be mailed, up4 asks you to confirm first. Without subscribers there is nothing to confirm.

[![](https://upfour.io/docs/images/walk/en/plan-maintenance-notify.webp)](https://upfour.io/docs/images/walk/en/plan-maintenance-notify.webp)

## How you know it worked

The window is listed under **Maintenance** as **scheduled**, and visitors see it on your status page until it starts. With **Start the window automatically** and **End the window automatically** ticked, which is the default, it starts and ends by itself.

## If something is off

The weekly window does not save.

You need at least one weekday, because a window without days would apply every day.

Alerts still arrive at the planned time.

Check the time zone of the window, and that the day you ticked is the day the window starts. A window from 23:00 to 01:00 belongs to the day it starts on.

Subscribers received nothing.

The mail goes to subscribers who follow maintenance and only if Notify subscribers was ticked. See [publish a status page](https://upfour.io/docs/publish-a-status-page.md).

## What up4 does not do here

- The weekly window repeats on the ticked weekdays. It does not take single dates. For a single date use a pause until a time, or maintenance on a status page.
- A monitor's weekly window and a status page maintenance are separate settings. Setting one does not set the other, and the weekly window is not announced to visitors.
- Inside a weekly window up4 does not check the monitor, so it cannot notice a real outage there. Keep windows as short as the work.
- Deleting a maintenance window removes it from the status page. Subscribers who were already told about it get no cancellation.

[Per API PATCH /v1/monitors/{monitorID}](https://upfour.io/docs/api/monitors#patch_monitors_monitorID)

| In the app | API field |
| --- | --- |
| From · HH:MM, in the window's time zone. | `maintenance_from` |
| Until | `maintenance_to` |
| Timezone · An IANA zone such as Europe/Berlin. | `maintenance_timezone` |
| On these days · Three-letter day codes; an empty list means every day. | `maintenance_weekdays` |

[Full reference](https://upfour.io/docs/api/monitors#patch_monitors_monitorID)

[Per API POST /v1/status-pages/{pageID}/updates](https://upfour.io/docs/api/status-pages#post_status_pages_pageID_updates)

| In the app | API field |
| --- | --- |
| Title · Send the entry as a maintenance update with status scheduled. | `title` |
| Start date · One timestamp; the app joins start date and start time. | `starts_at` |
| End date · One timestamp; the app joins end date and end time. | `ends_at` |
| Repeat · none, weekly or monthly. | `recurrence` |
| During the window · none keeps checking, pause_checks pauses the affected monitors. | `monitor_mode` |
| Affected components | `affected_resource_ids` |
| Notify subscribers | `notify_subscribers` |

[Full reference](https://upfour.io/docs/api/status-pages#post_status_pages_pageID_updates)