logo

PagerDuty Integration

PagerDuty + Fiberplane Integration Benefits

  • Create a Fiberplane notebook automatically when a PagerDuty incident is acknowledged.
  • Use Fiberplane templates to start an incident investigation with everything you need.
  • Update the PagerDuty incident with the Fiberplane notebook URL to click straight from the incident to the investigation.

How it Works

  • Once a PagerDuty incident is created or acknowledged, a trigger event will be sent to Fiberplane to create a new notebook based on the PagerDuty template.
  • When the notebook has been created, the notebook URL will be sent to the PagerDuty incident and included as a note on the incident. This URL can then be clicked on taking the user straight to the Fiberplane notebook.
  • The PagerDuty template uses information such as the service name, incident severity and name of the person acknowledging the incident to create a notebook that can be used to openly and collaboratively investigate an incident.

Requirements

  • Access to an AWS account is required to create a new lambda function.
  • The Fiberplane CLI is required to create a new trigger endpoint for a template. Instructions to install the CLI and log into Fiberplane with it are here.

Support

If you need help with this integration, please contact support@fiberplane.com.

Integration Walkthrough

In Fiberplane

  1. Go to the incident-response-pagerdutyV3 template found in the Fiberplane Quickstart Repository
  1. Follow the instructions to create a template and trigger using the CLI.
  1. Note the Trigger URL for later use.
    1. Image without caption

In the AWS console

  1. Navigate to the Lambda service.
  1. Click the orange Create function button.
  1. Name your function fp-PagerDuty-integration and select the Python 3.7 runtime from the dropdown menu.
  1. Click the Advanced settings drop down menu and select Enable function URL and choose NONE as the Auth type.
  1. Press the orange Create function button.
  1. In the Code source section double click the folder named fp-PagerDuty-integration and then double click lambda_function.py to open the file in the code editor.
  1. In a separate browser tab open the lambda_function.py page in the PagerDuty integration section of the Fiberplane Quickstart Repository and copy all of the contents of the file.
Image without caption
  1. Switch back to the AWS lambda console in your browser and paste the code into the lambda_function.py file in the Code source editor.
  1. Press File → Save in the Code source editor.
  1. Press Deploy.
  1. Copy the Function URL in the Function Overview section.
Image without caption

In PagerDuty

  1. Click on Integrations and then Generic Webhooks (v3)
  1. Click on the + New Webhook button.
  1. In the Webhook URL section add the Function URL copied from the AWS lambda function.
  1. Select Service as the SCOPE TYPE.
  1. Select your service in the SCOPE dropdown menu.
  1. Press Deselect all then check the top box listed incident.acknowledged.
  1. Click Add custom header.
  1. Type fp-trigger in the name field and add the Fiberplane trigger URL in the value field .
  1. Click Add custom header.
  1. Type pd-apikey in the name field and add your PagerDuty API key in the value field.
  1. Click Add Webhook and then OK
Image without caption
Image without caption

Testing the integration

  1. Go to the Incidents screen in PagerDuty and click + New Incident
  1. Select an Impacted Service and add a Title to the incident and optionally select an Urgency, Incident Priority and Description.
  1. Click Create Incident
  1. Click ! Acknowledge
  1. Check that the notebook URL is updated in the incident notes:
Image without caption
  1. Click on the URL and ensure that it takes you through to the notebook and the notebook is correctly filled out with the data:
Image without caption

How to Uninstall

  1. In PagerDuty click on Integrations and then Generic Webhooks (v3)
  1. Click on the menu represented by three dots on the right of the webhook listing and press delete.
  1. Open a terminal session, type fp login and press enter.
  1. Type fp triggers list then press enter, find the trigger and copy the ID of the trigger.
  1. Type fp triggers delete <trigger ID> and press enter.
  1. Open the AWS lambda console and click on the lambda function fp-PagerDuty-integration
  1. Click on the Actions menu in the top right and then Delete function

Helpful?