Plugin capabilities

The purpose of the PagerDuty plugin for Backstage is to bring some of the capabilities of PagerDuty into Backstage to reduce distractions and provide users more visibility on the status of each service.

Currently the plugin provides a limited set of features that we view as the core capabilities used by Developers, Platform Engineers, SREs and other type of stakeholders. Theses are listed below.

Frontend

The frontend plugin (@pagerduty/backstage-plugin) allows users to add a PagerDuty Card to their service pages which provides the following set of features.

Quick view on current service status

The plugin provides an easy mechanism to check the current status for the service, as well as some insights for the last 30 days and how well you are complying to Service Standards.

Note

By hovering the mouse over the information button on Service Standards card you will see a list of all the Service Standards and whether you are compliant or not.

View any open incidents

The plugin lists all open incidents on a specific service and allows you to navigate to the incident detail page in PagerDuty.

View change events associated to a service

See all recent changes sent to PagerDuty through integrations like GitHub, GitLab, Azure DevOps and many others. If your service is running into issues you can quickly identify recent changes that might be related to the root cause of the incident.

Note

This feature is available with our PagerDuty AIOps add-on. If your account does not have support for change events you might see the following screen instead of a list of changes.

See and contact on call staff

Quickly check who is on call for your service and reach out if necessary. The plugin allows you to see the escalation policy that the on-call user is assigned to and navigate to PagerDuty for more details.

Trigger an incident for a service

The PagerDuty plugin allows users to create incidents directly from Backstage. You only need to specify a description for the problem you are having with the service and an incident will be created in PagerDuty.

Note

This feature can be disabled if you don't want users to create incidents manually from Backstage. To do so check the steps on how to enable read-only mode.

Backend

The backend plugin (@pagerduty/backstage-plugin-backend) enables additional security when using the PagerDuty APIs and enables easy adoption of PagerDuty best practices through custom Backstage Scaffolder actions.

Create PagerDuty services from project templates

The PagerDuty backend plugin exposes a custom action that can be used in project templates to streamline the process of onboarding services into PagerDuty whenever a new service is created from a Backstage template.

Follow these steps to add the custom action to a template.

Warning

Alert Grouping requires certain capabilities available in AIOps and Event Intelligence which are present in certain licensing models only.

If your account doesn't have these capabilities, alert grouping will sillently be ignored.

The future

We are actively working on new capabilities based on user feedback and requests. If you have ideas or bugs to report we appreciate that you use the project's Issues page and let us know.