Learn about the Wavefront BigPanda Integration.

BigPanda Integration

BigPanda is an algorithmic event and alert management platform. This integration allows to create BigPanda tickets from triggered alerts in Wavefront. Wavefront and BigPanda both support webhooks, so you can configure an incoming webhook in BigPanda and an outgoing webhook in Wavefront to pass notifications from Wavefront alerts into BigPanda. A BigPanda ticket created based on alert in Wavefront looks like this:

images/bigpanda_ticket.png

BigPanda Setup

Step 1. Create a BigPanda AppKey and Bearer Token

  1. Log in to your BigPanda instance.
  2. Click Integrations and then New Integration.
  3. Click Alerts REST API, type a name for the integration and then click Generate App Key. BigPanda generates an AppKey and a Bearer token
  4. Copy the AppKey and Bearer Token and paste them into a text file or scratch pad.

Follow this link for more details.

Step 2. Create a BigPanda Alert Target

  1. In Wavefront, create an alert target.
  2. Give the alert target a meaningful name.
  3. In the Triggers field, select the alert state changes that should trigger the notification. See Creating an Alert Target.
  4. Make sure the Type is Webhook.
  5. Paste the application’s notification URL into the URL field.

  6. In this case, URL would look like https://api.bigpanda.io/data/v2/alerts.
  7. In the Content Type field, select application/json.
  8. Add the following Custom Headers:
    Authorization - Bearer {Bearer Token from Step 1}
    
  9. Select Generic Webhook Template in Alert Target POST Body Template.
  10. Customize the template, as follows:
    {
      "app_key": "{AppKey from Step 1}",
      "host": [
     {{#trimTrailingComma}}
       {{#failingAlertSeries}}
         "Source-{{host}}",
       {{/failingAlertSeries}}
     {{/trimTrailingComma}}
      ],
      "status": {{#severitySevere}}"critical"{{/severitySevere}}{{#severityWarn}}"warning"{{/severityWarn}}{{#severityInfo}}"info"{{/severityInfo}}{{#severitySmoke}}"smoke"{{/severitySmoke}}, 
      "check": "{{#jsonEscape}}{{{name}}}{{/jsonEscape}}", 
      "description": "{{#jsonEscape}}{{{subject}}} {{{reason}}} [{{{severity}}}] {{{name}}}{{/jsonEscape}}\nMessage: \n{{#jsonEscape}}{{{errorMessage}}}{{/jsonEscape}}", 
      "additionalInformation": "{{#jsonEscape}}{{{additionalInformation}}}{{/jsonEscape}}", 
      "url": "{{{url}}}", 
      "alert_tags" : "{{#alertTags}}{{#jsonEscape}}{{{.}}}{{/jsonEscape}}|{{/alertTags}}",
      "incident_identifier": "{{host}}__{{#jsonEscape}}{{{name}}}{{/jsonEscape}}__{{#jsonEscape}}{{{condition}}}{{/jsonEscape}}",
      "host_tags": "{{tags}}", 
      "alert_severity": "{{{severity}}}", 
      "condition": "{{#jsonEscape}}{{{condition}}}{{/jsonEscape}}", 
      "createdTime": "{{{createdTime}}}",
      "startedTime": "{{{startedTime}}}",
      "sinceTime": "{{{sinceTime}}}",
      "endedTime": "{{{endedTime}}}"
    }
    
  11. Click Save to add the alert target in Wavefront.
  12. Browse to the Alert Target page. In the Name column, note the ID of the alert target you just created.

Step 4. Add the BigPanda Alert Target to Wavefront Alert

  1. In Wavefront, open the Alerts browser.
  2. If you have an alert, locate the alert and click the alert name to open the Edit Alert screen. Otherwise, create an alert. For help, see Creating an Alert.
  3. Scroll down to the Target List field.

  4. Enter the alert target ID into the Alert Target field.
  5. Select the alert target from the dropdown list to add the list of targets.
  6. Click Save.