- Log in to both your Bitbucket and Raygun accounts. In Raygun click on Integrations and then Bitbucket:
- Click on the ‘Setup’ tab, then click on the blue ‘Bitbucket’ button and grant Raygun access to Bitbucket:
When prompted enter your Raygun email address and password.
Select which repository you want the issues to be delivered to, click ‘Enabled’ then ‘Save Changes’.
Linking Raygun error groups to Bitbucket issues: View an error group in Raygun Crash Reporting. Click ‘Integrations’ and select Bitbucket to create a new issue for the error or link to an existing one:
To connect Raygun error groups to issues in Bitbucket, or create new issues in in Bitbucket from an error group, you need to have Bitbucket issue tracking enabled.
This setting is found by going to your repository in Bitbicket, clicking the ‘Settings’ on the left sidebar, then clicking the ‘Issue tracker settings’ option under the ‘Issues’ heading. You can then chose your issue tracking options:
If the issue tracker settings are set to ‘No issue tracker’, you will not be able to create or link any Bitbucket issues and an error message will appear:
The Bitbucket integration supports deployment tracking, which means:
- More detailed deployment information
- Ability to link your commits and release notes directly from Raygun to your source code
You do not need Bitbucket issue tracking to use this feature.
Creating a webhook in Bitbucket
By using a webhook, resolving issues in Bitbucket will also resolve the linked Raygun error groups. Here’s how to create a webhook in Bitbucket so you can get those error groups resolved in no time!
- Login to Bitbucket and ensure you are a repository administrator
- Navigate to the repository linked to your Raygun application
- Click on ‘Settings’ located the left sidebar
- Click on ‘Webhooks’ located under the ‘Integrations’ section
- Click on the ‘Add webhook’ button
- Give your webhook a ‘Title’
- In the ‘URL’, copy and paste the ‘Bitbucket Webhook URL’ found in your Raygun Bitbucket Setup tab
- Mark the ‘Status’ as ‘Active’
- Leave the ‘SSL / TLS’ unchecked
- Set the ‘Triggers’ to ‘Choose from a full list of triggers’
- Check the ‘Updated’ checkbox under ‘Issue’
- Click ‘Save’