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 level | Scope | Best for |
|---|---|---|
| Organization | A single GitHub organization | Teams managing one organization |
| Enterprise | An 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โ
-
Sign in to DoiT Cloud Intelligence, navigate to Data ingestion and integrations โ Assets.
-
Select GitHub from the left-hand menu, and then select Connect new account.
Step 2: Choose your connection levelโ
-
Select the Connection Level:
- Organization โ connect a single GitHub organization.
- Enterprise โ connect an entire GitHub enterprise account.
-
Enter your Organization or Enterprise slug. This is the URL-friendly name of your organization or enterprise (e.g.
my-company).TipYou can find your organization slug in the URL when viewing your GitHub organization:
github.com/my-company. For enterprise accounts, navigate togithub.com/enterprises/my-company.
Step 3: Authorize with OAuthโ
-
Select Authorize to begin the OAuth flow.
-
You will be redirected to GitHub to sign in (if not already signed in) and grant DoiT access to your billing data.
-
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).
-
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:
-
In the connection wizard, select Enable enriched data (Copilot seats, Advanced Security).
-
Follow the prompts to install the GitHub App on your organization.
-
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.
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โ
-
Select Test connection to verify DoiT can access your GitHub billing data.
-
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.
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 dimension | GitHub value | Example |
|---|---|---|
| Provider | GitHub | GitHub |
| Billing Account | Organization or enterprise name | my-company |
| Project/Account ID | Repository or organization name | my-company/api-service |
| Service | GitHub product name | actions, copilot, packages, codespaces |
| SKU | Usage SKU | actions_linux_4_core, copilot_business |
In addition to standard dimensions, the following GitHub-specific labels are available:
| Label | Description |
|---|---|
| Organization | The GitHub organization name |
| Repository | The repository associated with the cost |
| User | The user associated with the usage (when available) |
| Product | GitHub product (e.g. Actions, Copilot, Packages, Codespaces) |
| Model | The AI model used (for Copilot premium requests) |
To filter Cloud Analytics reports to only Copilot spending, use the Product label with the value Copilot.
Delete your GitHub connectionโ
-
Sign in to DoiT Cloud Intelligence, navigate to Data ingestion and integrations โ Assets.
-
Select GitHub from the left-hand menu.
-
Select the three dots menu (โฎ) at the rightmost end of the GitHub account you want to remove and select Delete.
-
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.