Extension and Add-on Basics

Extensions

Extensions are additional features that help streamline your incident response and communication. The Extensions page allows you to view and manage all of your service extensions, persistent conference bridges and add-ons.

Read more information about add-ons here.

To manage your Extensions, go to Configuration → Extensions. Once you are on the Extensions page, you will be able to see the current Extensions that have been added to all of your services.

From this page, you can add an Extension to a service. To add an extension, click on the New Extension button. From there, select the Extension Type, Name, and Service that you want to add the Extension to, as well as the Extension URL in the Details section.

Additionally, you can edit, copy an extension to another service, and delete extensions on this page by clicking on the settings gear.

Note

Only users with the Account Owner or Admins users will be able to access the Extensions page — limited users, read-only users, team responders and stakeholders will not be able to access this page.

Add-ons

Add-ons are a way to enhance your ability to manage the full incident lifecycle. Add-ons can add functionality to your PagerDuty experience outside of the core PagerDuty product, but are still hosted within your PagerDuty account. This means that you now have the power to add your own scripts and web pages to your PagerDuty environment.

Add-ons provide you with the ability to add web pages to your PagerDuty dashboard that can interact with our APIs. This means you can now customize your PagerDuty application to provide additional functionality that is not yet available within our UI or to provide interactive reports on your infrastructure and incident response.

Install an Add-on

We've developed a few different methods for installing add-ons so that you can use the method that best suites your needs. We've written a guide outlining all the different ways you can install PagerDuty add-ons.

Uninstall an Add-on

Uninstalling add-ons is easy with our REST API. Simply replace the API_KEY and ADDON_ID below with a v2 API key and your add-on's unique ID:

curl -H 'Accept: application/vnd.pagerduty+json;version=2' -H 'Authorization: Token token=API_KEY' -X 'DELETE' 'https://api.pagerduty.com/addons/ADDON_ID'

Where can I Find Installed Add-ons?

Once you've installed an add-on, you will have a new Add-ons drop-down menu in your navigation bar. Clicking on this menu will display a list of all add-ons you currently have installed within your account.

Where can I Find Pre-built Add-ons?

PagerDuty maintains a public GitHub repository with pre-built add-ons that have been created by our development community: https://github.com/PagerDuty/addons.

We welcome you to contribute any add-ons you create to this repository to be shared across our community.

Pre-built Add-on Examples

Detect Conflict Between Schedules

With this add-on, you can see which users have conflicting on-call schedules between two or more schedules:

Export Users to CSV

With this add-on, you can have a quick and easy way to export your full user list. Enter your subdomain and an API key to see all of your users and click on the Download button to export a CSV with this information.

PagerDuty Status Page

With this add-on, you can see PagerDuty’s current server status from within your account. If you think there may be a problem on our end, you can view this status page to check without ever leaving your incident management dashboard.

Incident Density

With this add-on, you can see a visual representation of your incident density per hour over the course of the previous week. You can use this graph to understand when your incidents are occurring so that you can plan ahead and be prepared to respond quickly. And if these trends aren’t specific enough, hovering over any dot will tell you the exact number of incidents that occurred on that particular day and time.

Note

As of November 2016, we added the Infrastructure Health Application to our platform to allow similar functionality in the web UI.

Extension and Add-on Basics