Maintenance windows

To go to the Maintenance windows page, click > Maintenance window.

Maintenance windows define the time periods during which testing or alerting will be temporarily stopped. For example, your system may have scheduled maintenance, such as a database backup, that might affect performance. Suspending tests during this

Users must have the Account Primary, Account Admin, or Test Admin profile to create or manage maintenance windows.

Types of maintenance windows

There are two types of maintenance windows: recurring and one-time.

Recurring maintenance windows enable you to define time periods during which testing and/or alerting will be temporarily stopped. Recurring maintenance windows can be set at the account or at the test level. When configured at the account level, recurring maintenance windows can be applied globally to all active and inactive tests or to new tests only.

One-time maintenance windows operate at a single, specific time. The one-time maintenance window begins at an explicit start date and ends at an explicit end date. One-time maintenance windows cannot be configured as an account-level default.

For either recurring or one-time maintenance window, there are these two categories:

  • Test – The test does not run during the specified time period.
    This maintenance window type is available for Backbone tests, and for Last Mile and Private Last Mile tests that are not in batch orders.
  • Alert – The test runs as scheduled however, alerting is temporarily stopped.
    This maintenance window type is only available for Backbone tests.

Maintenance windows page

Use the Maintenance windows page to create, review, and edit maintenance windows.

  1. The page is organized into two tabs that list the recurring windows and one time windows.
    By default, the one time windows tab only lists maintenance windows that are still active. To include maintenance windows that have expired, select Show historic windows above the list.
  2. In the recurring windows tab, click the Show default only switch to list only the default maintenance windows. These maintenance windows are also listed in the Test defaults page.
  3. The maintenance window name indicates the date and time of the window, e.g. "Every Sunday between 23:30 - 23:45". The (Default) label identifies maintenance windows that are defined as test defaults. The list is sorted by day — Sunday through Saturday — and time.
  4. Click the Expand icon at the end of a row to list all tests that use the selected maintenance window.
  5. To display only the maintenance windows used by specific tests or the tests in specific folders, type any part of the test or folder name in the Filter by test/folder name field. When the list is filtered, expanding a maintenance window shows only the tests with names that contain the filter string and the tests that are included in folders with names that contain the string.
  6. From this page, you can create a new maintenance window, and you can Edit, Copy, or Remove a selected maintenance window.
  7. Click Create maintenance window to add a new maintenance window.

Creating or editing a maintenance window

You can also create or manage maintenance windows for individual tests. For more information, see the test settings pages.

To create a new maintenance window, click Create maintenance window at the top right of the Maintenance windows page.

To edit a maintenance window, click Edit  for the selected maintenance window.

The settings are the same for creating or editing a maintenance window.

Select whether the maintenance window is recurring or one time.

Select whether the maintenance window is for tests or alerts.

  • Tests – Suspend all test runs during the maintenance window.
  • Alerts – Continue running tests, but do not send alerts.

Select the day, and the beginning and end of the time period.

To add a recurring maintenance window to the test defaults, click the control for Apply this maintenance window to all new tests to enable it .

The maintenance window is automatically added to the recurring windows list in the Test defaults page.

This option is not available for one-time maintenance windows.

To apply the Optional filter, click the expand icon to display the settings.

  • To select only tests that were Last modified or Created within a specific date range, select one of those options from the Show field. Then click in each date field to display a calendar to select the start and end date/time.

  • Show inactive tests is enabled by default. Click the control to turn it off .

  • To see only specific product types (test types), clear the check box for any type you want to exclude.

Assign one or more tests to the maintenance window.

A maintenance window must be assigned to at least one test, even if you're creating it as a default.

If you selected tests as the maintenance window type, all test types can be assigned to the maintenance window, but Last Mile or Private Last Mile tests that are in batch orders are not available.

If you selected alerts as the maintenance window type, only Backbone tests can be assigned to the maintenance window.

  • Optional: Select a folder from the Select folder list.
    If you want to see only the tests that are not already in a folder, select Tests with no folder.

  • Click the Select tests from this group field to display the list of tests.
    To filter the list, type a string in the field at the top of the list. The list is filtered to show only tests that contain the string anywhere in their names.

  • Click the check box next to each test you want to add to the folder, then click Add test.

When you've finished configuring the maintenance window, click Done to save the settings and return to the Maintenance windows page.

When a maintenance window is created or edited, test settings are automatically updated for tests that were added to or removed from it.