Skip to content
HonkWatch
PricingLocationsHonk RadarHelpAPI Log inGet started
All help topics

Getting started

  • Getting started
  • How checks work

Monitors

  • Which monitor to use
  • Website monitor
  • API monitor
  • Keyword monitor
  • Ping monitor
  • Port monitors (TCP and UDP)
  • DNS monitor
  • SSL certificate monitor
  • Domain expiry monitor
  • Third-party services
  • Page load monitor
  • Heartbeat monitor (cron jobs)
  • Maintenance windows
  • Incidents

Alerts

  • Setting up alerts
  • Email alerts
  • Slack
  • Microsoft Teams
  • Discord
  • Telegram
  • PagerDuty
  • ntfy
  • Webhooks
  • Zapier

Phone and desktop app

  • The phone and desktop app
  • App alerts not arriving

Status pages

  • Status pages
  • Status page on your own domain

Team and account

  • Team members
  • Plans and limits
  • API keys and the API
  • Your account

Troubleshooting

  • A monitor says down but my site works
  • I did not get an alert
  • Allowing our checks through a firewall
  • Questions and answers

Help / Monitors

Maintenance windows

A maintenance window stops alerts while you work on something, such as a server upgrade or a planned restart. Checks keep running during the window, but no alerts go out and an outage that starts inside the window does not count against your uptime.

What you need first

  • At least one monitor.
  • The start and end time of the work. Allow a little extra at the end in case it runs over.

Plan a window

  1. Open Maintenance windows.
  2. Under Plan a window, type a Title, for example Database upgrade. If you leave it empty, the window is called Maintenance.
  3. Set Starts and Ends. The labels show which time zone the times are in: normally your own, or UTC if your browser has JavaScript turned off.
  4. Under Monitors, tick the monitors the work affects. If you tick none, the window covers all your monitors.
  5. Leave Tell people when it starts and ends ticked if you want a note sent. Untick it to stay quiet.
  6. Press Save.

The window appears in the list at the top of the page, with its start and end times and how many monitors it covers. While a window is running, (now) appears after its title.

To start a window straight away, set Starts to the current time. The end time must be later than the start time, or the window is not saved.

What happens during a window

  • Checks keep running, and the monitor's page still shows its current state.
  • If a covered monitor goes down, no incident is opened and no down alert is sent.
  • Repeat alerts pause, and start again after the window if the incident is still open and not acknowledged.
  • Slow, certificate expiry and DNS change alerts that would have gone out during the window are skipped. They are not sent later.
  • If a monitor was already down when the window started, its incident stays open. When it comes back up, the back online message is still sent, because a down alert already went out.
  • If a monitor is still down when the window ends, an incident opens then, counted from the end of the window, and the down alert goes out.

Who gets told

With Tell people when it starts and ends ticked, a short note goes out when the window starts and again when it ends:

  • To your alert channels, such as email, chat apps and webhooks. PagerDuty does not get maintenance notes, so no PagerDuty incident is opened.
  • To email subscribers of any status page that shows a covered monitor. Each subscriber only hears about the monitors they follow, and only those shown on that page.

Status pages also show the window to every visitor, whether it is ticked or not. A window that covers a monitor on the page appears near the top as planned maintenance before it starts, and as maintenance now while it runs.

Check it works

  1. Plan a short window a few minutes from now, covering one monitor, with Tell people when it starts and ends ticked.
  2. Open a status page that shows that monitor. The window should appear near the top.
  3. When the start time passes, check that the start note reached your alert channels. You can see it under Recently sent on Alerts.
  4. Press Remove to end the test early, if you like.

Change or end a window

Windows cannot be edited. To change one, press Remove on it and plan a new one. Removing a running window ends it at once: alerts resume straight away, and no end note is sent.

If it does not work

  • The window is not in the list after Save. Check that the end time is after the start time and that both are filled in.
  • The times are off by some hours. Look at the labels next to Starts and Ends. If they say UTC, enter the times in UTC, or turn on JavaScript so the page can use your own time zone.
  • An alert still came during the work. Check that the monitor was ticked, or that no monitor was ticked at all, and that the alert was not for an outage that started before the window. See Incidents.
  • Nobody got a start note. Check that Tell people when it starts and ends was ticked when you saved. For status page subscribers, the page must have Let people subscribe turned on and show at least one covered monitor.
← Heartbeat monitor (cron jobs) Incidents →

Still stuck? Email [email protected] and say which guide you were following.