Commit 333c6610 authored by Rémy Coutable's avatar Rémy Coutable

Document how to access the Insights page

Signed-off-by: default avatarRémy Coutable <remy@rymai.me>
parent 329a2a0f
...@@ -4,8 +4,8 @@ ...@@ -4,8 +4,8 @@
CAUTION: **Beta:** CAUTION: **Beta:**
Insights is considered beta, and is not ready for production use. Insights is considered beta, and is not ready for production use.
Follow [gitlab-org&725](https://gitlab.com/groups/gitlab-org/-/epics/725) for Follow [gitlab-org/quality/team-tasks#137](https://gitlab.com/gitlab-org/quality/team-tasks/issues/137#general-availability)
updates. for updates.
Configure the Insights that matter for your groups to explore data such as 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 triage hygiene, issues created/closed per a given period, average time for merge
...@@ -13,6 +13,13 @@ requests to be merged and much more. ...@@ -13,6 +13,13 @@ requests to be merged and much more.
![Insights example stacked bar chart](img/insights_example_stacked_bar_chart.png) ![Insights example stacked bar chart](img/insights_example_stacked_bar_chart.png)
## View your group's Insights
You can access your group's Insights by clicking the **Overview > Insights**
link in the left sidebar:
![Insights sidebar link](img/insights_sidebar_link.png)
## Configure your Insights ## Configure your Insights
Navigate to your group's **Settings > General**, expand **Insights**, and choose Navigate to your group's **Settings > General**, expand **Insights**, and choose
......
...@@ -4,18 +4,25 @@ ...@@ -4,18 +4,25 @@
CAUTION: **Beta:** CAUTION: **Beta:**
Insights is considered beta, and is not ready for production use. Insights is considered beta, and is not ready for production use.
Follow [gitlab-org&725](https://gitlab.com/groups/gitlab-org/-/epics/725) for Follow [gitlab-org/quality/team-tasks#137](https://gitlab.com/gitlab-org/quality/team-tasks/issues/137#general-availability)
updates. for updates.
Configure the Insights that matter for your projects to explore data such as Configure the Insights that matter for your projects to explore data such as
triage hygiene, issues created/closed per a given period, average time for merge triage hygiene, issues created/closed per a given period, average time for merge
requests to be merged and much more. requests to be merged and much more.
![Insights example stacked bar chart](img/project_insights.png) ![Insights example bar chart](img/project_insights.png)
NOTE: **Note:** NOTE: **Note:**
This feature is [also available at the group level](https://docs.gitlab.com/ee/user/group/insights/index.html). This feature is [also available at the group level](https://docs.gitlab.com/ee/user/group/insights/index.html).
## View your project's Insights
You can access your project's Insights by clicking the **Project > Insights**
link in the left sidebar:
![Insights sidebar link](img/insights_sidebar_link.png)
## Configure your Insights ## Configure your Insights
Insights are configured using a YAML file called `.gitlab/insights.yml` within Insights are configured using a YAML file called `.gitlab/insights.yml` within
...@@ -74,8 +81,7 @@ Each chart definition is made up of a hash composed of key-value pairs. ...@@ -74,8 +81,7 @@ Each chart definition is made up of a hash composed of key-value pairs.
For example, here's single chart definition: For example, here's single chart definition:
```yaml ```yaml
monthlyBugsCreated: - title: Monthly Bugs Created (bar)
title: Monthly Bugs Created (bar)
type: bar type: bar
query: query:
issuable_type: issue issuable_type: issue
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment