# Scheduled Maintenance

## Introduction

It is a feature using which user can define a maintenance period for a resource. This document explains the procedure to manage the schedule maintenance windows.

## Create Schedule Maintenance Window

1. Login to OpsRamp.
2. Click **All Clients** and select the client.
3. On the drop-down menu, click **Infrastructure**.\
   &#x20;![](https://docs.opsramp.com/wp-content/uploads/2017/08/Infrastructure-menu-drop-down-271x300.png)
4. On the device listing page, select the **Resource** and click Schedule Maintenance button.
5. Provide the **Name** and **Description** and select the Timezone in which the maintenance window should run.
6. To escalate maintenance alerts generated during the maintenance period, select **Escalate maintenance alerts when window ends**. The alerts are escalated according to the alert conditions configured on Alert Escalation Policy. See [Alert Escalation](https://opsramp.gitbook.io/feature-guide/alert-escalation-1) to know about escalation policy.\\

   **Note**: Escalate maintenance alerts option is enabled by default. However, user can deselect the option if required.

   ![](https://docs.opsramp.com/wp-content/uploads/2017/08/Name-and-Description-of-the-Scheduled-Maintenance-600x274.png)
7. Select the schedule type:
   1. **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.\
        &#x20;![](https://docs.opsramp.com/wp-content/uploads/2017/08/One-Time-Maintenance-Window.png)
   2. **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.
   3. **Range of Recurrence**: Select the start and end duration for the maintenance window.\\

      **Note**: If the maintenance window should in a perpetual mode, in **End By** section, select **Never**.\
      &#x20;![](https://docs.opsramp.com/wp-content/uploads/2017/08/Range-of-Recurrence.png)
8. **Alert Conditions**: 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.
   1. Select **Enable Alert Level** to enable scheduled maintenance alerts for the resource.
   2. In Filter Criteria section,
      * Select matching criteria to match **Any** or **All** of the rules.
      * Filter for the Alerts using the Property, Operator, Value and then click **Save**.\
        &#x20;Click **Add Criteria** to add more filter criteria.

        **Note**: See [Regular Expression](https://docs.opsramp.com/device-management-policies/#Appendix_Regular_Expressions) to filter for alerts using value Regex.

        ![](https://docs.opsramp.com/wp-content/uploads/2017/08/Alert-Conditions.png)

**Note**:

* You can suspend an active schedule maintenance window.
* You can schedule a suspend date for an active schedule maintenance window.

## Scheduled Maintenance Alerts

The alerts occurring when the maintenance windows are active are known as Scheduled Maintenance Alerts.

Instructions to view Scheduled Maintenance Alerts

1. Login to OpsRamp.
2. On the drop-down menu, click **Alerts**.\
   &#x20;![](https://docs.opsramp.com/wp-content/uploads/2017/08/Alerts-menu-1-229x300.png)
3. Click **Manage Views** and click **Add** to create your customized Alert views.
4. Select the **Alert Type** as Schedule Maintenance and click **Apply**.
5. Schedule Maintenance Alerts list appears, then click on **Alert ID** to view alert details page.

![](https://docs.opsramp.com/wp-content/uploads/2017/07/Schedule-Maintenance-Alerts-View.png)

![](https://docs.opsramp.com/wp-content/uploads/2017/08/Schedule-Maintenance-Alerts-Details-Page-600x325.png)

These schedule maintenance alerts will shift to monitoring alerts once the schedule maintenance window is completed. To view the history of the monitoring alerts you can view the comments and click  [![](https://docs.opsramp.com/wp-content/uploads/2017/07/SM_Icon.png)](https://docs.opsramp.com/wp-content/uploads/2017/07/SM_Icon.png) Schedule maintenance button to view schedule maintenance window details.&#x20;
