Maintenance Plans V1

Maintenance Plans allow for the suppression of events. Use the Maintenance Plans API to define time windows that parallel infrastructure changes of respective monitored services.

The Plans v1 API enables users to set and maintain maintenance windows and alert filters to reduce noise for operators.

Plans are configured with BPQL queries and, once activated, will suppress alerts that match the criteria.

The Plans v1 API can be used to manage Alert Filters that have been configured in the BigPanda API. Alert filters affect alerts after they have been normalized and enriched, enabling complex filters based on additional metadata and enrichment tags. The plan ID for alert filters is the last 24 characters in the filter URL.

Schedules define a start and stop time frame for the plan or alert filter. If a plan does not have a schedule defined, it will start immediately and run indefinitely - filtering all matching alerts until deactivated.

❗️

Schedule ID

The schedule ID is needed to add the schedule to a plan or filter.

Relevant Permissions

See the Maintenance Plans V2 guide for a full explanation of the permissions required to access the Maintenance Plans section, the Plans V1 API and the Maintenance Plans V2 API:

To learn more about how BigPanda's permissions work, see the Roles Management guide.

Use Cases

You can use the Maintenance Plan API to keep in sync with infrastructure changes and parallel your monitoring activity accordingly. For example, the set of servers under a certain host, i.e. Billing, is scheduled to undergo upgrades for a duration of one week. Due to the non-operational nature of the servers during this time, all alerts generated by them will be unnecessary for monitoring.

Instead of having these alerts continue to stream into the feed and disrupt workflow, create a matching Plan with the query host = "billing*" and a Schedule of one week in the same time frame as the upgrades. This will suppress the irrelevant alerts from ever entering the feed.

🚧

Plan Limit

Each organization can only have 3,500 V1 maintenance plans (Also called alert filters).

🚧

Condition Limitations

Maintenance plan conditions cannot be longer than 25,000 characters long.

All alert tags in maintenance plan conditions must be listed in lowercase, regardless of the tag's system case.

The condition body parameter uses special BPQL object formatting. See BPQL Object Syntax for more information.

📘

OK Status

By default, V1 maintenance plans ignore events that have an ok status. These events will still enter the system and resolve any related open alerts.

This setting can be changed by explicitly including the exclude_status field as an empty array.

Available Objects & Actions

ObjectDescriptionSupported MethodsAPI Endpoint
Plans ObjectsDefines the schema for configuring a plan and schedule.POST, GET, PATCH, DELETE<https://api.bigpanda.io/resources/v1.0/plans>

Use the Plans API to perform these actions:

ActionDefinitionDescription
Create a PlanPOST /plans/Creates a new schema definition for creating a plan.
Retrieve a PlanGET /plans/{id}/Retrieves a specific schema definition for a created plan.
Retrieve All PlansGET /plans/Retrieves the schema definitions for all plans.
Update a PlanPATCH /plans/{id}Updates a specific plan to stop the maintenance period immediately.
Delete a PlanDELETE /maintenance-plans-delete/Lists all plan schema definitions that exist for an organization.

🚧

Rate Limitations

To maintain quality of service, BigPanda APIs are limited to 5 requests per second.
Additional requests will return a 429 response code and the request will need to be retried.