BigW Consortium Gitlab

user_cohorts.md 1.32 KB
Newer Older
1 2 3
# Cohorts

> **Notes:**
Regis Freyd committed
4
> [Introduced][ce-23361] in GitLab 9.1.
5 6

As a benefit of having the [usage ping active](settings/usage_statistics.md),
7
GitLab lets you analyze the users' activities of your GitLab installation.
8 9
Under `/admin/cohorts`, when the usage ping is active, GitLab will show the
monthly cohorts of new users and their activities over time.
10

Regis Freyd committed
11 12
## Overview

13 14 15 16 17
How do we read the user cohorts table? Let's take an example with the following
user cohorts.

![User cohort example](img/cohorts.png)

18
For the cohort of June 2016, 163 users have been added on this server and have
Regis Freyd committed
19
been active since this month. One month later, in July 2016, out of
20 21 22 23 24 25
these 163 users, 155 users (or 95% of the June cohort) are still active. Two
months later, 139 users (or 85%) are still active. 9 months later, we can see
that only 6% of this cohort are still active.

The Inactive users column shows the number of users who have been added during
the month, but who have never actually had any activity in the instance.
26 27

How do we measure the activity of users? GitLab considers a user active if:
Regis Freyd committed
28

29
* the user signs in
30
* the user has Git activity (whether push or pull).
31

Regis Freyd committed
32
## Setup
33

Regis Freyd committed
34
1. [Activate the usage ping](settings/usage_statistics.md)
35
2. Go to `/admin/cohorts` to see the user cohorts of the server
36 37

[ce-23361]: https://gitlab.com/gitlab-org/gitlab-ce/issues/23361