2019-09-04 21:01:54 +05:30
|
|
|
---
|
|
|
|
type: reference, howto
|
2020-05-24 23:13:21 +05:30
|
|
|
stage: Manage
|
|
|
|
group: Analytics
|
|
|
|
To determine the technical writer assigned to the Stage/Group associated with this page, see:
|
|
|
|
https://about.gitlab.com/handbook/engineering/ux/technical-writing/#designated-technical-writers
|
2019-09-04 21:01:54 +05:30
|
|
|
---
|
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|
# Insights **(ULTIMATE)**
|
2019-07-31 22:56:46 +05:30
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|
> [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/725) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 12.0.
|
2019-07-31 22:56:46 +05:30
|
|
|
|
|
|
|
Configure the Insights that matter for your groups to explore data such as
|
|
|
|
triage hygiene, issues created/closed per a given period, average time for merge
|
|
|
|
requests to be merged and much more.
|
|
|
|
|
|
|
|
![Insights example stacked bar chart](img/insights_example_stacked_bar_chart.png)
|
|
|
|
|
2019-09-04 21:01:54 +05:30
|
|
|
## View your group's Insights
|
|
|
|
|
2020-03-13 15:44:24 +05:30
|
|
|
You can access your group's Insights by clicking the **Analytics > Insights**
|
2019-09-04 21:01:54 +05:30
|
|
|
link in the left sidebar:
|
|
|
|
|
2020-03-13 15:44:24 +05:30
|
|
|
![Insights sidebar link](img/insights_sidebar_link_v12_8.png)
|
2019-09-04 21:01:54 +05:30
|
|
|
|
2019-07-31 22:56:46 +05:30
|
|
|
## Configure your Insights
|
|
|
|
|
|
|
|
Navigate to your group's **Settings > General**, expand **Insights**, and choose
|
|
|
|
the project that holds your `.gitlab/insights.yml` configuration file:
|
|
|
|
|
|
|
|
![group insights configuration](img/insights_group_configuration.png)
|
|
|
|
|
|
|
|
If no configuration was set, a [default configuration file](
|
2019-12-04 20:38:33 +05:30
|
|
|
https://gitlab.com/gitlab-org/gitlab/blob/master/ee/fixtures/insights/default.yml)
|
2019-07-31 22:56:46 +05:30
|
|
|
will be used.
|
|
|
|
|
2019-09-04 21:01:54 +05:30
|
|
|
See the [Project's Insights documentation](../../project/insights/index.md) for
|
2019-07-31 22:56:46 +05:30
|
|
|
more details about the `.gitlab/insights.yml` configuration file.
|
|
|
|
|
|
|
|
## Permissions
|
|
|
|
|
|
|
|
If you have access to view a group, then you have access to view their Insights.
|
|
|
|
|
|
|
|
NOTE: **Note:**
|
|
|
|
Issues or merge requests that you don't have access to (because you don't have
|
|
|
|
access to the project they belong to, or because they are confidential) are
|
|
|
|
filtered out of the Insights charts.
|
|
|
|
|
|
|
|
You may also consult the [group permissions table](../../permissions.md#group-members-permissions).
|
2019-09-04 21:01:54 +05:30
|
|
|
|
|
|
|
<!-- ## Troubleshooting
|
|
|
|
|
|
|
|
Include any troubleshooting steps that you can foresee. If you know beforehand what issues
|
|
|
|
one might have when setting this up, or when something is changed, or on upgrading, it's
|
|
|
|
important to describe those, too. Think of things that may go wrong and include them here.
|
|
|
|
This is important to minimize requests for support, and to avoid doc comments with
|
|
|
|
questions that you know someone might ask.
|
|
|
|
|
|
|
|
Each scenario can be a third-level heading, e.g. `### Getting error message X`.
|
|
|
|
If you have none to add when creating a doc, leave this section in place
|
|
|
|
but commented out to help encourage others to add to it in the future. -->
|