ServiceNow Maintenance Plans

The ServiceNow Maintenance Plan Integration allows the identification of infrastructure changes to reduce alert noise during maintenance windows.

Supported Versions:
Paris, Orlando, New York, Madrid, London, Kingston, Jakarta, Istanbul

Type:
API

Key Features


  • Suppress alerts from infrastructure undergoing maintenance
  • Use ServiceNow encoded queries to filter which changes generate a maintenance plan
  • Define which change states generate a plan
  • Optionally include task data, with optional filtering
  • Specify tag names to match against affected configuration items, supporting exact and wildcard matches.
  • Map classes to BigPanda maintenance conditions

How it works


The BigPanda ServiceNow Maintenance Plan integration works by setting up conditions for when ServiceNow Change Requests will automatically generate a BigPanda maintenance plan using the BigPanda Maintenance Plan V2 API.

Configure the Integration

  1. In the ServiceNow application, navigate to BigPanda > Configuration.
  2. In the General section, the following fields are required to enable Maintenance Plans.

Field

Description

Bearer Token

Enter the BigPanda organization key here.

API Key

Enter the BigPanda API key here.

Note: All remaining General section fields are not required for Maintenance Plans to function.

  1. Configure Maintenance Plan section (Save Configuration after completed)

Field

Description

Active

Select this checkbox to enable configuring the integration settings.

Change Filter

Optional ServiceNow encoded query to filter which changes generate a maintenance plan.

Include Task Data

Checkbox to include Task Data in plan.

Task Filter

Optional ServiceNow encoded query to filter which Tasks are included in plan.

Task Cancel States

Comma delimited list of states that represent a cancelled task.

Change States

Comma delimited list of all change states that will trigger a maintenance plan.

Stop States

Comma delimited list of change states that represent a stopped change.

Cancel States

Comma delimited list of change states that represent a cancelled change.

Start Field Name

The field name for the planned start of change.

End Field Name

The field name for the planned end of change.

Affected CIs Table Name

Table name to query for Affected Configuration Items.

Affected CIs Query

Query performed on Affected CIs Table.

Name

Tag name to match affected CIs

Default

Checkbox to indicate this Tag is a default tag

Exact

Checkbox to indicate this Tag is to be matched exactly (unchecked will cause match if Tag Name is found within affected CI, ie host-01 would match a tag name host)

Class

Class to map to maintenance condition

Maintenance Conditions

Maintenance conditions that map to class

Maintenance Endpoint

URL to send maintenance plans

Disabling the Integration


  1. In the ServiceNow application, navigate to BigPanda > Configuration.
  2. In the Maintenance Plan section, de-select the Active checkbox
  3. Save the configuration

Uninstall the BigPanda ServiceNow App


  1. Within ServiceNow, navigate to System Applications > Applications.
  2. Click on the BigPanda app.
  3. In the custom application record, click the related Uninstall link.
  4. Click OK.
  5. Confirm when the dialogue box appears.

Updated 4 months ago

ServiceNow Maintenance Plans


The ServiceNow Maintenance Plan Integration allows the identification of infrastructure changes to reduce alert noise during maintenance windows.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.