Maintenance plans mark and correlate incidents to reduce noise during system maintenance windows.
Use the Maintenance Plans API to define time windows that parallel infrastructure changes of respective monitored services.
Maintenance Plans are configured in BPQL Object format and, once activated, mark events that match the criteria for maintenance. Origin tags supplied by a monitoring source and enriched tags automatically generated by the Enrichment API are also supported for querying.
Relevant Permissions
See the Manage Planned Maintenance 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.
Plan Limit
Each organization can only have 3,500 maintenance plans at a time.
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.
Available Objects & Actions
| Object | Description | Supported Methods | API Endpoint |
|---|---|---|---|
| Maintenance Plan Object | Defines the schema for configuring a plan and schedule. | POST, GET, PATCH, DELETE | <https://api.bigpanda.io/resources/v2.0/maintenance-plans-v2> |
Use the Maintenance Plans V2 to perform these actions:
| Action | Definition | Description |
|---|---|---|
| Create a Plan | POST /maintenance-plans | Creates a new schema definition for creating a new maintenance plan. |
| Retrieve a Plan | GET /maintenance-plans/{id} | Retrieves the schema definition for a specific maintenance plan. |
| Retrieve All Plans | GET /maintenance-plans | Retrieves the schema definitions for all maintenance plans. |
| Update a Plan | PATCH /maintenance-plans/{id} | Updates a specific maintenance plan. |
| Delete a Plan | DELETE /maintenance-plans/{id} | Deletes a specific maintenance plan and removes it from the system. |
| Stop Plan | POST /maintenance-plans/{id}/stop | Stops a specific maintenance plan. Note: Only active plans can be stopped. |
To learn more about Maintenance Plans v2, see Manage Planned Maintenance
API Key Authentication Protocol
A User API Key is required for authentication.
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.