0.2.24 • Published 10 days ago

@backstage/plugin-ilert v0.2.24

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
10 days ago

@backstage/plugin-ilert

Introduction

iLert is a platform for alerting, on-call management and uptime monitoring. It helps teams to reduce response times to critical incidents by extending monitoring tools with reliable alerting, automatic escalations, on-call schedules and other features to support the incident response process, such as informing stakeholders or creating tickets in external incident management tools.

Overview

This plugin gives an overview about ongoing iLert incidents, on-call and uptime monitor status. See who is on-call, which incidents are active and trigger incidents directly from backstage for the configured alert sources.

In detail this plugin provides:

  • Information details about the person on-call (all escalation levels of the current time)
  • A way to override the current on-call person
  • A list of active incidents
  • A way to trigger a new incident
  • A way to reassign/acknowledge/resolve an incident
  • A way to trigger an incident action
  • A way to trigger an immediate maintenance
  • A way to disable/enable an alert source
  • A list of uptime monitors

Setup instructions

Install the plugin:

# From the Backstage repository root
cd packages/app
yarn add @backstage/plugin-ilert

Add it to the EntityPage.tsx:

import {
  isPluginApplicableToEntity as isILertAvailable,
  EntityILertCard,
} from '@backstage/plugin-ilert';

// ...
<EntitySwitch>
  <EntitySwitch.Case if={isILertAvailable}>
    <Grid item sm={6}>
      <EntityILertCard />
    </Grid>
  </EntitySwitch.Case>
</EntitySwitch>;
// ...

To force an iLert card for each entity just add the <EntityILertCard /> component. An instruction card will appear if no integration key is set.

Add iLert explorer to the app sidebar

Modify your app routes in App.tsx to include the Router component exported by the plugin - for example:

import { ILertPage } from '@backstage/plugin-ilert';
<FlatRoutes>
  // ...
  <Route path="/ilert" element={<ILertPage />} />
  // ...
</FlatRoutes>;

Modify your sidebar in Root.tsx to include the icon component exported by the plugin - for example:

import { ILertIcon } from '@backstage/plugin-ilert';
<Sidebar>
  // ...
  <SidebarItem icon={ILertIcon} to="ilert" text="iLert" />
  // ...
</Sidebar>;

Client configuration

If you want to override the default URL for api calls and detail pages, you can add it to app-config.yaml.

In app-config.yaml:

ilert:
  baseUrl: https://my-org.ilert.com/

Providing the Authorization Header

In order to make the API calls, you need to provide a new proxy config which will redirect to the iLert API endpoint. It needs an Authorization Header.

Add the proxy configuration in app-config.yaml

proxy:
  ...
  '/ilert':
    target: https://api.ilert.com
    allowedMethods: ['GET', 'POST', 'PUT']
    allowedHeaders: ['Authorization']
    headers:
      Authorization: ${ILERT_AUTH_HEADER}

Then start the backend, passing the authorization header (bearer token or basic auth) as environment variable:

$ ILERT_AUTH_HEADER='<ILERT_AUTH>' yarn start

Integration Key

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

Adding the integration key to the entity annotation

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

apiVersion: backstage.io/v1alpha1
kind: Component
metadata:
  name: example
  annotations:
    ilert.com/integration-key: [INTEGRATION_KEY]
0.2.24

13 days ago

0.2.23

16 days ago

0.2.23-next.1

23 days ago

0.2.23-next.0

30 days ago

0.2.22

1 month ago

0.2.21

1 month ago

0.2.20

1 month ago

0.2.20-next.2

2 months ago

0.2.20-next.1

2 months ago

0.2.20-next.0

2 months ago

0.2.19

2 months ago

0.2.19-next.3

3 months ago

0.2.19-next.2

3 months ago

0.2.19-next.1

3 months ago

0.2.19-next.0

3 months ago

0.2.18

4 months ago

0.2.18-next.2

4 months ago

0.2.18-next.1

4 months ago

0.2.18-next.0

4 months ago

0.2.17

4 months ago

0.2.17-next.3

5 months ago

0.2.17-next.2

5 months ago

0.2.17-next.1

5 months ago

0.2.13-next.3

8 months ago

0.2.13-next.2

8 months ago

0.2.13-next.1

