PagerDuty Installation Instructions

How to Integrate PagerDuty with BigPanda

Create an App Key

First create an App Key. You'll need a separate App Key for each integrated system.

Create a New PagerDuty Service

If you plan to reuse an existing service please skip to the next step

1. From the Configuration menu, select Services

2. Click Add New Service

3. Under General Settings enter a Name for your new service

4. Under Integration Settings select Don't use an integration for Integration Type; we'll add our integration in the next step

5. Under Incident Settings specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service

6. Click the Add Service button to save your new service

Add a BigPanda Integration to Your PagerDuty Service

1. From the Configuration menu, select Services

2. Click on the service you wish to add the BigPanda integration to

3. From the Integrations tab click the New Integration button

4. From the Integration Type menu select Use our API directly and ensure Events API v2 is selected

5. Click the Add Integration button to save your new integration. You will be redirected to the Integrations page for your service

6. Under Extensions, click New Extension and supply the following details:

  • Extension Type: Select Generic V2 webhook
  • Name: Appropriate name such as "BigPanda Webhook"
  • Details: The URL https://outbound.bigpanda.io/latest/pagerduty/webhook?token=$TOKEN

7. Copy the Integration Key for your new integration:

Connect BigPanda to PagerDuty

1. Enter your PagerDuty Integration Key obtained in the previous step as the x-bp-config-pdkey header value

2. Click Configure Webhook

Configure the PagerDuty webhook within the BigPanda Integration Console.

Enable Comment Sync to PagerDuty

You can optionally enable syncing of comments from BigPanda to PagerDuty.

Note: All comments are already synced from PagerDuty to BigPanda, no additional configuration is needed. Only follow these steps if you want a bi-directional sync.

1. Identify a PagerDuty user whom the comments will be performed on behalf of and copy their email

  • This user will show as the author of all BigPanda comments within PagerDuty
  • This user should have, at minimum, Responder role privileges

2. From the Configuration menu, select API Access

3. Click Create New API Key

4. Provide a useful Description such as "BigPanda Integration"

5. Click Create Key and copy the API Key

6. Edit the webhook form in the previous step, adding two new headers:

Header KeyHeader Value
x-bp-config-pdtokenPagerDuty API Key which you just created
x-bp-config-pdemailEmail address of user identified earlier

7. Click Configure Webhook

Success

You are now ready to share incidents to PagerDuty.

Note: If you want to share to other services or escalation policies, you may create another PagerDuty integration with a different system name.