• Get started
  • Documentation

Create and manage maintenance policies

Maintenance policies are only available for Standard and Enterprise plans.

Maintenance provides the ability to enable or disable multiple policies/integrations with a single entry. Possible use cases are:

  • You want to disable multiple integrations temporarily for a limited time, to prevent alerts from being created.

  • You want to schedule multiple policies to be enabled at the same time, for a particular maintenance routine.

Maintenance Policies can be found under the Policies tab on a team's dashboard, following Alert policies and Notification policies.

Team Maintenance

Team Maintenance provides the ability to enable or disable multiple alert policies/ notification policies/integrations belonging to specified team whereas Global Maintenance provides the ability to enable or disable multiple alert policies/ integrations defined globally. Possible use cases are:

  • You want to disable multiple team integrations temporarily for a limited time, to prevent alerts from being created.

  • You want to schedule multiple team alert/notification policies to be enabled at the same time, for a particular maintenance routine.

Team Maintenance page is located in Team page under Policies tab.

Add a Maintenance Entry

To add a maintenance entry, click ‘Add maintenance’ under the Maintenance section of the Policies page.

Highlights the Add Maintenance button in Policies on a team dashboard.

On the opening window, the following fields are populated:

A modal box shows up that allows you to specify the details of the maintence window you're adding.
  • Description: Optional. You can enter a short description for the maintenance if you like, for convenience.

  • Time: For example, if you select "For 5 Minutes", the maintenance will be active for 5 minutes from the time you save it by clicking the "Save" button. You can also select "Schedule" and configure a custom start and end date for the maintenance.

  • Maintenance Rules: You can specify the rules to be applied. Click the plus sign to add more rules. To specify a rule, select Enable/Disable, select Integration/Policy, and then start typing the name of the integration/policy you want to enable/disable. Auto suggestions will be provided as you type. Select the correct one from the suggestions by hitting Enter key.

After populating the necessary fields, click "Save". For example, let's say you added a maintenance for 30 minutes with the rule to "disable integration Nagios". Upon saving, integration "Nagios" will be considered disabled for 30 minutes, regardless of its own configuration in the Integrations page.

Planned, Current and Past Maintenance Entries

There are three sections on the Maintenance: Maintenance entries that are not active yet are listed under "Planned". The ones that are currently in effect are listed in under "Current". The ones that are expired or cancelled are listed under "Past".

For example, when you add a maintenance entry for 1 hour it goes under "Current" upon saving, because it becomes active immediately.

The actions you can execute on the maintenance entries are different for Current, Plan and Past:

  • Planned: You can edit and save a planned maintenance, or delete it.

  • Current: You can not edit or delete a currently active maintenance, but you can cancel it or change its expiry date. Cancelling and changing the end date is explained in the following section.

  • Past: You can not edit or delete a past/cancelled maintenance; you can only view it.

Cancel a Maintenance

You can't edit a currently active maintenance, but you can cancel it by clicking on the X to the right of the maintenance. The maintenance will immediately cease to be effective and move into Past maintenance list.

Change End Date

You can't edit a currently active maintenance, but you can extend or shorten its expiration date. Click on the clock icon to the right of the maintenance, and from the opening window, set the new end date for the maintenance.

Still need help?

The Atlassian Community is here for you.