Skip to main content

Sentry

CatalogScorecards

Summary

Sentry provides application monitoring. You can use Sentry to drive insights into values such as:

  • Issues

Setup

In order to connect Cortex to your Sentry instance, you’ll need to create a Sentry User Auth Token, and add it under Settings → Sentry. The token requires event:read and project:read permissions.

caution

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

Registration

Discovery

By default, Cortex will use the entity tag (e.g. my-service) as the "best guess" for the Sentry project name. For example, if your entity tag is my-service, then the corresponding project name in Sentry should also be my-service.

If your Sentry project names don’t cleanly match the Cortex entity tag, you can override this in the Cortex entity descriptor.

Entity descriptor

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

x-cortex-sentry:
projects:
- name: my-project
- name: my-second-project

The value for projects should be a list of the project names as defined in Sentry.