PagerDuty scopes are tied to the integrating user's permissions. The authenticated user will only be able to read and write to objects that they have access to. As part of the installation, Rootly will auto create a service account user in PagerDuty.
Locate PagerDuty on the Integrations catalog and select Setup.
You’ll be prompted to sign in or create a new PagerDuty account.
After signing in, you'll be prompted to grant Rootly permission to integrate with your PagerDuty account.
Once confirmed, the installation is complete!
We will attempt to create this for you automatically if the authenticated user account has enough privileges to create webhooks. If not you can still create the webhook manually in PagerDuty.
Log into your PagerDuty account and navigate to Integrations > Generic Webhooks.
Select + New Webhook to open up the creation form.
Enter the following information into the New Webhook form.
Webhook URL: https://webhooks.rootly.com/webhooks/incoming/pagerduty_webhooks
Scope Type: You can select from any of the following 3 options:
- Service - Selecting this option will result in only events relating the selected service to be sent to Rootly.
- Team - Selecting this option will result in only events relating to the selected team to be sent to Rootly.
- Account - Selecting this option will result in events across the entire PagerDuty account to be sent to Rootly.
Description: Give your webhook a description. This field is optional.
Event Subscription: Select the events you'd like PagerDuty to send to Rootly. We recommend you select all available options.
Custom Header Name: secret
Custom Header Value: <secret>
You can find the Webhook URL and header Secret by navigating to your Rootly Integrations > PagerDuty (setup) screen.
The Webhook URL is universal across all Rootly accounts. The Secret is unique to each Rootly account.
Once the form is completed, select Add Webhook. You'll be prompted with a confirmation message containing a PagerDuty-generated webhook secret. You will not need this value for your Rootly integration. Simply click OK to complete setup.
PagerDuty webhooks can also be set via API (https://developer.pagerduty.com/api-reference/ec247c8767c6d-create-a-webhook-subscription).
Header: secret: <TOKEN>
You can find the header secret token by navigating to your Rootly Integrations > PagerDuty (setup) screen.
Pass the following events in the request and you're all set!
If you need help or more information about this integration, please contact [email protected] or start a chat by navigating to Help > Chat with Us.