Learn how to setup a BugSnag integration with GitHub Issues.
The GitHub Issues integration allows an issue to be created in GitHub for errors that are reported to BugSnag.
In BugSnag, set up the GitHub Issues integration from Project Settings > Issue tracker, then select GitHub Issues from the Available integrations section.
Multiple GitHub Issues integrations can be configured for BugSnag projects which allows different issues to be created in different repositories. Contact us to gain access to this feature.
Issues can be created manually or automatically. Once an error has a linked issue, a comment will be added to the issue when the error changes between open and fixed, and when a comment is added to the error in BugSnag.
Create an issue manually by clicking on the + icon on the BugSnag dashboard.
With the Create an issue toggle selected, create a new linked issue by selecting the issue tracker from the dropdown and selecting the Create issue button.
Alternatively, select Link to existing issue to add an issue using the URL.
You can choose one of two ways allow BugSnag to automatically create an issue.
Filters can be configured to define which errors should automatically create an issue in GitHub Issues. An issue will be created the first time an error occurs in a matching release stage, if there is no existing issue.
Basic filtering is provided for severity, type, and release stage.
Advanced filtering leverages Bookmarks to enable you to create issues based on any field you can filter on using the filter bar. Advanced filtering is available on Standard and Enterprise plans.
The GitHub Issues integration has two way sync capabilities which means that errors in BugSnag can be kept in sync with the linked issue in GitHub.
To enable two-way sync select Two-way sync and enable the automations you require.
You can configure BugSnag to automatically apply labels to issues created by the integration.
This is setup by providing a comma separated list of labels to apply to all new issues.
The access token used to configure the integration requires the following permissions:
repo(for private repos)
repo_public(for public repos)
admin:repo_hook(for two-way sync)
Read and write access for:
If your server’s security policy denies access from external IP addresses and websites, you will need to allow access to BugSnag’s IP addresses below.