Skip to content

Sentry

You can define a predefined Sentry DSN for your components to use during runtime to report to your Sentry project.

It's also possible for MACH to manage the keys (and DSN values) for you. This allows you to generate a unique DSN per component as well as have fine-grained control over rate-limiting.

To let MACH manage your DSN values, you need to define a auth token, project and organization.

Create auth token

Create a new internal integration and choose Project: Admin as permissions.
The rest can be left empty.

Sentry config

Configure MACH

Use that token to configure your MACH environment:

---
global:
  environment: test
  cloud: aws
  sentry:
    auth_token: <auth-token>
    organization: companyA
    project: mach-services
    rate_limit_window: 21600
    rate_limit_count: 100
  ...

The rate limits can also be defined/overwritten on site and component level

Integrate with components

When sentry is set as an component integration, the component should have the following Terraform variables defined:

  • sentry_dsn

If the integration is set, MACH will;

  • Generate a new DSN for the component
  • Assign the DSN to the sentry_dsn variable

More information on the sentry integration on components