OIM Alerts
The Open Integration Manager enables you to create customizable inbound alert integrations through the configuration of a generic inbound integration rather than creating custom code. The integration manager sets parsing rules for incoming payloads, preprocessing the content to match incoming data requirements before it reaches the BigPanda enrichment engine.
The OIM Alerts API allows you to easily integrate a monitoring system with BigPanda. Monitoring systems generally send out events when problems are detected and when problems have been resolved.
The API receives event payloads from a monitoring system. Incoming events sent via the API are processed according to OIM settings and BigPanda alert correlation logic. Depending on the results of the correlation, the system then creates a new incident or updates an existing incident based on Event Aggregation rules.
Configuration
To manage integration configuration rules for the Open Integration Manager via API, use the OIM Configuration API.
Note
The Open Integration Manager offers additional flexibility with authentication parameters. The following syntax can be used for the Token and App Key:
Auth Token:
query string: access_token=<token>
header: Authorization: Bearer <token>
header: x-auth-token: <token>
App Key
Query string: app_key=<app_key>
header: x-app-key: <app_key>
header: app_key: <app_key>
body: { "app_key": "<app_key>" }
Open Integration Manager (OIM) Alerts
Authentication
All BigPanda APIs require Bearer Token Authorization in the call headers.
This API uses the Org Token type of Authorization token.
BigPanda recommends adding Authentication headers only in the secure tool you use to make API calls.
curl -request POST \ -url https://integrations.bigpanda.io/oim/api/alerts \ -header 'Content-Type: application/json' \ -header 'Authorization: Bearer <ORG TOKEN>' \ -data '{ "app_key": "<app_key>", "status": "critical", "host": "production-database-1", "check": "CPU overloaded", "timestamp": 1402303570, "application": "Billing", "regions":["US1","US2","EMEA"], "count": 47, "description": "CPU is above warning limit (40%)",}'
curl -request POST \ -url https://eu.integrations.bigpanda.io/oim/api/alerts \ -header 'Content-Type: application/json' \ -header 'Authorization: Bearer <ORG TOKEN>' \ -data '{ "app_key": "<app_key>", "status": "critical", "host": "production-database-1", "check": "CPU overloaded", "timestamp": 1402303570, "application": "Billing", "regions":["US1","US2","EMEA"], "count": 47, "description": "CPU is above warning limit (40%)",}'
curl -request POST \ -url https://integrations.bigpanda.io/oim/api/alerts \ -header 'Content-Type: application/json' \ -header 'Authorization: Bearer <ORG TOKEN>' \ -data '{ "app_key": "<app_key>", "alerts": [{ "status": "critical", "host": "production-database-1", "check": "CPU overloaded", "description": "CPU is above warning limit (40%)" }, { "status": "critical", "host": "production-database-2", "check": "CPU overloaded", "timestamp": 1402303570, "application": "Billing" }] }'
curl -request POST \ -url https://eu.integrations.bigpanda.io/oim/api/alerts \ -header 'Content-Type: application/json' \ -header 'Authorization: Bearer <ORG TOKEN>' \ -data '{ "app_key": "<app_key>", "alerts": [{ "status": "critical", "host": "production-database-1", "check": "CPU overloaded", "description": "CPU is above warning limit (40%)" }, { "status": "critical", "host": "production-database-2", "check": "CPU overloaded", "timestamp": 1402303570, "application": "Billing" }] }'