Manage Maintenance Windows

You can use maintenance windows to specify a period of time that the target system or application that the monitor is testing will be 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.

In addition, 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 enable a maintenance window for multiple monitors:

  1. Navigate to the Synthetic 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, ensure that the Enable radio button is selected. This option is selected by default and the Disable radio button can only be selected if a maintenance window is already enabled for the selected monitors.
  5. Specify the start and end time for the maintenance window in the Start Time and End Time fields.
  6. Click Submit.

On enabling the maintenance window for the monitors, Enabled is displayed in the Maintenance window column on the Monitors page. You can select multiple monitors for which you enabled the maintenance window and perform the same set of steps to disable the maintenance window. In addition, you can use the Maintenance window filter on the left pane of the Monitors page to filter the list of monitors and only view those for which a maintenance window is enabled or disabled.

Note that you have a couple of other options to enable or disable 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 Enable maintenance window or Disable maintenance window to enable or disable a maintenance window.
  • Click the name of the monitor on the Monitors page to access the <name of the monitor> (monitor details) page, click Actions and then select Enable maintenance window or Disable maintenance window.