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 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>
);

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

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

6. 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

7. 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