Skip to content

Maintenance windows

A maintenance window is a time when you work on your sites: updates, a move to another server, a planned restart. During it the checks keep running and their results are kept, but no alerts go out: no email to you, none to a group's addresses, no reminders. The hours are left out of the uptime figures. When the window ends, a site that is still down alerts you at once.

Open Maintenance in the side menu. The page lists your windows and, for Owners and Admins, has Plan maintenance at the top right. Maintenance windows are part of the paid plans; on the free plan the page shows an example of a window and how to get them.

The Maintenance switch of a single check, in the monitor's Settings, still works on every plan: see The Maintenance switch of a check.

Plan maintenance

Click Plan maintenance. The form asks what to keep silent, when, and an optional name. A line at the bottom is always there and says what will happen before you save, for example:

Sunday patching: 12 monitors silent every Sunday 02:00 to 04:00 Amsterdam (01:00 to 03:00 UTC). Next: Sun 8 Nov.

Click Save maintenance. To change your mind, click Cancel: nothing is saved.

What: monitors, groups and servers

Under What to keep silent, tick what should be silent. You can tick any mix of:

  • Monitors: each monitor you tick, with all its checks.
  • Groups: every monitor in the group. A monitor added to the group later is in the window too; a monitor moved out of the group is no longer in it.
  • Servers: every monitor whose Server field names that server, however it is capitalised. A monitor put on the server later is in the window too. This is the easiest way to silence everything a server update touches. Each server shows how many monitors are on it now.
  • The whole account, every monitor: every monitor you have now and every monitor you add later.

Each monitor shows its address beside its name. The search box above the list narrows what is shown by name, address, group or server; what you ticked always stays in view, at the top. A line under the search says what is ticked ("Ticked: Bright Bakery and server web-03"), with Show ticked only to see just those. The line under the list says at once how many monitors will be silent, each monitor counted once, even when it is ticked twice (by its name and by its group, for example).

When: now, once or repeating

Choose one of Now, Once, Daily, Weekly or Monthly:

  • Now: from the moment you save, for 30 minutes, 1 hour, 2 hours, or Until I end it. Use it when you start work straight away.
  • Once: on one date, from a start time to an end time. The date is today, or tomorrow once today's start time has passed.
  • Daily: every day, from a start time to an end time.
  • Weekly: on the days you tick, from a start time to an end time.
  • Monthly: on A date (the 1st to the 31st) or on A day of the week (the first, second, third, fourth or last Sunday, for example). The 29th, 30th and 31st fall on the last day of a shorter month.

An end time before the start time ends the next day, so 23:00 to 01:00 is a night's work. The start and the end cannot be the same time.

Time zones

The times are in your own time zone (the one in your profile, first in the list as Your time zone, with UTC after it) unless you choose another under Time zone. The preview line shows the same times in UTC beside them.

Summer and winter time follow by themselves. A repeating window keeps its local times when the clocks change: 02:00 to 02:15 in Amsterdam time stays 02:00 to 02:15 in Amsterdam, in winter and in summer. You never add an hour to cover the change.

A server's nightly restart runs on the server's clock. Choose the server's time zone for its window. A server on UTC that restarts at 01:00 does so at 02:00 Amsterdam time in winter and 03:00 in summer: a window of 00:55 to 01:15 in UTC follows it all year, where one in Amsterdam time would have to be two hours wide.

Name and preview

Name (optional): a few words such as "Sunday patching" make the list easier to read. Without a name the list shows when the window is, for example "From 10:14 to 11:14 Amsterdam (09:14 to 10:14 UTC)".

The preview line under the name shows one of three things:

  • with nothing ticked yet: "Tick what to keep silent, and this line says what will happen.";
  • when an answer is missing or wrong: what to fix first, such as "Tick at least one day.";
  • otherwise what will happen: the name, how many monitors are silent, when (in the chosen time zone and in UTC) and, for a repeating window, the next time it starts.

During a window

  • The Monitors list and the monitor's page show a wrench and In maintenance until 04:00 (in your time zone).
  • The checks go on, from every checking place, and their results are kept and shown as usual.
  • No alert email goes out: not the Down email, not an escalation, not a still-down reminder, not a Basic Auth reminder, not an SSL certificate warning, and nothing to a group's addresses. A server's outage email waits too.
  • When only some of a server's monitors are in a window, the server's outage email still goes and lists those monitors as in maintenance.
  • A Down email that went before the window started is followed by its Up again email when the site recovers, even during the window: good news is never held.
  • A window that starts while a site is already down keeps its problem open and holds its reminders until the end.
  • Two windows that overlap keep a monitor silent until the last one ends.
  • The results taken during the window are left out of the uptime figures, so planned work never lowers them.

When a window ends

  • A site that is still down when the window ends alerts you at once. The email says, for example, "Down since 4 November, 10:20 (Amsterdam time), during maintenance. This alert waited until the maintenance ended." You get it once.
  • A site that went down and recovered during the window sends nothing, then or later.
  • A reminder that waited (an escalation, a still-down email, a Basic Auth reminder) goes after the window if it is still true.

The list: end now, edit and delete

Each window shows its name, its state, what it covers ("Covers: group Acme and 2 monitors"), how many monitors that is, when it starts next or until when it is on, and who made it. The times of Next and Ended are in the window's own time zone, with UTC beside them. The states are:

You see What it means
Active now The window is on: its monitors are silent until the time shown.
Scheduled It starts later, at the time shown under Next.
Ended It is over. Ended windows stay for 30 days, under Ended in the last 30 days at the foot of the list; click it to open it.

Owners and Admins open the ... menu of a window for:

  • End now: ends the window at once, and alerts are on again. For a repeating window it ends only this time; the next ones stay planned. A site still down alerts at once.
  • Edit: opens the form with the window's answers, to change it in place. For a window started with Now, the first choice under For how long is Keep the end (with its time), so its start and end stay as they are unless you choose another length; a new length counts from the moment you save.
  • Plan again: in place of Edit for a window started with Now that has ended. It opens the form with the same answers, and saving makes a separate window from now; the ended one stays as it was.
  • Delete: removes the window and every later time of it. If it is on now, it ends at once and alerts are on again.

Members and Viewers see the list but cannot change it. Every window planned, changed, ended or deleted is in your account's history, with who did it; each start and end of a planned window is there too.

Quick ways in

  • On a monitor's page, in the Maintenance section: Silent for 1 hour makes a window named "Silent for 1 hour" and the monitor's name, for that monitor, from now for an hour. Plan maintenance opens the form with the monitor ticked. The same place shows the next window of the monitor. On a plan without maintenance windows, Silent for 1 hour shows a lock and the plan that has them, and opens this page, which explains them; Plan maintenance is not shown there.
  • During a window, the monitor's page says until when it is on. If one window covers the monitor, End now ends it there; if more than one does, Open in Maintenance leads to the list. If a check's own Maintenance switch is on, the section says so.
  • In the Monitors list: tick monitors, then click Plan maintenance in the bar. The form opens with them ticked.
  • For a server's updates, a window can also be opened and ended from the server itself when it is patched; it shows in the list as made by a server patch run. Ask us to set this up.

Uptime figures

The results taken during a window count neither as up nor as down. The uptime of the last 24 hours and of the last 30 days is worked out from the other results only (how uptime is counted).

The Maintenance switch of a check

Each check also has its own Maintenance switch in the monitor's Settings. While it is on, the check runs and its results are kept, but it sends no alerts, until you switch it off. It has no times: use it for a site you are rebuilding for days. A window is better for planned work with a start and an end, since it switches itself off.