Skip to main content

This version of GitHub Enterprise Server was discontinued on 2024-03-26. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise Server. For help with the upgrade, contact GitHub Enterprise support.

About Server Statistics

You can use Server Statistics to analyze your own aggregate data from GitHub Enterprise Server, and help us improve GitHub products.

Who can use this feature?

Enterprise owners can enable Server Statistics.

About the benefits of Server Statistics

Server Statistics can help you anticipate the needs of your organization, understand how your team works, and show the value you get from GitHub Enterprise Server.

Once enabled, Server Statistics collects aggregate data on how much certain features are used on your instance over time. Unlike other Admin Stats API endpoints, which only return data for the last day, Server Statistics provides historical data of all Server Statistics metrics collected since the day you enabled the feature. For more information, see "Enabling Server Statistics for your enterprise."

When you enable Server Statistics, you're helping to build a better GitHub. The aggregated data you'll provide gives us insights into how GitHub adds value to our customers. This information allows GitHub to make better and more informed product decisions, ultimately benefiting you.

About data security

We respect your data. We will never transmit data from your GitHub Enterprise Server instance unless you have first given us permission to do so.

We collect no personal data. We also don't collect any GitHub content, such as code, issues, comments, or pull request content.

Only owners of the connected enterprise account or organization on GitHub Enterprise Cloud can access the data.

Only certain aggregate metrics are collected on repositories, issues, pull requests, and other features. To see the list of aggregate metrics collected, see "Server Statistics data collected."

Any updates to the collected metrics will happen in future feature releases of GitHub Enterprise Server and will be described in the GitHub Enterprise Server release notes. In addition, we will update this article with all metric updates.

For a better understanding of how we store and secure Server Statistics data, see "GitHub Security."

About data retention and deletion

GitHub collects Server Statistics data for as long as your GitHub Enterprise Server license is active and the Server Statistics feature is enabled.

If you would like to delete your data, you may do so by contacting GitHub Support, your GitHub account representative, or your Customer Success Manager. Generally, we delete data in the timeframe specified in our privacy statement. For more information, see GitHub's privacy statement in the documentation.

About data portability

As an organization owner or enterprise owner on GitHub Enterprise Cloud, you can access Server Statistics data by exporting the data in a CSV or JSON file or through the Server Statistics REST API. For more information, see "Requesting Server Statistics using the REST API" or "Exporting Server Statistics."

About disabling data collection

You can disable the Server Statistics feature at any time. For more information, see "Enabling Server Statistics for your enterprise."

Server Statistics data collected

After you enable Server Statistics, metrics are collected through a daily job that runs on your GitHub Enterprise Server instance. The aggregate metrics are stored on your organization or enterprise account on GitHub Enterprise Cloud and are not stored on your GitHub Enterprise Server instance.

The following aggregate metrics will be collected and transmitted on a daily basis and represent the total counts for the day.

CSV columnNameDescription
Agithub_connect.features_enabledArray of GitHub Connect features that are enabled for your instance (see "About GitHub Connect" )
Bhost_nameThe hostname for your instance
Cdormant_users.dormancy_thresholdThe length of time a user must be inactive to be considered dormant
Ddormant_users.total_dormant_usersNumber of dormant user accounts
Eghes_versionThe version of GitHub Enterprise Server that your instance is running
Fserver_idThe UUID generated for your instance
Gcollection_dateThe date the metrics were collected
Hschema_versionThe version of the database schema used to store this data
Ighe_stats.comments.total_commit_commentsNumber of comments on commits
Jghe_stats.comments.total_gist_commentsNumber of comments on gists
Kghe_stats.comments.total_issue_commentsNumber of comments on issues
Lghe_stats.comments.total_pull_request_commentsNumber of comments on pull requests
Mghe_stats.gists.total_gistsNumber of gists (both secret and public)
Nghe_stats.gists.private_gistsNumber of secret gists
Oghe_stats.gists.public_gistsNumber of public gists
Pghe_stats.hooks.total_hooksNumber of pre-receive hooks (both active and inactive)
Qghe_stats.hooks.active_hooksNumber of active pre-receive hooks
Rghe_stats.hooks.inactive_hooksNumber of inactive pre-receive hooks
Sghe_stats.issues.total_issuesNumber of issues (both open and closed)
Tghe_stats.issues.open_issuesNumber of open issues
Ughe_stats.issues.closed_issuesNumber of closed issues
Vghe_stats.milestones.total_milestonesNumber of milestones (both open and closed)
Wghe_stats.milestones.open_milestonesNumber of open milestones
Xghe_stats.milestones.closed_milestonesNumber of closed milestones
Yghe_stats.orgs.total_orgsNumber of organizations (both enabled and disabled)
Zghe_stats.orgs.disabled_orgsNumber of disabled organizations
AAghe_stats.orgs.total_teamsNumber of teams
ABghe_stats.orgs.total_team_membersNumber of team members
ACghe_stats.pages.total_pagesNumber of GitHub Pages sites
ADghe_stats.pulls.total_pullsNumber of pull requests
AEghe_stats.pulls.merged_pullsNumber of merged pull requests
AFghe_stats.pulls.mergeable_pullsNumber of pull requests that are currently mergeable
AGghe_stats.pulls.unmergeable_pullsNumber of pull requests that are currently unmergeable
AHghe_stats.repos.total_reposNumber of repositories (both upstream repositories and forks)
AIghe_stats.repos.root_reposNumber of upstream repositories
AJghe_stats.repos.fork_reposNumber of forks
AKghe_stats.repos.org_reposNumber of repositories owned by organizations
ALghe_stats.repos.total_pushesNumber of pushes to repositories
AMghe_stats.repos.total_wikisNumber of wikis
ANghe_stats.users.total_usersNumber of user accounts
AOghe_stats.users.admin_usersNumber of user accounts that are site administrators
APghe_stats.users.suspended_usersNumber of user accounts that are suspended

Optionally, you can include additional data about GitHub Actions. For more information, see "Including data about GitHub Actions in Server Statistics."

Server Statistics data examples

To see an example of the headings included in the CSV export for Server Statistics, download the Server Statistics CSV example.

To see an example of the response payload for the Server Statistics API, see "Requesting Server Statistics using the REST API."