Usage statistics

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

All statistics are opt-out. To enable or disable them:

  1. On the top bar, select Menu > Admin.
  2. In the left sidebar, select Settings > Metrics and profiling, and expand Usage statistics.
  3. Enable or disable Version check and Usage ping.
  4. Select Save changes.

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 informs 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 must be backported, making sure active GitLab instances remain secure.

If you disable version check, this information isn’t collected. To enable or disable it:

  1. On the top bar, select Menu > Admin.
  2. In the left sidebar, select Settings > Metrics and profiling, and expand Usage statistics.
  3. Enable or disable Version check.
  4. Select Save changes.

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

See Usage Ping guide.

Instance-level analytics availability

After usage ping is enabled, GitLab gathers data from other instances and enables certain instance-level analytics features that are dependent on usage ping.