Oracle Cloud Infrastructure Documentation

Manage Maintenance Windows

You can use maintenance windows to specify one-time or recurring periods when the target system or application that the monitor tests is under maintenance.

If the criteria to calculate the availability of the monitor is configured for monitors, the monitors continue to run during a maintenance window, however, the results for the maintenance window duration are not considered for availability calculations. For information on configuring the criteria to calculate availability, see Create a Monitor.

Additionally, for the duration of the maintenance window, the MaintenanceWindowActive dimension has the value 1 to indicate that the maintenance window is active and can be used in an MQL syntax to suppress alarms in the Oracle Cloud Infrastructure Monitoring service. For information on MQL syntax, see Monitoring Query Language (MQL) Reference.

To set a maintenance window for multiple monitors:

  1. Navigate to the Availability Monitoring page.
  2. On the left pane, ensure that Monitors is selected, and select the compartment and the APM domain in which your monitors are created.
  3. From the list of monitors, select the monitors for which you want to enable a maintenance window, click Actions, and then select Manage maintenance window.
  4. In the Manage maintenance window panel, select a Schedule type:
    • One time: Creates a maintenance window for a specific start and end time.
    • Recurring: Creates a maintenance window that repeats weekly or monthly.

      Select a Recurrence type: Weekly or Monthly.

  5. Specify the start and end time for the maintenance window in the Start Time and End Time fields.
  6. Click Submit.

When you set a maintenance window for the monitors, Enabled is displayed in the Maintenance window column on the Monitors page. You can use the Maintenance window filter on the left pane of the Monitors page to view monitors for which a maintenance window is enabled or disabled. For recurring maintenance windows, the monitor details page displays the schedule type, recurrence type, start time, and end time.

You can also set or remove a maintenance window for a single monitor:

  • Use the toggle button in the Maintenance window column, or click the Actions icon Actions icon for a monitor on the Monitors page and select the maintenance window action.
  • Click the name of the monitor on the Monitors page to open the monitor details page, click Actions Actions icon, and then select the maintenance window action.