Defines the schema for configuring an alert filter.
Renamed API
The Alert Filter Plans API was previously called V1 Maintenance Plans or V1 Plans. The functionality of the API has not changed, but the name has been updated to clarify which BigPanda feature the API manages.
| API Endpoint | https://api.bigpanda.io/resources/v1.0/plans |
| Supported Methods | POST, GET, PATCH, DELETE |
Parameters
The Alert Filter Plan object schema includes the following attributes:
| Attribute | Description | Type | Example |
|---|---|---|---|
| id | System-generated unique identifier for the alert filter. | String | "id" : "1234a53b6789c12d3efg45h" |
| name | User defined name for the alert filter. | String | "name" : "Filter-SJC" |
| description | Brief summary of the alert filter. | String | "description" : "Filter for the SJC server upgrade" |
| bpql | The BPQL object to identify which alerts will be filtered. | JSON | "bpql" : "=" : "prod-sjc-5" |
| exclude_status | A list of alert status values that will be excluded from the filter. With new filters, the OK status is excluded by default unless exclude_status is explicitly declared in the payload. | Array of Strings | "exclude_status" : [ "Ok" ] |
| active | Whether the filter is active and will apply to incoming alerts | Boolean | "active" : "true" |
| created_on | Date and time the filter was created in ISO 8601 format. | Long | "created_on" : 1493922189 |
| created_by | The ID of the user who created the filter. | String | "created_by" : "Administrator 1" |
| updated_on | Date and time the filter was last updated in ISO 8601 format. | Long | "updated_on" : 1372854204 |
| updated_by | The ID of the user who last updated the filter. | String | "updated_by" : "Administrator 2" |
| schedule | The ID of the schedule associated to the filter. | String | "schedule" : "590b68f31f00001d0063753b" |
| custom_tags | Metadata about the plan in an array of key-value pairs. Attributes: - name - Ordered pair tuple name. String - value - Object value. String | Array of Objects | "custom_tags" : [ { "name" : "app", "value" : "esp"} ] |