@backstage/plugin-pagerduty NPM

PagerDuty

Overview

This plugin displays PagerDuty information about an entity such as if there are any active incidents and what the escalation policy is.

There is also an easy way to trigger an alarm directly to the person who is currently on-call.

This plugin requires that entities are annotated with an integration key. See more further down in this document.

This plugin provides:

A list of incidents
A way to trigger an alarm to the person on-call
Information details about the person on-call

Setup instructions

Install the plugin:

yarn add @backstage/plugin-pagerduty

Add it to the app in plugins.ts:

export { plugin as Pagerduty } from '@backstage/plugin-pagerduty';

Add it to the EntityPage.ts:

import {
  isPluginApplicableToEntity as isPagerDutyAvailable,
  PagerDutyCard,
} from '@backstage/plugin-pagerduty';
// add to code
{
  isPagerDutyAvailable(entity) && (
    <Grid item md={6}>
      <PagerDutyCard entity={entity} />
    </Grid>
  );
}

Client configuration

If you want to override the default URL for events, you can add it to app-config.yaml.

In app-config.yaml:

pagerduty:
  eventsBaseUrl: 'https://events.pagerduty.com/v2'

Providing the API Token

In order for the client to make requests to the PagerDuty API it needs an API Token.

Then start the backend passing the token as an environment variable:

$ PAGERDUTY_TOKEN='Token token=<TOKEN>' yarn start

This will proxy the request by adding Authorization header with the provided token.

Integration Key

The information displayed for each entity is based on the integration key.

If you want to use this plugin for an entity, you need to label it with the below annotation:

annotations:
  pagerduty.com/integration-key: [INTEGRATION_KEY]

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

3 months ago

2 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

7 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

9 months ago

8 months ago

6 months ago

7 months ago

8 months ago

9 months ago

6 months ago

9 months ago

8 months ago

8 months ago

7 months ago

9 months ago

7 months ago

8 months ago

9 months ago

9 months ago

7 months ago

6 months ago

9 months ago

9 months ago

7 months ago

7 months ago

10 months ago

10 months ago

8 months ago

10 months ago

8 months ago

8 months ago

9 months ago

10 months ago

9 months ago

7 months ago

6 months ago

8 months ago

8 months ago

8 months ago

10 months ago

6 months ago

10 months ago

8 months ago

6 months ago

8 months ago

10 months ago

8 months ago

8 months ago

7 months ago

7 months ago

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

8 months ago

8 months ago

9 months ago

9 months ago

10 months ago

8 months ago

7 months ago

7 months ago

7 months ago

9 months ago

8 months ago

7 months ago

7 months ago

10 months ago

7 months ago

5 months ago

7 months ago

8 months ago

7 months ago

7 months ago

8 months ago

8 months ago

6 months ago

6 months ago

7 months ago

5 months ago

7 months ago

10 months ago

7 months ago

8 months ago

9 months ago

9 months ago

7 months ago

9 months ago

9 months ago

8 months ago

8 months ago

10 months ago

10 months ago

6 months ago

6 months ago

9 months ago

5 months ago

10 months ago

10 months ago

10 months ago

7 months ago

8 months ago

7 months ago

10 months ago

5 months ago

6 months ago

9 months ago

5 months ago

8 months ago

9 months ago

8 months ago

6 months ago

7 months ago

10 months ago

10 months ago

6 months ago

6 months ago

10 months ago

6 months ago

8 months ago

9 months ago

10 months ago

7 months ago

6 months ago

6 months ago

7 months ago

9 months ago

9 months ago

9 months ago

9 months ago

6 months ago

10 months ago

6 months ago

7 months ago

6 months ago

6 months ago

9 months ago

10 months ago

8 months ago

9 months ago

7 months ago

7 months ago

7 months ago

9 months ago

7 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

10 months ago

10 months ago

10 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

10 months ago

10 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

10 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

11 months ago

11 months ago

11 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

11 months ago

11 months ago

12 months ago

12 months ago

11 months ago

11 months ago

12 months ago

11 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

11 months ago

12 months ago

12 months ago

PagerDuty

Overview

Setup instructions

Client configuration

Providing the API Token

Integration Key

Adding the integration key to the entity annotation