Downtime operations

This section describes how to add/edit/delete downtime.

A downtime contains the following information: a schedule start time and a schedule end time.

Downtimes can be triggered to start or stop immediately.

Downtimes are organized using tags from the monitors.

Downtime types

Two schedule types are available (the Type selector in the downtime form):

  • Custom — a one-off maintenance window defined by a start and an end date/time (a date-time range picker). Once the end time is reached the downtime is done.
  • Regular — a recurring weekly window. Pick one or more start days of the week plus a start time, and one or more end days of the week plus an end time. The webserver turns this into internal cron schedules and re-triggers the downtime every week until you disable or delete it. Typical use: “every Saturday 22:00 to Sunday 06:00” for a weekly batch or backup window.

The type of an existing downtime cannot be changed while it is running.

Downtime scope: monitors, tags and applications

A downtime can target, in any combination:

  • explicit monitors of every type (browser scripts, URL, API, TCP, UDP, ping, nslookup, DB, SNMP devices, WMI devices, system/hosts),
  • tags per monitor type — every monitor of that type carrying the tag is included,
  • applications — all monitors that belong to the selected app(s) are included, child (nested) apps are expanded recursively.

While the downtime is active, the affected monitors are not scheduled to run and their status is frozen; when it ends, their pre-downtime status is restored.

Impact preview

Before saving, the downtime form shows an impact preview: the current scope (monitors + tags + apps) is resolved server-side — without saving anything — and the resulting list of affected monitors and applications is displayed, grouped by monitor type, with the probe each monitor runs on. Use it to verify a tag does not pull in more monitors than intended.

Downtimes are organized by tags

The computed list of monitors

Downtimes can be associated with tag(s) and/or monitor(s). The list of monitors they reference is generated from the tag(s) and/or monitor(s).

For instance: mon1 has tag1, mon2 has tag1 , mon3 has tag2, mon4 has no tag. A given report has monitor mon4 and has tag tag1, then the computed list of monitors for this report will be mon1, mon2, mon4. The downtime will be triggered for each monitor in this list.

Accessing downtimes and user privileges

Users in the ADMIN group can add, edit, or delete a downtime, as well as add or remove monitor(s) and/or tag(s) from a downtime.

UUsers with tags matching those on the downtime and belonging to the USER group can also add, edit, or delete a downtime, as well as add or remove monitor(s) and/or tag(s) from a downtime

A downtime can have one or more tags.

Add a Downtime

  1. Click on the plus icon
downtime add

A. Go to the Settings panel

  1. Set the downtimename, state (enabled/disabled), optionnally a description.
  2. Add monitors and/or tags fields for this downtime.
  3. Add recipients emails, the Data Range over which the data should be collected, enter the scheduled date time.

B. Click on save

downtime add
  1. The new downtime appears in the list
  2. A notification window box will appear at the right corner
downtime add

Edit a Downtime

  1. Click on the pencil icon
downtime editing

A. Go to the Settings panel

  1. Edit the downtimename, state (enabled/disabled), description.
  2. Edit monitors and/or tags fields for this downtime.
  3. Edit recipients emails, the Data Range over which the data should be collected, edit the scheduled date time.

B. Click on update

downtime editing
  1. The new tag should be visible in the downtime list.
  2. A notification window box will appear at the right corner
downtime editing

In the below screenshot, we can see:

downtime status
  1. A completed downtime
  2. A scheduled downtime
  3. A running downtime

Start a Downtime immediately

  1. click on the forced start icon (1)
downtime start
  1. The downtime state should have changed.
downtime start

There’s a notification box saying that the downtime was triggered

downtime start
  1. The monitors related to this downtime should be in downtime. From now they should not be scheduled to run.
downtime start

Stop a Downtime immediately

  1. click on the forced stop icon (2)
downtime stop
  1. Enter the recipient email address
downtime stop

There’s a notification box saying that the downtime was triggered

downtime start

Delete a Downtime

  1. Click on the trash icon
downtime delete
  1. Confirm the deletion
downtime delete
  1. The downtime is currently running (by design we cannot delete a running downtime)
  2. That deletion was prevented as this donwtime is still running. A status is displayed in the notification box
downtime de:lete
  1. The downtime is no longer in the list
  2. The deletion status is displayed in the notification box
downtime de:lete

Calendar view

Toggle between the default table view and a calendar view using the two buttons above the downtime list (table icon / calendar icon). The calendar view is useful for spotting overlapping maintenance windows at a glance.

  • Displays a month grid; navigate with the previous/next arrows.
  • Both regular (recurring weekly schedule) and custom (one-off date range) downtimes are expanded into concrete chips on the days they cover. A chip spanning multiple days is truncated with a continuation marker on the days it doesn’t start/end on.
  • Chip color distinguishes regular vs custom downtimes; a dimmed style marks a downtime that is off/done, and a highlighted style marks one currently running.
  • A day with more than one downtime active shows an overlap badge (e.g. ) in its corner.
  • Hovering a chip shows its full name, type, time range, state, and owning user.
  • Click a chip to open that downtime in the edit/view modal (same as the table’s pencil icon). Right-click a chip for a context menu with the same actions available in the table row (edit, enable/disable, force start/stop, delete).

Filter downtimes

We can filter downtimes based on their state (enabled/disabled) or their name.

  1. Click on the given button to toggle the filter
  2. Click on any of these value to filter based on the state
  3. Type in case sensitive pattern (part of the downtimename, tag, monitor) and type enter
downtime filter
  1. Type in “MN” and type enter
  2. Downtimes matching this criteria should appears in the list
downtime filter

See also

Translations