GitHub Issues

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.

Configuration

In Bugsnag, set up the GitHub Issues integration from Project Settings > Issue tracker, then select GitHub Issues from the Available integrations section.

Creating issues

Issues can be create 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.

Manual issue creation

Create an issue manually by clicking on the ! icon on the Bugsnag dashboard.

Create new issue

To link an error to an existing issue, select Link to an existing GitHub issue and enter the issue’s URL.

Link to existing issue

Automatic issue creation

An issue can be created automatically when a new error is received. Select Create an issue for each new error.

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.

Auto create issue

Basic filters

Basic filtering is provided for severity, type, and release stage.

  • Filter by release stage: Select the release stage(s) that you want issues to be created for from the Release stage dropdown.
  • Filter by type: Create issues for either handled or unhandled errors only. Find out more >
  • Filter by severity: Create issues for certain severities by selecting severity option(s).
  • Filter by status: Select the status option(s) that you want to include in your filter from the Status toggle.

Advanced filters

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.

Two-way sync

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.

Sync settings

Access token permissions

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)

Access through firewall

If your server’s policy denies access from external IP addresses and websites, you will need to whitelist the IP addresses below. A whitelist provides access to designated IP addresses and sites that would otherwise be prevented by your security policy.

  • 104.196.245.109
  • 104.196.254.247