GitHub

Integrate your Airbrake project with GitHub

Description

With Airbrake’s GitHub integration, you can:

  • Automatically create GitHub issue with error details for every new type of an error
  • Manually create GitHub issue with error details from the Error Dashboard
  • Re-open previously closed GitHub issue when a linked resolved Airbrake error re-occurs
  • Collect the associated code diffs of each deploy to get insights such as additions, deletions, file changes, snapshots, and much more

GitHub Configuration

  1. From the GitHub integration page, click on the Redirect to GitHub for authentication button
  1. Log into your GitHub account and grant access to Airbrake. Make sure to grant access for all organizations where your repositories for integration are located
  1. Enter your full GitHub repository URL, tweak the settings, and click on the Save button

GitHub Enterprise Configuration

  1. Create your personal GitHub Enterprise access token
  • On your GitHub Enterprise account go to personal Settings:

  • Click on the Personal access tokens link:

  • Click on the Generate new token button:

  • Enter Token description, and select repo and public_repo scopes. Click on the Generate token button:

  1. From the GitHub integration page, select GitHub Enterprise from the “Integration type” select menu, and enter your personal GitHub Enterprise access token from the step 1
  1. Enter your full GitHub Enterprise repository URL, tweak the settings and click on the Save button

Settings

SettingDescription
EnabledPause/Unpause the integration
Auto create GitHub issue when an error occursCreate a GitHub issue for every new type of Airbrake error
User for auto creationDefine the user that will be used for auto creation of new GitHub issues
Reopen closed GitHub issue when a resolved error reoccursReopen linked closed GitHub issue when a resolved error reoccurs
Enable Code InsightsFor each deploy, collect the associated code diffs to provide code insights including additions, deletions, file changes, snapshots, and much more
Only trigger for errors with environments matching “production” (not case sensitive)Only create GitHub issues for errors from the “production” environment

GitHub Troubleshooting

404 error

Github integration could not connect. Error: 404 - Not Found - Please make sure the credentials are correct and try again.

If you’re seeing this 404 error despite having full access to the repo you’re trying to integrate with, please make sure third-party application access is granted for the Airbrake application.

You can find this option in your organization’s settings page: https://github.com/organizations/YOUR_ORG_NAME/settings/oauth_application_policy

To enable third-party access, please click Airbrake then click the “grant” button. If you do not see this button, go to your personal settings, in the “third-party access” section, and revoke the Airbrake token and try again.