Roadie

Backstage Rollbar Plugin

Correlate services with problems in production

Getting started is simple

Ensure you have the Rollbar Backend plugin installed. See the notes below to learn how to add a Rollbar API token to Backstage.

Install the plugin in your Backstage instance

yarn add @backstage/plugin-rollbar

Add the plugin to the list of plugins

// packages/app/src/plugins.ts
export { plugin as Rollbar } from '@backstage/plugin-rollbar';

Add the plugin API to your Backstage instance.

// packages/app/src/api.ts
import { RollbarClient, rollbarApiRef } from '@backstage/plugin-rollbar';

// ...

builder.add(
  rollbarApiRef,
  new RollbarClient({
    apiOrigin: backendUrl,
    basePath: '/rollbar',
  }),
);

// Alternatively you can use the mock client
// builder.add(rollbarApiRef, new RollbarMockClient());

How it looks

Things to know

At the time of writing, in July 2020, Rollbar are rolling out a new UI which doesn’t seem to have the ability to create API keys.

To switch back to the old UI temporarily, click your organization’s name in the bottom left corner and select “Switch to old UI”.

Once there, go to your Account settings and click Account access tokens in the sidebar. Here you can “Add new access token”. Make sure it has the read scope.

Become a Backstage expert

To get the latest news, deep dives into Backstage features, and a roundup of recent open-source action, sign up for Roadie's Backstage Weekly. See recent editions.