Skip to main content




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

  • Outstanding errors
  • Error frequency


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


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.

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.



By default, Cortex will use the Entity Tag (e.g. my-service) as the "best guess" for the Bugsnag project key. For example, if your 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, 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.

project: my-project # projectKey in Bugsnag

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