PagerDuty + Oncall Scheduler Integration Benefits

  • When a shift assignment changes in Oncall Scheduler, it'll sync immediately into PagerDuty, so the two always show the same schedule.
  • You can sync multiple Rotations from Oncall Scheduler into one Schedule in PagerDuty for a follow-the-sun schedule where different sets of people in different geographic locations cover the oncall responsibilities for different time windows.
  • When you add new team members to a rotation in Oncall Scheduler, they are automatically created as new team members in PagerDuty as well.

How it Works

  • When you first configure the sync of an Oncall Scheduler Rotation into PagerDuty, the sync creates a new PagerDuty Schedule.
  • If your Oncall Scheduler Rotation uses a backup pattern, this will appear as a separate Schedule in PagerDuty, next to the Schedule for the Primary oncall.
  • When you configure multiple Oncall Scheduler Rotations to form a follow-the-sun oncall pattern, those rotation will all write into the same PagerDuty Schedule as separate PagerDuty Schedule Layers, each covering the portion of the day that the Rotation is configured to cover.

Requirements

  • To configure PagerDuty integration for an Oncall Scheduler Rotation, you must be a Rotation Administrator. You can see who is an administrator for a Rotation on the Rotation Configuration Page. The Rotation Configuration Page is reached by clicking on a Rotation in  the Rotation list, and then clicking the gear icon in the header.
  • To get a PagerDuty API Access Key you need to be a PagerDuty admin or account owner for your organization.

Support

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

Integration Walkthrough

In PagerDuty

Follow the instructions here to create a PagerDuty REST API Access Key. Do not check "Read-only API Key". This key needs to enable writing schedules into PagerDuty. Keep the API key on the screen. You will need to copy and paste it in the steps below.

In Oncall Scheduler
  1. In the Oncall Scheduler start page which lists all rotations, click on the rotation you want to sync into PagerDuty.
  2. Click the gear icon in the header, to the right of "Members", to open Rotation Settings.
  3. Click Start PagerDuty Updates.
  4. If you're not merging this Rotation together with another Rotation which already syncs into PagerDuty, into one PagerDuty Schedule, leave the radio button at Set up PagerDuty sync.
    1. Leave the Schedule name to be the name of the Rotation, or change it to a name you want to appear in PagerDuty.
    2. Enter the Pagerduty Subdomain to sync to.
    3. Copy the PagerDuty REST API Access Key and paste it into the PagerDuty API key field.
    4. Click Save and update PagerDuty.
  5. If you're merging this Rotation into a follow-the-sun PagerDuty Schedule, together with another Rotation which already syncs into PagerDuty, change the radio button to Merge together with another rotation into a single PagerDuty schedule.
    1. Select the Rotation you are merging with in the Other rotation to merge into PagerDuty schedule with drop-down.
    2. Click Sync into shared PagerDuty Schedule.

How to Uninstall

In PagerDuty

Follow the instructions here to delete the REST API Access Key.

In Oncall Scheduler
  1. In the Oncall Scheduler start page which lists all rotations, click on the rotation you want to sync into PagerDuty.
  2. Click the gear icon in the header, to the right of "Members", to open Rotation Settings.
  3. Click Change PagerDuty configuration.
  4. Click Delete and stop PagerDuty updates.