Skip to main content

Rollbar

CatalogScorecards

Summary

Rollbar provides error tracking for your application. You can use Rollbar to drive insights into values such as:

  • Error tracking
  • Error rates
  • Exceptions

Setup

In order to connect Cortex to your Rollbar instance, you’ll need to create a Rollbar Access Token, and add it under Settings → Rollbar. Note that, at a minimumum, the token will require read permissions.

Cortex will look up Project Tokens automatically for each project and attempt to reuse them to access project details.

However, if no project token exists for the project, Cortex will automatically create one (if the Rollbar Access Token has been granted write permissions).

Registration

Discovery

By default, Cortex will use the [Entity Tag](/docs/reference/basics/entities#tags) (e.g. my-service) as the "best guess" for the Rollbar project name. For example, if your [Entity Tag](/docs/reference/basics/entities#tags) is my-service, then the corresponding project name in Rollbar should also be my-service.

If your Rollbar project names don’t cleanly match the Cortex [Entity Tag](/docs/reference/basics/entities#tags), you can override this in the Cortex Catalog Descriptor.

Catalog Descriptor

If you need to override the automatic discovery, you can define the following block in your Cortex Catalog Descriptor.

x-cortex-rollbar:
project: my-project # projectName in Rollbar

The value for project should be the project name as defined in Rollbar.