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

Service Registration


By default, Cortex will use the service identifier (e.g. my-service) as the "best guess" for the Bugsnag project key. For example, if your service identifier 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 service identifier, you can override this in the Cortex Service Descriptor.

Service Descriptor

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

project: my-project # projectKey in Bugsnag

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