BigPanda Integration

Contents

Introduction

Before you begin

Configure xMatters

Configure BigPanda

Test the integration

Troubleshooting

Appendix - Subscriptions

Download resources

The information in this article is the intellectual property of xMatters and is intended only for use with xMatters products by xMatters customers and their employees. Further, this intellectual property is proprietary and must not be reused or resold.

Introduction

This article provides installation, configuration, and implementation details when integrating xMatters On-Demand with BigPanda

How it works

BigPanda correlates alerts from various monitoring system into high-level incidents, helping users such as IT Administrators or Operations teams reduce noise and spot critical issues faster.  By coupling BigPanda with the power of xMatters, this integration:

  • Automatically notifies the recipient on a variety of devices when an incident is created or updated.
  • Allows for email, voice, SMS, and push messages to recipients.
  • Allows recipients to reply with "Acknowledge" or "Escalate" from their device.

The integration combines the highly-customizable Environments and AutoShare features with the notifications webhook in BigPanda, which sends an event to xMatters. When there is a change in the status of an incident, the AutoShare triggers an API call to xMatters with a payload. Once the payload arrives at the Integration Builder, xMatters creates an event and notifies the recipients:

  • If a user is targeted, the user's devices will be notified. This recipient can response with "Acknowledge" and terminate the event.
  • If a group is targeted, the first active member in the roster will be notified. This recipient can response with one of the following:
    • "Acknowledge", which terminates the event, or
    • "Escalate", which immediately sends the event to the next user in the escalation list.

All three callback types (event status updates, device delivery updates, and notification responses) are active by default.

Features and updates

This version of the xMatters On-Demand and BigPanda integration uses the notification webhooks created within BigPanda.

Custom Environments and AutoShare

The built-in "All" Environment includes every incident in BigPanda. You can also create custom Environments within BigPanda so different users can focus on the most relevant incidents. These environments can be defined by the areas of responsibility and process in your organization such as "web", "database", "mail", "finance" and so on. A server can be in multiple environments, so different teams can be notified based on the context of the incidents.

The AutoShare feature creates a customized workflow within xMatters to handle BigPanda monitored incidents and alerts.  Whenever an incident is created, resolved or reopened in BigPanda, the environment(s) monitoring the incident automatically shares it through the integration channel.

After an event is created in xMatters, Event status updates, Device delivery updates, and Notification responses can be sent back to the source BigPanda incident via outbound integrations.

Before you begin

Download the communication plan

To begin, download the communication plan attached to this article; it contains everything needed for this integration. You do not need to extract the contents.

Create users and groups that will receive notifications

The integration will notify groups and users when events are created in xMatters. They must exist in xMatters before they can be listed as recipients:

Obtain BigPanda Bearer Token

You need to set a request header that includes a Bearer token for authentication in each BigPanda API call. To find your token in BigPanda, click the Integrations tab at the top of BigPanda screen. Then click the existing integration or create a new integration for the API or wrapper you are using. Your token appears automatically in the instructions.

For more details, see the BigPanda documentation.

Configure xMatters

The first step in setting up your integration is to configure xMatters.

Set up an integration user

This integration requires a user who can authenticate REST web service calls when working with events – these permissions are provided by the "REST Web Service User" role in xMatters.

For Free and Trial customers, your system has an "Integration User" already configured with the REST Web Service User role, so you don't need to burn up an extra user from your limited supply. Make sure you've changed this user's password from the default, then you're good to go.

For everyone else, we recommend you create a user specifically for this integration because this user appears as the initiator or submitter of events from the integration (in messages, the Communication Center, event reports, etc.). Give this user the "REST Web Service User" role and a profile that lets you easily identify the user as specific to the integration – for example:

  • User ID: bigpanda
  • First name: BigPanda
  • Last name: Integration

Note: Make sure you keep the user ID and password of this user handy. You'll need them when configuring other parts of this integration.

Import the communication plan

The next step is to import the communication plan into xMatters.

To import the communication plan:

  1. In the target xMatters system, click Import Plan from the Developer tab.
  2. Click Choose File, and then locate the downloaded communication plan (.zip file).
  3. Click Import Plan.
    • Importing the plan will automatically enable it, and enable its forms for web services.
  4. Click the Edit drop-down list for the plan, and then select Access Permissions.
  5. Add the integration user, and then click Save Changes.
  6. Click the Edit drop-down list for the plan, and then select Forms.
  7. For the AutoShare webhook form, click Web Service Only > Sender Permissions.
  8. Enter the integration user, and then click Save Changes.

