1. Home
  2. Product Guides
  3. Crash Reporting
  4. Integrations
  5. GitHub

GitHub

note: To use this integration, you will need to be on a Team plan or higher. Read about upgrading here.

GitHub is a source code hosting and issue tracking service. You can easily connect Raygun error groups to GitHub issues. This integration is even smart enough to resolve a bug in Raygun when you mark an issue as resolved in GitHub and link stacktraces in Raygun error groups back to GitHub.

  1. Click "Integrations" from the Raygun sidebar and select GitHub.

  2. Click the "Setup" tab and follow the on-screen instructions to complete the authorization process.

tip: Ensure you grant access to any Organisation repositories you wish to use with Raygun during this process. Ungranted Organisations won't appear in the dropdown.

  1. When this is complete return to "Integrations" and click GitHub to select a repository from the drop down menu.

GitHub set up

  1. Click on an error group.

  2. Click the "Integrations" button and select "GitHub" to link to a new or existing issue.

GitHub set up

The two-way sync capability is available between your crash reports and GitHub issues. To enable this, simply check the checkbox below when you set up this integration:

GitHub set up

Go to your GitHub account settings, click on "Profile", and make sure you have a "Name" entered.

Check your GitHub repository has issues enabled by going to your repository settings, scrolling to the "Features" section and making sure the "Issues" box has been ticked.

You need to grant access for Raygun to view these repositories during the OAuth setup step.

You can follow these steps to retrigger this flow:

  1. Open the Authorized OAuth Apps page on Github for your account.
  2. Locate the "Raygun" application & click on the "Show more options" button for the app.
  3. Click "Revoke".
  4. Open your Raygun application & navigate to the Integrations > GitHub > Setup screen.
  5. Click on the Renew / Setup button to trigger the new Auth flow.
  6. Ensure you "grant" access to the organisations you want on the required permissions screen before accepting.
  7. You should now be able to select your desired repository from the selector.

On this page: