Schedules + Exterior Tools

Add a PagerDuty Schedule to Confluence

Adding PagerDuty schedules to Confluence gives Confluence users the ability to easily know when they will be on-call without having to login to multiple interfaces.

In Confluence

  1. Click Create in the top navigation menu.
  2. Select the Blank page option, and name the page.
  3. Once you name your page, click the + icon from the toolbar, and select Other macros from the dropdown menu.
  4. Using the search bar, start typing "calendars" and select the Team Calendars object, then click Subscribe by URL.

In PagerDuty

  1. Login to your PagerDuty account.
  2. Go to the Configuration → Schedules.
  3. Navigate to the schedule you would like to export to Confluence, and click Export.
  4. Select WebCal feed → Everyone.
  5. Copy the URL displayed in the pop-up window, excluding webcal before the first colon.
  6. Now, back in Confluence, type http and paste the URL into the URL field.

Note

The name of your schedule in PagerDuty must have 28 characters or fewer. If you have 29 or more characters in your schedule's name, then you will get an error in Confluence. If you're schedule name has 29 or more characters, then you will get this error in Confluence: Specified calendar does not seem like iCalendar. Note that this refers to the schedule's name and not the WebCal URL.

  1. You will see an incomplete calendar at first. Click Save in the bottom right corner of the page, and then your full calendar will be appear.

Exporting On-Call Schedules to a Calendar App

You can integrate your on-call schedule with calendar software (Apple Calendar, Google Calendar, Microsoft Outlook, etc.) using iCal or WebCal.

Note

iCal and WebCal feeds will display historical data over a 1 month period. Up to 6 months of on-call schedules can be exported in the feed.

Export All Schedules

You can export all of your personal on-call schedules at once on your profile page.

  1. Go to My Profile in the drop-down menu in the top right hand corner of the screen and select the User Settings tab.
  2. Under Calendar settings, right click WebCal feed and copy the link (alternatively, you can download the ".ics" file by clicking on iCalendar file).
  1. Open Google Calendar or iCal — in this example, we will add the schedules to Google calendars.
  2. Under Other Calendars, select Add by URL from the drop-down list.
  3. Paste the URL and click Add Calendar.

Export a Single Schedule

If you do not want to export all your on-call schedules, you can also choose to export schedules individually

The iCal or WebCal link for a specific schedule can be found by clicking on the specific schedule and selecting Export. You can export only your on-call shifts, or the entire schedule (everyone's shifts). When exporting the calendar feed from the on-call schedules page, it will export only the selected on-call schedule.

Export only your on-call shifts

  1. Go to the Configuration → Schedules.
  2. Next to a calendar click Export → Just My Calendar to launch your calendar application. You will be prompted to subscribe to the calendar URL.
  1. In this example we're using Apple Calendar, and need to click Subscribe to finish importing your personal schedule.

Export the Entire Schedule (everyone's shifts)

  1. Go to the Configuration → Schedules.
  2. In the On-Call Schedules Tab, select Export → Everyone to launch your calendar application. You will be prompted to subscribe to the calendar URL.
  1. Click Subscribe to complete the import of the entire schedule.

Making Changes to Schedules

Once an on-call schedule is exported into Google Calendar, Google Calendar will automatically update when you make a change to the on-call schedule in the web application. Therefore, once an on-call schedule has been exported, you will not need to edit it when you make changes to the schedule in PagerDuty.

Note

Google Calendar can take up to 24 hours to refresh the on-call schedule when modified as Google Calendar caches the data every time it refreshes.

Troubleshooting WebCal Exports

Export Errors

Export Errors

If you experience any of the following issues when exporting your PagerDuty schedule WebCal feeds to Google Calendar:

  • A "could not fetch URL" error displays in Google Calendar
  • A "loading" message appears in Google Calendar, but events are not imported
    These issues are due to a Google Calendar issue with syncing and caching when fetching a calendar feed after adding by URL. There are several threads on this topic in Google Product Forums, however, none of these reflect a concrete resolution.

If you do experience this issue, please test the following fixes when initially subscribing to the calendar via URL:

  • Add ?nocache to the end of the feed URL. For example:

webcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX

turns into

webcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX?nocache

  • Change webcal:// to http:// or https:// at the beginning of the URL. For example:

http://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX

Reset Your Personal Calendar Feed URLs

If you would like to reset the calendar feed URLs, please follow these instructions. Please note, these URLs are different than the calendar feed URLs associated with an on-call schedule. This will update all on-call schedules.

  1. Login to your PagerDuty account.
  2. Go to My Profile, select the User Settings tab, then click Regenerate feed URLs.
  1. Use the links for the WebCal or iCalendar feed to update your calendar application.

Delete an Imported Schedule

Sometimes when you export the wrong calendar to Google Calendar and attempt to export a different calendar it does not work. Unsubscribing to the wrong calendar in Google Calendar before exporting the new calendar should resolve this issue.

To unsubscribe from a PagerDuty calendar:
-In Google Calendar, go to the Settings page.

  • Go to the Calendars tab, then click Unsubscribe next the PagerDuty calendar. You may need to scroll to see the calendar.
  • Import your PagerDuty calendar again.

Schedules + Exterior Tools