gitlab-org--gitlab-foss/doc/user/admin_area/analytics/user_cohorts.md

# Cohorts

> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/23361) in GitLab 9.1.

As a benefit of having the [usage ping active](../settings/usage_statistics.md),
GitLab lets you analyze the users' activities over time of your GitLab installation.

## Overview

How do we read the user cohorts table? Let's take an example with the following
user cohorts.

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

For the cohort of March 2020, three users have been added on this server and have
been active since this month. One month later, in April 2020, two users are
still active. Five months later (August), we can see that one user from this cohort
is active, or 33% of the original cohort of three that joined in March.

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.

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

- The user signs in.
- The user has Git activity (whether push or pull).
- The user visits pages related to Dashboards, Projects, Issues, and Merge Requests ([introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/54947) in GitLab 11.8).
- The user uses the API
- The user uses the GraphQL API
Instance statistics docs 2018-08-16 10:27:21 -04:00			`# Cohorts`

Add latest changes from gitlab-org/gitlab@master 2020-05-21 23:08:28 -04:00			`> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/23361) in GitLab 9.1.`
Instance statistics docs 2018-08-16 10:27:21 -04:00
Add latest changes from gitlab-org/gitlab@master 2020-08-21 14:10:24 -04:00			`As a benefit of having the [usage ping active](../settings/usage_statistics.md),`
Instance statistics docs 2018-08-16 10:27:21 -04:00			`GitLab lets you analyze the users' activities over time of your GitLab installation.`

			`## Overview`

			`How do we read the user cohorts table? Let's take an example with the following`
			`user cohorts.`

Add latest changes from gitlab-org/gitlab@master 2020-09-07 14:08:32 -04:00			`![User cohort example](img/cohorts_v13_4.png)`
Instance statistics docs 2018-08-16 10:27:21 -04:00
Add latest changes from gitlab-org/gitlab@master 2020-08-21 14:10:24 -04:00			`For the cohort of March 2020, three users have been added on this server and have`
			`been active since this month. One month later, in April 2020, two users are`
			`still active. Five months later (August), we can see that one user from this cohort`
			`is active, or 33% of the original cohort of three that joined in March.`
Instance statistics docs 2018-08-16 10:27:21 -04:00
			`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.`

			`How do we measure the activity of users? GitLab considers a user active if:`

Make unordered lists conform to styleguide - Also makes other minor Markdown fixes that were near the main fixes. 2018-11-13 01:07:16 -05:00			`- The user signs in.`
			`- The user has Git activity (whether push or pull).`
Add latest changes from gitlab-org/gitlab@master 2020-05-21 23:08:28 -04:00			`- The user visits pages related to Dashboards, Projects, Issues, and Merge Requests ([introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/54947) in GitLab 11.8).`
Add latest changes from gitlab-org/gitlab@master 2020-02-10 10:08:54 -05:00			`- The user uses the API`
Add latest changes from gitlab-org/gitlab@master 2020-05-14 11:08:14 -04:00			`- The user uses the GraphQL API`