Scheduling Maintenance Periods

Introduction

Alerts that match the defined filter criteria and are generated during the maintenance period are referred to as Maintenance alerts. Alerts generated after the maintenance period are referred as Monitoring alerts. Maintenance period is either one-time or recurring.

OpsRamp notifies users via email about the Start and End of a maintenance period. Alert notifications are sent to the user only after the maintenance period ends.

To receive notifications of Maintenance alerts, select the checkbox Escalate maintenance alerts when window ends while creating a Maintenance period. The escalate maintenance alerts option is enabled by default.

You can deselect the escalate maintenance alerts option if needed.
You can suspend an active schedule maintenance window.
You can schedule a suspend date for an active schedule maintenance

Creating schedule maintenance windows

To schedule a maintenance window:

Go to Infrastructure, click on the required resource category.
From resource list, click on the required resource name.
From the Overview page, click on the Settings drop-down.
From Assignment, click Schedule Maintenance.
From Create New Maintenance Period, provide the Name and Description and select the Timezone in which the maintenance window should run.
To escalate maintenance alerts generated during the maintenance period, ensure the toggle button for Escalate maintenance alerts when window ends is enabled. The alerts are escalated according to the alert conditions configured on Alert Escalation Policy.
Select one of the following schedule types:
- One-Time: A One-time maintenance window is for a specific date and time.
- Schedule Details: Select the start and end duration for the maintenance.
- Recurring: A Recurring maintenance window is for a repetitive duration.
  - Schedule Time: Select the start and end time for the maintenance.
  - Recurrence Pattern: Select the recurrence pattern for the maintenance window to run on Daily, Weekly or Monthly basis.
    - Daily: Select Daily recurrence to run maintenance window every weekday(Monday to Friday) or every x number of days starting from the date you choose in Range of Recurrence section.
    - Monthly: Select Monthly recurrence to run maintenance window on monthly schedule.
      - Select the Day recurrence to run the maintenance window on specific days of every month. For example, on the 4th day of every month.
      - Select the Weekday recurrence to run the maintenance window on specific weekdays of a month. For example, on the First Monday of every month.
  - Range of Recurrence: Select the start and end duration for the maintenance window. If the maintenance window should in a perpetual mode, in End By section, select Never.
If you want specific alerts to be triggered as maintenance alerts, configure the Alert Conditions.
- Alerts that do not match with the alert conditions are triggered as monitoring alerts.
- To configure:
  1. Click on the toggle button of Enable Alert Conditions to enable scheduled maintenance alerts for the resource.
  2. Perform the following steps to define the filter criteria:
    1. Select matching criteria to match Any or All of the rules.
    2. Filter for the Alerts using the Property, Operator, Value and then click Save.
    3. Click Add Criteria if you want to add more filter criteria.
Click Save. The new maintenance period is created.

Viewing scheduled maintenance alerts

The alerts occurring when the maintenance windows are active are known as scheduled maintenance alerts.

To view scheduled maintenance alerts:

Go to Alerts > Manage Views, click Add to create your customized Alert views.
Go to the Alert Type category, select Scheduled Maintenance, and click Apply.
From the Schedule Maintenance Alerts list, click on Alert ID to view alert details page.

These schedule maintenance alerts shift to monitoring alerts once the schedule maintenance window completes. To view the history of the monitoring alerts, you can view the comments and click the Schedule Maintenance button to view schedule maintenance window details.

Multiple maintenance periods

Depending upon the resource for which you are configuring the maintenance period, you can create a single or multiple maintenance periods. When a resource has multiple maintenance periods defined, following rules apply:

If maintenance period windows don’t overlap, they are treated as two independent maintenance windows.
If the maintenance windows overlap, they are treated as single window encompassing the time period covered by both maintenance windows. For example, if two windows each an hour in duration overlap by 30 minutes, the effective duration of the maintenance window would be 90 minutes.

Prerequisite for overlapping scheduled maintenance

You must have Device Manage permission to create maintenance periods on a resource.
To receive alert notifications, you must configure alert notifications in My Profile section.

Alert Conditions and its behavior during the overlapping period

Alert conditions help you to define the criteria for Maintenance alerts. If you want specific alerts to be triggered as Maintenance alerts, configure the Alert Conditions. During overlapping maintenance period, alert conditions defined in both maintenance windows are considered. However, after the overlapping maintenance period ends, the alert conditions defined in the second window would be be considered.