BigW Consortium Gitlab

usage_statistics.md 2.29 KB
Newer Older
1 2 3 4 5
# Usage statistics

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

6 7
All statistics are opt-out, you can enable/disable them from the admin panel
under **Admin area > Settings > Usage statistics**.
8 9 10 11 12

## Version check

GitLab can inform you when an update is available and the importance of it.

13
No information other than the GitLab version and the instance's hostname (through the HTTP referer)
14 15 16 17 18 19 20 21 22 23 24 25
are collected.

In the **Overview** tab you can see if your GitLab version is up to date. There
are three cases: 1) you are up to date (green), 2) there is an update available
(yellow) and 3) your version is vulnerable and a security fix is released (red).

In any case, you will see a message informing you of the state and the
importance of the update.

If enabled, the version status will also be shown in the help page (`/help`)
for all signed in users.

26
## Usage ping
27 28

> [Introduced][ee-557] in GitLab Enterprise Edition 8.10. More statistics
29
[were added][ee-735] in GitLab Enterprise Edition
30
8.12. [Moved to GitLab Community Edition][ce-23361] in 9.1.
31

32 33 34 35 36 37 38
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.
39 40 41

### Deactivate the usage ping

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

46 47
To disable the usage ping and prevent it from being configured in future through
the administration panel, Omnibus installs can set the following in
48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63
[`gitlab.rb`](https://docs.gitlab.com/omnibus/settings/configuration.html#configuration-options):

```ruby
gitlab_rails['usage_ping_enabled'] = false
```

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

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

64 65
[ee-557]: https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/557
[ee-735]: https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/735
66
[ce-23361]: https://gitlab.com/gitlab-org/gitlab-ce/issues/23361