8 months ago

0.2.9-next.1

10 months ago

0.2.9-next.2

10 months ago

0.2.17-next.0

5 months ago

0.2.10-next.2

9 months ago

0.2.10-next.1

9 months ago

0.2.10-next.0

9 months ago

0.2.14-next.1

7 months ago

0.2.14-next.2

7 months ago

0.2.14-next.0

7 months ago

0.2.15-next.1

6 months ago

0.2.15-next.0

6 months ago

0.2.15-next.2

6 months ago

0.2.16

5 months ago

0.2.15

6 months ago

0.2.14

7 months ago

0.2.13

8 months ago

0.2.12

8 months ago

0.2.11

8 months ago

0.2.10

9 months ago

0.2.12-next.0

8 months ago

0.2.9

10 months ago

0.2.9-next.0

10 months ago

0.2.8-next.3

11 months ago

0.2.8-next.2

11 months ago

0.2.8

11 months ago

0.2.8-next.1

11 months ago

0.2.8-next.0

11 months ago

0.2.7-next.2

12 months ago

0.2.7-next.1

1 year ago

0.2.7

12 months ago

0.2.7-next.0

1 year ago

0.2.6-next.3

1 year ago

0.2.6

1 year ago

0.2.5-next.0

1 year ago

0.2.5-next.2

1 year ago

0.2.5-next.1

1 year ago

0.2.6-next.0

1 year ago

0.2.6-next.1

1 year ago

0.2.6-next.2

1 year ago

0.2.5

1 year ago

0.2.4

1 year ago

0.2.4-next.2

1 year ago

0.2.4-next.0

1 year ago

0.2.4-next.1

1 year ago

0.2.3-next.2

1 year ago

0.2.3-next.1

1 year ago

0.2.3

1 year ago

0.2.0-next.1

1 year ago

0.2.0-next.0

2 years ago

0.2.1-next.3

1 year ago

0.2.1-next.4

1 year ago

0.2.1-next.1

1 year ago

0.2.1-next.2

1 year ago

0.2.1-next.0

1 year ago

0.2.3-next.0

1 year ago

0.1.36

2 years ago

0.2.1

1 year ago

0.2.0

1 year ago

0.2.2

1 year ago

0.1.36-next.2

2 years ago

0.1.36-next.1

2 years ago

0.1.36-next.0

2 years ago

0.1.35-next.0

2 years ago

0.1.35-next.2

2 years ago

0.1.35-next.1

2 years ago

0.1.35-next.3

2 years ago

0.1.35

2 years ago

0.1.32-next.0

2 years ago

0.1.32-next.1

2 years ago

0.1.33-next.0

2 years ago

0.1.33-next.3

2 years ago

0.1.33-next.2

2 years ago

0.1.33-next.1

2 years ago

0.1.32

2 years ago

0.1.33

2 years ago

0.1.34

2 years ago

0.1.34-next.0

2 years ago

0.1.34-next.1

2 years ago

0.1.31-next.0

2 years ago

0.1.31-next.2

2 years ago

0.1.31-next.1

2 years ago

0.1.31

2 years ago

0.1.30

2 years ago

0.1.28

2 years ago

0.1.29

2 years ago

0.1.30-next.0

2 years ago

0.1.30-next.1

2 years ago

0.1.28-next.0

2 years ago

0.1.27

2 years ago

0.1.20

2 years ago

0.1.21

2 years ago

0.1.22

2 years ago

0.1.23

2 years ago

0.1.24

2 years ago

0.1.25

2 years ago

0.1.26

2 years ago

0.1.18

2 years ago

0.1.19

2 years ago

0.1.23-next.0

2 years ago

0.1.22-next.0

2 years ago

0.1.24-next.0

2 years ago

0.1.16

2 years ago

0.1.17

2 years ago

0.1.14

3 years ago

0.1.15

3 years ago

0.1.13

3 years ago

0.1.12

3 years ago

0.1.11

3 years ago

0.1.10

3 years ago

0.1.9

3 years ago

0.1.8

3 years ago

0.1.7

3 years ago

0.1.6

3 years ago

0.1.5

3 years ago

0.1.4

3 years ago

0.1.3

3 years ago

0.1.2

3 years ago

0.1.1

3 years ago