Skip to main content

Maintenance Windows overview

Use Maintenance Windows to clearly identify alerts and incidents which occur during known maintenance or incident resolution activities.

Alerts created or updated with new events during active maintenance windows have identifying fields and values, when the alerts match the maintenance window criteria. These fields, along with visual indicators on the Incidents, Alerts, and Situation Room pages, help to raise awareness about alerts and incidents that occur during known issues, helping to reduce the amount of time it takes to resolve incidents. Take it a step further and add outbound integration filters or custom correlation definitions, and you can also use this information to reduce noise.

If you know that a system will produce alerts on a certain day at a planned time, you can schedule a maintenance window to update the maintenance fields of alerts originating from that system during the planned maintenance period. These fields make it possible to identify potentially impacted alerts and use them in a correlation definition or integration filter to help reduce noise.

Scheduling times when maintenance or outages are either occurring or will occur for known reasons helps to reduce the time it takes to investigate the causes of incidents. Maintenance window fields in alerts and incidents are helpful for historical purposes, showing that an alert occurred due to a known issue during a maintenance window. The Incidents, Alerts, and Situation Room pages displays a banner when any alerts in the incident were identified as "in maintenance," meaning that the incident was possibly impacted by one or more windows.

For details on working with maintenance windows in Moogsoft Cloud, see Manage maintenance windows.

Access Maintenance Windows by navigating to Correlate & Automate > Maintenance Windows.

Maintenance Windows page

The Maintenance Windows interface lists all maintenance windows: Active (current), Scheduled (future), and Expired (past).

Each tab includes:

  • The name of the maintenance window

  • An optional description

  • The user who created the window

  • The periodicity with which the window recurs (Repeat), if the window is scheduled to run multiple times

Active tab

Lists the names of maintenance windows that are active right now, including when the window is scheduled to expire (Ends In).

Clicking a window in the Active list displays a Summary tab showing the number of alerts and incidents potentially impacted by this maintenance window.

Scheduled tab

Lists the names of maintenance windows that are scheduled for the future, including when a window is next scheduled to become active (Next Active).

Clicking a window in the Scheduled list displays a Summary tab which shows the number of alerts and incidents which were potentially impacted by the last occurrence of a repeating scheduled maintenance window (or 0, if it is scheduled to only run once).

Expired tab

Lists the names of maintenance windows which are no longer active, including when the window expired (Ended At).

Clicking a window in the Expired list displays a Summary tab which shows the number of alerts and incidents which were potentially impacted by this expired maintenance window.

API documentation

For customized maintenance window management beyond the features supported by the user interface, see Maintenance Windows API Overview in the API documentation.