Bugsnag

BugSnag and Bird Eats Bug combine for faster, better testing and debugging.

What does this integration offer?

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

Prerequisites

Make sure you have BugSnag installed in your application and either Bird Eats Bug SDK installed in your application or the browser extension installed in your browser.

BugSnag Configuration

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

Bugsnag.start({
	// ...otherOptions
	onError: function (event) {
		// Add the Bird Eats Bug session link to the payload, if it exists.
		const birdeatsbugSessionURL = window.birdeatsbug?.session?.link || window.birdeatsbugExtension?.session?.link
		if (birdeatsbugSessionURL) {
			event.addMetadata('Bird Eats Bug', {link: birdeatsbugSessionURL})
		}
	},
})

Links to Bird Eats Bug recordings will now appear in the event details. Accessing these links when seeing them in BugSnag events allows you to quickly view the user reported recording and associated data in Bird Eats Bug.

Limitations

Bird Eats Bug 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 BugSnag, it is only known whether there's an ongoing recording with Bird Eats Bug, and under which URL the recording will be accessible if the user uploads it. However, the user might choose not to upload the Bird Eats Bug recording. In this case, BugSnag will link to a Bird Eats Bug recording that is not accessible. Bird Eats Bug replay sessions reported with the browser extension will never be linked on BugSnag.