Usage statistics

GitLab Inc. will periodically collect information about your instance in order to perform various actions.

All statistics are opt-out. You can enable/disable them in the Admin Area > Settings > Metrics and profiling section Usage statistics.

Network configuration

Allow network traffic from your GitLab instance to IP address 104.196.17.203:443, to send usage statistics to GitLab Inc.

If your GitLab instance is behind a proxy, set the appropriate proxy configuration variables.

Version Check

If enabled, version check will inform you if a new version is available and the importance of it through a status. This is shown on the help page (i.e. /help) for all signed in users, and on the admin pages. The statuses are:

  • Green: You are running the latest version of GitLab.
  • Orange: An updated version of GitLab is available.
  • Red: The version of GitLab you are running is vulnerable. You should install the latest version with security fixes as soon as possible.

Orange version check example

GitLab Inc. collects your instance’s version and hostname (through the HTTP referer) as part of the version check. No other information is collected.

This information is used, among other things, to identify to which versions patches will need to be backported, making sure active GitLab instances remain secure.

If you disable version check, this information will not be collected. Enable or disable the version check in Admin Area > Settings > Metrics and profiling > Usage statistics.

Request flow example

The following example shows a basic request/response flow between the self-managed GitLab instance and the GitLab Version Application:

sequenceDiagram participant GitLab instance participant Version Application GitLab instance->>Version Application: Is there a version update? loop Version Check Version Application->>Version Application: Record version info end Version Application->>GitLab instance: Response (PNG/SVG)

Usage Ping

Version history

GitLab sends a weekly payload containing usage data to GitLab Inc. The usage ping uses high-level data to help our product, support, and sales teams. It does not send any project names, usernames, or any other specific data. The information from the usage ping is not anonymous, it is linked to the hostname of the instance.

You can view the exact JSON payload in the administration panel. To view the payload:

  1. Navigate to the Admin Area > Settings > Metrics and profiling.
  2. Expand the Usage statistics section.
  3. Click the Preview payload button.

You can see how the usage ping data maps to different stages of the product.

Usage ping is important to GitLab as we use it to calculate our Action Monthly Active Users (AMAU) which helps us measure the success of our features.

Request flow example

The following example shows a basic request/response flow between the self-managed GitLab instance, GitLab Version Application, GitLab License Application and Salesforce:

sequenceDiagram participant GitLab instance participant Version Application participant License Application participant Salesforce GitLab instance->>Version Application: Usage Ping data loop Process Usage Data Version Application->>Version Application: Parse Usage Data Version Application->>Version Application: Record Usage Data Version Application->>Version Application: Update license ping time end Version Application-xLicense Application: Request Zuora subscription id License Application-xVersion Application: Zuora subscription id Version Application-xSalesforce: Request Zuora account id by Zuora subscription id Salesforce-xVersion Application: Zuora account id Version Application-xSalesforce: Usage data for the Zuora account Version Application->>GitLab instance: Conversational Development Index

Deactivate the usage ping

The usage ping is opt-out. If you want to deactivate this feature, go to the Settings page of your administration panel and uncheck the Usage ping checkbox.

To disable the usage ping and prevent it from being configured in future through the administration panel, Omnibus installs can set the following in gitlab.rb:

gitlab_rails['usage_ping_enabled'] = false

And source installs can set the following in gitlab.yml:

production: &base
  # ...
  gitlab:
    # ...
    usage_ping_enabled: false

Instance statistics visibility

Once usage ping is enabled, GitLab will gather data from other instances and will be able to show usage statistics of your instance to your users.

To make this visible only to admins, go to Admin Area > Settings > Metrics and profiling, expand Usage statistics, and set the Instance Statistics visibility option to Only admins.

Usage Statistics Collected

