Skip to main content

Bugsnag

Scorecards

Summary​

Bugsnag monitors application stability. You can use Bugsnag to drive insights into values such as:

  • Outstanding errors
  • Error frequency

Setup​

In order to connect Cortex to your Bugsnag instance, you’ll need to create a Bugsnag Auth Token, and add it under Settings → Bugsnag.

caution

If you do not see the Settings page you're looking for in the sidebar, you likely don't have the proper permissions and need to contact your admin.

caution
If you’re using a self-hosted instance of Bugsnag, you’ll need to verify that your Cortex instance is able to reach the Bugsnag instance. See our IP Whitelist section for more.

Registration​

Discovery​

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

If your Bugsnag project keys don’t cleanly match the Cortex [Entity Tag](/docs/reference/basics/entities#entity-tag), 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-bugsnag:
  project: my-project # projectKey in Bugsnag

The value for project should be the project's slug as defined in Bugsnag.