About the Integration

Sentry is an error monitoring service that helps DevOps teams discover, triage, and prioritize their errors in real-time. Before you start, you should already have a Sentry account and your environment setup and running. If not, head over to Sentry to get things started. Once you're done, return to Sleuth so you can complete setup of the integration.

Setting up the integration

To add the Sleuth Sentry integration:

  • Click Integrations in the sidebar.

  • Click connect in the Sentry Error Trackers card.

  • Enter the Sentry Auth Token, then press Save.

The Sentry Auth Token can be found in Sentry, under Settings > Account Details > API > Auth Token, as shown below.

Sentry Auth Token in the Sentry dashboard.
Sentry auth token entry field in Sleuth
  • Once the Sentry integration is successful, you will see the message, Sentry is connected displayed.

Successful integration with Sentry!

Configuring the integration

  • Click Add impact to select the Sleuth project that will be processing your application errors. All projects within the organization will be displayed in the dropdown.

Sleuth will not auto-populate the Environment field dropdown due to the way the Sentry API handles environment data. Check your Sentry project first before populating this field. Environments are created when a deployed application monitored by Sentry sends environment data (e.g., in Javascript, the application could sendenvironment: 'staging') back to Sentry by tagging issues via your SDK. For more information, read more about how Sentry receives environment data.

Impact entry dialog for Sentry

Integrations are made at the Sleuth organization level, and are available for all projects within that organization. Individual settings for an integration are made at the project level.

  • The Sentry logo in the Change Source card turns to green when the integration is successful.

Removing the integration

Click disconnect to dissolve the Sleuth-Sentry integration. You will need to re-authorize Sleuth again if you wish to re-establish the integration.

  • That’s it—Sleuth will start displaying Sentry error metrics in your deploys. Read Dashboard for more information on how errors are communicated in deploy cards.