Tools Connect: GitHub

Overview

Allstacks connects to GitHub to collect data like commits, pull requests, branches, and other coding activity. This helps give a full picture of your team’s engineering work.

Before You Start

• Make sure you’re signed into the correct GitHub account

• You must have a GitHub account

• Supported environments:

  • GitHub Cloud

  • GitHub Enterprise Cloud

  • GitHub Enterprise Server

Permissions Needed

• Owner/Admin access is required to set up the connection

• After setup, you can switch to a service account with read-only access

• The service account must have read access to repositories

Repository roles for an organization - GitHub Docs

Copilot Requirement

• Copilot Metrics API must be enabled

• Copilot Usage Metrics API must be enabled

• Check this in:
  GitHub → Settings → Copilot → Policies

Connecting GitHub

Connection Options

Option 1: OAuth App (Simpler)

1. Go to Allstacks → Tools

2. Click Add Tools → GitHub

3. Click Add Tool

4. Grant permissions in GitHub

5. Select repositories to enable

Option 2: GitHub App (More Controlled)

1. Go to Allstacks → Tools

2. Click Add Tools → GitHub App

3. Click Add Tool

4. Install the Allstacks GitHub App

5. Select repositories to enable

If you’re not an Owner, GitHub will send an approval request.

When you click “Add Tool”, you’ll be redirected to GitHub to authorize access.

Open

During Authorization

• Select Read access for repositories

• Click Grant for your organization

• If you’re not an admin, you may need to request approval

After Connecting

• You’ll see a list of organizations and repositories

• Turn ON only what you need

• If nothing shows, click “Refresh Resources”

Troubleshooting

Unable to Connect

OAuth App

• Check if your GitHub org has OAuth restrictions enabled

• Make sure Allstacks is approved

Helpful links:

• OAuth restrictions: About OAuth app access restrictions - GitHub Docs

• Request approval: Requesting organization approval for OAuth apps - GitHub Docs

• Approve app (Owner only): Approving OAuth apps for your organization - GitHub Docs

GitHub App

• If you don’t see any organizations during install →
  you are not part of a GitHub organization

• Fix: Ask to be added to the org, then try again

Metrics Not Appearing

• Make sure GitHub is connected under Tools

• Confirm the connection is still active

• Check you have the right permissions

Access Issues

• OAuth method → user must be an Org Owner

• GitHub App → check installation + repo access

Check here:

• https://github.com/organizations/%3Cyour%20org%20name%3E/settings/installations  

Make sure:

• Allstacks Analytics app is installed

• Correct repos are selected

• No pending permission approvals

Also confirm:

• Copilot Metrics API is enabled
  (GitHub → Settings → Copilot → Policies)

Data Sync Problems

• First sync can take up to 24 hours

• After that, check Configure → Metrics

Support

Still stuck?

• Contact your Customer Success Manager (CSM)

• Share:

  • Your GitHub setup (Cloud / Enterprise / Server)

  • Any error messages

  • What step failed