Integrate Bug Capture with Sentry

Learn how to integrate with Sentry for faster and better testing and debugging

The Bug Capture Sentry integration connects errors in Sentry to a Bug Capture recording, allowing a much easier way to understand the user’s experience when going over error data in Sentry. There’s a clear correlation between error data in Sentry and issues reported from users with Bug Capture.

Prerequisites

Make sure you have Sentry installed in your application and either Bug Capture SDK installed in your application or the browser extension installed in your browser.

Sentry Configuration

The following Sentry configuration change adds the URL returned by window.birdeatsbug?.session?.link || window.birdeatsbugExtension?.session?.link to the payload of Sentry events.

The links to Bug Capture recordings will now appear in the event details. Clicking them will open a new browser tab, allowing you to quickly view the user reported recording and associated data in Bug Capture.

Limitations

Bug Capture does not auto-upload recordings. The user has to take a submit action to upload the recording. This means that in the moment in time when an error occurs and is sent to Sentry, it is only known whether there’s an ongoing recording with Bug Capture, and under which URL the recording will be accessible if the user uploads it. However, the user might choose not to upload the Bug Capture recording. In this case, Sentry will link to a Bug Capture recording that is not accessible. Bug Capture replay sessions reported with the browser extension will never be linked on Sentry.