StatisticSectionStageDescription
uuid   
hostname   
version   
installation_type   
active_user_count   
recorded_at   
edition   
license_md5   
license_id   
historical_max_users   
Namelicensee  
Emaillicensee  
Companylicensee  
license_user_count   
license_starts_at   
license_expires_at   
license_plan   
license_trial   
assignee_listscounts  
boardscounts  
ci_buildscounts  
ci_internal_pipelinescounts  
ci_external_pipelinescounts  
ci_pipeline_config_auto_devopscounts  
ci_pipeline_config_repositorycounts  
ci_runnerscounts  
ci_triggerscounts  
ci_pipeline_schedulescounts  
auto_devops_enabledcounts  
auto_devops_disabledcounts  
deploy_keyscounts  
deploymentscounts  
successful_deploymentscounts  
failed_deploymentscounts  
environmentscounts  
clusterscounts  
clusters_enabledcounts  
project_clusters_enabledcounts  
group_clusters_enabledcounts  
clusters_disabledcounts  
project_clusters_disabledcounts  
group_clusters_disabledcounts  
clusters_platforms_ekscounts  
clusters_platforms_gkecounts  
clusters_platforms_usercounts  
clusters_applications_helmcounts  
clusters_applications_ingresscounts  
clusters_applications_cert_managerscounts  
clusters_applications_crossplanecounts  
clusters_applications_prometheuscounts  
clusters_applications_runnercounts  
clusters_applications_knativecounts  
clusters_applications_elastic_stackcounts  
in_review_foldercounts  
grafana_integrated_projectscounts  
groupscounts  
issuescounts  
issues_created_from_gitlab_error_tracking_uicounts  
issues_with_associated_zoom_linkcounts  
issues_using_zoom_quick_actionscounts  
issues_with_embedded_grafana_charts_approxcounts  
keyscounts  
label_listscounts  
lfs_objectscounts  
milestone_listscounts  
milestonescounts  
pages_domainscounts  
pool_repositoriescounts  
projectscounts  
projects_imported_from_githubcounts  
projects_with_repositories_enabledcounts  
projects_with_error_tracking_enabledcounts  
protected_branchescounts  
releasescounts  
remote_mirrorscounts  
snippetscounts  
suggestionscounts  
todoscounts  
uploadscounts  
web_hookscounts  
projects_alerts_activecounts  
projects_asana_activecounts  
projects_assembla_activecounts  
projects_bamboo_activecounts  
projects_bugzilla_activecounts  
projects_buildkite_activecounts  
projects_campfire_activecounts  
projects_custom_issue_tracker_activecounts  
projects_discord_activecounts  
projects_drone_ci_activecounts  
projects_emails_on_push_activecounts  
projects_external_wiki_activecounts  
projects_flowdock_activecounts  
projects_github_activecounts  
projects_hangouts_chat_activecounts  
projects_hipchat_activecounts  
projects_irker_activecounts  
projects_jenkins_activecounts  
projects_jenkins_deprecated_activecounts  
projects_jira_active -counts  
projects_mattermost_activecounts  
projects_mattermost_slash_commands_activecounts  
projects_microsoft_teams_activecounts  
projects_packagist_activecounts  
projects_pipelines_email_activecounts  
projects_pivotaltracker_activecounts  
projects_prometheus_activecounts  
projects_pushover_activecounts  
projects_redmine_activecounts  
projects_slack_activecounts  
projects_slack_slash_commands_activecounts  
projects_teamcity_activecounts  
projects_unify_circuit_activecounts  
projects_youtrack_activecounts  
projects_slack_notifications_activecounts  
projects_slack_slash_activecounts  
projects_jira_server_activecounts  
projects_jira_cloud_activecounts  
projects_jira_dvcs_cloud_activecounts  
projects_jira_dvcs_server_activecounts  
labelscounts  
merge_requestscounts  
notescounts  
wiki_pages_createcounts  
wiki_pages_updatecounts  
wiki_pages_deletecounts  
web_ide_commitscounts  
web_ide_viewscounts  
web_ide_merge_requestscounts  
web_ide_previewscounts  
snippet_commentcounts  
commit_commentcounts  
merge_request_commentcounts  
snippet_createcounts  
snippet_updatecounts  
navbar_searchescounts  
cycle_analytics_viewscounts  
productivity_analytics_viewscounts  
source_code_pushescounts  
merge_request_createcounts  
design_management_designs_createcounts  
design_management_designs_updatecounts  
design_management_designs_deletecounts  
licenses_list_viewscounts  
user_preferences_group_overview_detailscounts  
user_preferences_group_overview_security_dashboardcounts  
ingress_modsecurity_blockingcounts  
ingress_modsecurity_disabledcounts  
dependency_list_usages_totalcounts  
epicscounts  
feature_flagscounts  
geo_nodescounts  
incident_issuescounts  
ldap_group_linkscounts  
ldap_keyscounts  
ldap_userscounts  
pod_logs_usages_totalcounts  
projects_enforcing_code_owner_approvalcounts  
projects_mirrored_with_pipelines_enabledcounts  
projects_reporting_ci_cd_back_to_githubcounts  
projects_with_packagescounts  
projects_with_prometheus_alertscounts  
projects_with_tracing_enabledcounts  
projects_with_alerts_service_enabledcounts  
template_repositoriescounts  
container_scanning_jobscounts  
dependency_scanning_jobscounts  
license_management_jobscounts  
sast_jobscounts  
epics_deepest_relationship_levelcounts  
operations_dashboard_default_dashboardcounts  
operations_dashboard_users_with_projects_addedcounts  
container_registry_enabled   
dependency_proxy_enabled   
gitlab_shared_runners_enabled   
gravatar_enabled   
influxdb_metrics_enabled   
ldap_enabled   
mattermost_enabled   
omniauth_enabled   
prometheus_metrics_enabled   
reply_by_email_enabled   
signup_enabled   
web_ide_clientside_preview_enabled   
ingress_modsecurity_enabled   
elasticsearch_enabled   
license_trial_ends_on   
geo_enabled   
versionGit  
versionGitaly  
serversGitaly  
filesystemsGitaly  
enabledgitlab_pages  
versiongitlab_pages  
adapterdatabase  
versiondatabase  
averageavg_cycle_analytics - issue  
sdavg_cycle_analytics - issue  
missingavg_cycle_analytics - issue  
averageavg_cycle_analytics - plan  
sdavg_cycle_analytics - plan  
missingavg_cycle_analytics - plan  
averageavg_cycle_analytics - code  
sdavg_cycle_analytics - code  
missingavg_cycle_analytics - code  
averageavg_cycle_analytics - test  
sdavg_cycle_analytics - test  
missingavg_cycle_analytics - test  
averageavg_cycle_analytics - review  
sdavg_cycle_analytics - review  
missingavg_cycle_analytics - review  
averageavg_cycle_analytics - staging  
sdavg_cycle_analytics - staging  
missingavg_cycle_analytics - staging  
averageavg_cycle_analytics - production  
sdavg_cycle_analytics - production  
missingavg_cycle_analytics - production  
totalavg_cycle_analytics  
clusters_applications_cert_managersusage_activity_by_stageconfigure 
clusters_applications_helmusage_activity_by_stageconfigure 
clusters_applications_ingressusage_activity_by_stageconfigure 
clusters_applications_knativeusage_activity_by_stageconfigure 
clusters_disabledusage_activity_by_stageconfigure 
clusters_enabledusage_activity_by_stageconfigure 
clusters_platforms_gkeusage_activity_by_stageconfigure 
clusters_platforms_eksusage_activity_by_stageconfigure 
clusters_platforms_userusage_activity_by_stageconfigure 
group_clusters_disabledusage_activity_by_stageconfigure 
group_clusters_enabledusage_activity_by_stageconfigure 
project_clusters_disabledusage_activity_by_stageconfigure 
project_clusters_enabledusage_activity_by_stageconfigure 
projects_slack_notifications_activeusage_activity_by_stageconfigure 
projects_slack_slash_activeusage_activity_by_stageconfigure 
projects_with_prometheus_alerts: 0usage_activity_by_stageconfigure 
deploy_keysusage_activity_by_stagecreate 
keysusage_activity_by_stagecreate 
merge_requestsusage_activity_by_stagecreate 
projects_enforcing_code_owner_approvalusage_activity_by_stagecreate 
projects_imported_from_githubusage_activity_by_stagecreate 
projects_with_repositories_enabledusage_activity_by_stagecreate 
protected_branchesusage_activity_by_stagecreate 
remote_mirrorsusage_activity_by_stagecreate 
snippetsusage_activity_by_stagecreate 
suggestions:usage_activity_by_stagecreate 
groupsusage_activity_by_stagemanage 
ldap_keysusage_activity_by_stagemanage 
ldap_users: 0usage_activity_by_stagemanage 
users_createdusage_activity_by_stagemanage 
clustersusage_activity_by_stagemonitor 
clusters_applications_prometheususage_activity_by_stagemonitor 
operations_dashboard_default_dashboardusage_activity_by_stagemonitor 
operations_dashboard_users_with_projects_addedusage_activity_by_stagemonitor 
projects_prometheus_activeusage_activity_by_stagemonitor 
projects_with_error_tracking_enabledusage_activity_by_stagemonitor 
projects_with_tracing_enabled: 0usage_activity_by_stagemonitor 
projects_with_packages: 0usage_activity_by_stagepackage 
assignee_listsusage_activity_by_stageplan 
epicsusage_activity_by_stageplan 
issuesusage_activity_by_stageplan 
label_listsusage_activity_by_stageplan 
milestone_listsusage_activity_by_stageplan 
notesusage_activity_by_stageplan 
projectsusage_activity_by_stageplan 
projects_jira_activeusage_activity_by_stageplan 
projects_jira_dvcs_cloud_activeusage_activity_by_stageplan 
projects_jira_dvcs_server_activeusage_activity_by_stageplan 
service_desk_enabled_projectsusage_activity_by_stageplan 
service_desk_issuesusage_activity_by_stageplan 
todos: 0usage_activity_by_stageplan 
deploymentsusage_activity_by_stagerelease 
failed_deploymentsusage_activity_by_stagerelease 
projects_mirrored_with_pipelines_enabledusage_activity_by_stagerelease 
releasesusage_activity_by_stagerelease 
successful_deployments: 0usage_activity_by_stagerelease 
user_preferences_group_overview_security_dashboard: 0usage_activity_by_stagesecure 
ci_buildsusage_activity_by_stageverify 
ci_external_pipelinesusage_activity_by_stageverify 
ci_internal_pipelinesusage_activity_by_stageverify 
ci_pipeline_config_auto_devopsusage_activity_by_stageverify 
ci_pipeline_config_repositoryusage_activity_by_stageverify 
ci_pipeline_schedulesusage_activity_by_stageverify 
ci_pipelinesusage_activity_by_stageverify 
ci_triggersusage_activity_by_stageverify 
clusters_applications_runnerusage_activity_by_stageverify 
projects_reporting_ci_cd_back_to_github: 0usage_activity_by_stageverify