backstage/plugins/rollbar

Rollbar Plugin

Website: https://rollbar.com/

Setup

1. Configure the rollbar backend plugin

2. If you have standalone app (you didn't clone this repo), then do

yarn add @backstage/plugin-rollbar

3. Add plugin to the list of plugins:

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

4. Add plugin API to your Backstage instance:

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

// ...
builder.add(rollbarApiRef, new RollbarClient({ discoveryApi }));

5. Add to the app EntityPage component:

// packages/app/src/components/catalog/EntityPage.tsx
import { Router as RollbarRouter } from '@backstage/plugin-rollbar';

// ...
const ServiceEntityPage = ({ entity }: { entity: Entity }) => (
  <EntityPageLayout>
    // ...
    <EntityPageLayout.Content
      path="/rollbar"
      title="Errors"
      element={<RollbarRouter entity={entity} />}
    />
  </EntityPageLayout>
);

6. Setup the app.config.yaml and account token environment variable

# app.config.yaml
rollbar:
  organization: organization-name
  accountToken:
    $env: ROLLBAR_ACCOUNT_TOKEN

7. Annotate entities with the rollbar project slug

# pump-station-catalog-component.yaml
# ...
metadata:
  annotations:
    rollbar.com/project-slug: organization-name/project-name
    # -- or just ---
    rollbar.com/project-slug: project-name

8. Run app with yarn start and navigate to /rollbar or a catalog entity

Features

• List rollbar entities that are annotated with rollbar.com/project-slug
• View top active items for each rollbar annotated entity

Limitations

• Rollbar has rate limits per token

Links

• Backend part of the plugin
• The Backstage homepage