Git integration with GitHub

When setting up a new app on Opbeat you will be asked to setup Git integration. Some Git services like GitHub and Bitbucket are natively supported in Opbeat, while others can be connected using SSH keys.

See the Git integration article for a list of supported services.

How to connect a GitHub repository

1. Authenticate with GitHub

First, choose the GitHub tab to integrate Opbeat with your GitHub repository.

When integrating with GitHub you need to give Opbeat access to your repositories. Pressing the Connect button starts this procedure.

2. Choose a repository

Choose which repository you want to integrate with from the dropdown and that repository will be linked with your Opbeat app.

How to change repository

If you want to change which GitHub repository is connected your app on Opbeat, go to the settings for your app and click the “Change repository” button. If you are changing from a Bitbucket repository, or a repository hosted elsewhere, make sure you choose the GitHub tab to start setting up the Git integration.

Why does Opbeat need private repo access on GitHub

We need private repo access on GitHub to show the commits that make up a Release, as well as the information in the annotated stacktraces (who last edited a given line, which release was that line last included in etc.).

We are aware of the privilege we get with the level of access to your private repos, and we only use it to get information we need to give you the best experience with Opbeat.

Due to a limitation in GitHub’s API, we ask for read-write access to all of your repos, even though we only need read access to your connected repo. When GitHub changes their API, we will modify the permission request. (Alternatively, you can use our custom Git integration)