Description: 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 set up 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.
(Optional) Configure PagerDuty Alerts on a flock.
Once ready your Canary Console can be integrated into PagerDuty using email notifications. Follow the steps below to setup PagerDuty notifications:
Step 1: PagerDuty Configuration
Firstly we will create a new service in PagerDuty.
Log in to your PagerDuty account and select Service Directory from the Services tab.
Select the New Service button from the top right of the page.
Give your new service a name and description.
Assign an Escalation Policy to your service or generate a new one.
Select Email as an integration then click next.
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: Console Configuration
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.
Insert your unique PagerDuty Email address from Step 6 as a recipient of your Console's email notifications, then click save.
Note: If you'd prefer to receive alerts for a specific flock rather than all alerts head over to step 8a.
Step 8a: (Optional) Configure PagerDuty Alerts on a flock.
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.
Triggering an alert on your Canary will now generate an incident in PagerDuty and notify responders on-call.