How do I configure PagerDuty notifications?

Connect Canary with PagerDuty to send email alerts to incident response teams. This setup creates PagerDuty incidents when Canary triggers an alert, notifying responders immediately. The guide details setting up a PagerDuty service, choosing email as the method, adding the email to Canary notifications, and testing alert flow.

PagerDuty is a great way of having alerts sent directly to your teams when an alert is triggered and to track, manage and allocate incident responders to your alerts.

Prerequisites

This guide assumes you have the basic setup of PagerDuty completed; if not, the following guides will get you started.

• Follow PagerDuty's Quick Start Guide here.
• Add and configure your Users here.
• Create an On-Call Schedule here.
• Create an Escalation Policy here.
• (Optional) Create a Team here.

Once ready, your Canary Console can be integrated into PagerDuty using email notifications. Follow the steps below to set up PagerDuty notifications:

Step 1: Open the Service Directory in PagerDuty

Firstly, we will create a new service in PagerDuty.

Log in to your PagerDuty account and select Service Directory from the Services tab.

Step 2: Create a New Service

Select the New Service button from the top right of the page.

Step 3: Name and Describe Your Service

Give your new service a name and description.

Step 4: Assign an Escalation Policy

Assign an Escalation Policy to your service or generate a new one.

Step 5: Choose Email as the Integration Method

Select Email as an integration then click next.

Step 6: Copy the Generated Email Address

Copy your uniquely generated email address to the clipboard. This address will generate incidents on email receipt and will be configured in your Canary Console.

Step 7: Open Global Settings in Your Console

We will now set up your Console to send Alert emails to your unique PagerDuty Email address. Head over to your Canary Console and select Global Settings.

Step 8a: Add the PagerDuty Email to Notifications

Insert your unique PagerDuty Email address from Step 6 as a recipient of your Console's email notifications, then click save.

Step 8b: (Optional) Set Up Flock-Specific Notifications

Select the cog icon in your desired Flock.

Change the Email Notifications toggle to On then insert your unique PagerDuty Email address from Step 6 as a recipient of your Console's email notifications, and click save.

Step 9: Test the Integration by Triggering an Alert

Triggering an alert on your Canary will now generate an incident in PagerDuty and notify responders on-call.