Skip to main content

Connect GitHub

GitHub is the world's leading platform for software development, version control, and collaboration. The GitHub integration imports your organization or enterprise billing data โ€” including GitHub Actions, Copilot, Packages, and more โ€” into DoiT Cloud Intelligence so you can analyze GitHub costs in Cloud Analytics.

Prerequisitesโ€‹

Before you begin, make sure you have the following:

  • A GitHub organization or enterprise account with Owner permissions.
  • A DoiT account with the Billing Profiles Admin permission.

Connection overviewโ€‹

The GitHub integration supports two connection levels:

Connection levelScopeBest for
OrganizationA single GitHub organizationTeams managing one organization
EnterpriseAn entire GitHub enterprise (includes all organizations)Enterprises with multiple organizations

DoiT connects to GitHub using OAuth for billing data. Optionally, you can also install the DoiT GitHub App to enable enriched data such as Copilot seat assignments, Copilot usage metrics, and GitHub Advanced Security.

Connect your GitHub accountโ€‹

Step 1: Start the connection wizardโ€‹

  1. Sign in to DoiT Cloud Intelligence, navigate to Data ingestion and integrations โ†’ Assets.

  2. Select GitHub from the left-hand menu, and then select Connect new account.

Step 2: Choose your connection levelโ€‹

  1. Select the Connection Level:

    • Organization โ€” connect a single GitHub organization.
    • Enterprise โ€” connect an entire GitHub enterprise account.
  2. Enter your Organization or Enterprise slug. This is the URL-friendly name of your organization or enterprise (e.g. my-company).

    Tip

    You can find your organization slug in the URL when viewing your GitHub organization: github.com/ my-company. For enterprise accounts, navigate to github.com/enterprises/ my-company.

Step 3: Authorize with OAuthโ€‹

  1. Select Authorize to begin the OAuth flow.

  2. You will be redirected to GitHub to sign in (if not already signed in) and grant DoiT access to your billing data.

  3. Review the requested permissions and select Authorize.

    DoiT requests the following OAuth scopes:

    • admin:org โ€” read organization billing and usage data.
    • read:enterprise โ€” read enterprise billing data (for enterprise connections).
  4. After authorization, you will be redirected back to DoiT Cloud Intelligence.

Step 4: (Optional) Enable enriched data with the GitHub Appโ€‹

For deeper visibility into Copilot usage and GitHub Advanced Security, you can optionally install the DoiT GitHub App:

  1. In the connection wizard, select Enable enriched data (Copilot seats, Advanced Security).

  2. Follow the prompts to install the GitHub App on your organization.

  3. The GitHub App provides access to:

    • Copilot seat assignments โ€” see which users have Copilot licenses.
    • Copilot usage metrics โ€” track adoption and activity.
    • GitHub Advanced Security โ€” view GHAS committer counts per repository.
Note

The GitHub App is optional. Without it, DoiT still imports all billing and usage data via the OAuth connection. The app adds supplementary data for Copilot and security insights.

Step 5: Test and saveโ€‹

  1. Select Test connection to verify DoiT can access your GitHub billing data.

  2. If the test is successful, select Save to complete the setup.

    If the test fails or you need further assistance, please open an expert inquiry.

Note

Upon initial connection, DoiT ingests up to 90 days of historical billing data. The import process can take a few hours. You'll receive an email when the data is available in Cloud Analytics.

Data refreshโ€‹

DoiT refreshes your GitHub billing data every 6 hours. Billing data typically becomes available within 24โ€“26 hours of being generated by GitHub.

Reporting dimensionsโ€‹

Once connected, GitHub billing data maps to the following standard Cloud Analytics dimensions:

Cloud Analytics dimensionGitHub valueExample
ProviderGitHubGitHub
Billing AccountOrganization or enterprise namemy-company
Project/Account IDRepository or organization namemy-company/api-service
ServiceGitHub product nameactions, copilot, packages, codespaces
SKUUsage SKUactions_linux_4_core, copilot_business

In addition to standard dimensions, the following GitHub-specific labels are available:

LabelDescription
OrganizationThe GitHub organization name
RepositoryThe repository associated with the cost
UserThe user associated with the usage (when available)
ProductGitHub product (e.g. Actions, Copilot, Packages, Codespaces)
ModelThe AI model used (for Copilot premium requests)
Tip

To filter Cloud Analytics reports to only Copilot spending, use the Product label with the value Copilot.

Delete your GitHub connectionโ€‹

  1. Sign in to DoiT Cloud Intelligence, navigate to Data ingestion and integrations โ†’ Assets.

  2. Select GitHub from the left-hand menu.

  3. Select the three dots menu (โ‹ฎ) at the rightmost end of the GitHub account you want to remove and select Delete.

  4. Select Delete to confirm.

Removing the integration also revokes the OAuth token and uninstalls the GitHub App (if installed). All previously imported GitHub cost data will be removed from DoiT Cloud Intelligence.