Set notification recipients

The BigPanda Incident form uses the default recipients specified on the Layout tab to determine who to notify about an incoming alert.

  1. On the Forms tab, click Edit > Layout.
  2. In the Recipients section, add all of the groups and users you want to receive BigPanda AutoShare notifications.
  3. Click Save Changes.

Configure integration settings

 After you import the communication plan, you need to setup the BigPanda constant.

  1. From the communication plan, click the Integration Builder tab, and then click Edit Constants.
  2. Select the BigPanda_BEARER constant, paste your BigPanda Bearer Token into the Value field, and then click Save Changes.

Configure inbound integration

You will need to configure the authentication and retrieve the URLs for the inbound integration to configure Big Panda.

To configure an inbound integration:

  1. In the Integration Builder, expand the list of inbound integrations.
  2. Click the AutoShare webhook integration to view its details.
  3. Under the Select authentication method step, select Basic Authentication from the drop-down list.
  4. Click Update Inbound Integration.
  5. Scroll down to the bottom of the page, and click Copy URL beside the field:

CopyURL.jpg

Configure BigPanda

Now that you've configured xMatters to integrate with your system, it's time to configure BigPanda to integrate with xMatters.

Note: The following sections require you to log into BigPanda with an Admin role.

Encode the authentication header value

All webhooks within BigPanda need a custom HTTP header that identifies the credentials of the integration user to access the xMatters inbound integration.

To create this value:

  1. Go to https://www.base64encode.org/.
  2. In the "Encode to Base64 format" area, type the username and password of your integration user in the following format: username:password
  3. Click Encode, and copy the result.
    • For example: hijffpc8b83cqiyriyrbqrbiauf:fabhjw!cbBBUIC85fh

Create a webhook integration

  1. Login to BigPanda, and then click the Integrations icon.
  2. Click the New Integration button.
  3. In the Create a New Integration page, click the Collaboration tab, and then click Webhooks:
  1. On the Webhook Integration page, enter a name for the integration, and then click Generate App Key button.
  2. In the Callback URL field, paste the Integration URL for your inbound integration.
  3. In the Custom Headers section, add a custom HTTP header:
    • For the key, enter Authorization
    • For the value, enter Basic, followed by the Base64-encoded value that represents the integration user's credentials.
  4. Click Configure Webhook.
webhook_instruction_1.png

After you create a Notification Webhook, you can associate it with one or more environments:
  1. Click the Settings drop-down list (the gear icon), and select AutoShare.

  1. Click Create AutoShare.
  2. In the Create AutoShare dialog box, select the Environment you want to share.
  3. In the Escalate via drop-down list, select the webhook you created:

  1. Click Next to save the AutoShare settings. 

  

Test the integration

To test the integration, create an alert that will satisfy the environment associated with the AutoShare. 

The AutoShare will be triggered via the newly created Webhook, followed by these additional comments in the Activity Feed:

  • An xMatters Event is created and set to Active
  • A notification is sent to the recipient

  

Troubleshooting

There are several places you can inspect when troubleshooting why an AutoShare incident is not sent to xMatters, or when no responses are recorded in the Activity Feed. 

Inbound to xMatters

The xMatters Integration Builder Activity Stream is a good place to look for when the the recipient doesn't receive any notification.  

While on the Integration Builder tab, expand the Inbound Integrations section, click the gear icon beside the intended integration service, and then click Activity Stream.

The Activity Stream contains the incoming request, any logging statements, and the final event creation messages.

Outbound from xMatters

Similarly, the Activity Stream contains the outbound request sending to BigPanda. The following example shows the Notification Responses activity stream: 

Appendix  - Subscriptions

Subscriptions allows users to be notified on incidents and events even though they are not on the recipient list in the communication plan. 

To allow other users to subscribe to events, you must create a subscription form for the BigPanda communication plan. This form defines who can subscribe to events, which properties they can subscribe to, and whether they can respond to notification. You can also use the form to set message content for the notifications sent to subscribers, and how to handle any responses.

 For complete information on how to create subscription and assign them to users, refer to the Subscribe to events section in the On-Demand online help.

Download resources

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk