BugSnag

BugSnag is an application stability monitoring platform that provides error tracking and analytics. By integrating BugSnag with Cortex, you can view errors alongside other key metrics and gain greater understanding into your entities' operational maturity.

In this guide, you'll learn how to set up and use the BugSnag integration to drive insights into values such as:

• Outstanding errors

• Error frequency

Setup and configuration

Getting started

In order to connect Cortex to your BugSnag instance, you’ll first need to create a BugSnag auth token in the My Account section of BugSnag settings.

Configuration

Once you've created the auth token, you can configure the integration in Cortex from the BugSnag page in settings.

To configure the integration, provide the following information:

• Auth token: Auth token generated from BugSnag

• Organization slug: BugSnag organization for your instance; you can find this in settings or in your BugSnag URL (https://app.bugsnag.com/organizations//stability-center)

• Host (optional): URL for your BugSnag instance without the API path (e.g. bugsnag.getcortexapp.com)

  • This is only needed if you're using a custom/self-hosted BugSnag instance

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. We route our requests through a static IP address. Reach out to support at [e-mail] to receive details about our static IP. If you're unable to directly allowlist our static IP, you can route requests through a secondary proxy in your network that has this IP allowlisted and have that proxy route traffic to your BugSnag instance.

Registration

Discovery

Entity descriptor

x-cortex-bugsnag:
  project: my-project

Field	Description	Required
project	Project key defined in BugSnag	✓

Expected results

Entity pages

Once the integration with BugSnag is established, you'll be able to pull in error data to an entity's details page. You can find the total number of detected errors and a full list on the Error tracking page in the side panel.

Each error in the list will display with an Error, Info, or Warning tag based on the severity applied to a given error in BugSnag.

Scorecards and CQL

With the BugSnag integration, you can create Scorecard rules and write CQL queries based on BugSnag errors.

See more examples in the CQL Explorer in Cortex.

Check if BugSnag is set

Check if an entity has a registered BugSnag project.

Definition: bugsnag (==/!=) null

Example

This expression can be used to write a Scorecard rule to make sure each entity has a registered BugSnag project:

bugsnag != null

This is also a good way to double-check that the integration is synced and reporting frequently.

Number of issues

Count all unresolved issues in BugSnag or counts number of issues for a given query. By default, will count all unresolved issues.

Definition: bugsnag.numOfIssues(query: Text | Null)

Example

For a Scorecard focused on operational maturity, you can pull in error data from BugSnag to make sure your entities have no or few errors.

bugsnag.numOfIssues() < 2

To set a more specific standard, you can also create a rule based on a filter.

bugsnag.numOfIssues("filters[error.status][][type]=example")

Still need help?​

The following options are available to get assistance from the Cortex Customer Engineering team:

• Email: [e-mail], or open a support ticket in the in app Resource Center
• Chat: Available in the Resource Center

• Slack: Users with a connected Slack channel will have a workflow added to their account. From here, you can either @CortexTechnicalSupport or add a :ticket: reaction to a question in Slack, and the team will respond directly.

Don’t have a Slack channel? Talk with your Customer Success Manager.