Skip to content
GitLab

Insights for groups (ULTIMATE)

Introduced in GitLab 12.0.

Configure insights to explore data about you group's activity, such as triage hygiene, issues created or closed in a given period, and average time for merge requests to be merged. You can also create custom insights reports that are relevant for your group.

View group insights

Prerequisites:

  • You must have permission to view the group.
  • You must have access to a project to view information about its merge requests and issues, and permission to view them if they are confidential.

To access your group's insights:

  1. On the left sidebar, at the top, select Search GitLab ({search}) to find your group.
  2. Select Analyze > Insights.

Interact with insights charts

You can interact with the insights charts to view details about your group's activity.

Insights example stacked bar chart

Display different reports

To display one of the available reports on the insights page, from the Select report dropdown list, select the report you want to display.

View bar chart annotations

To view annotations, hover over each bar in the chart.

Zoom in on chart

Insights display data from the last 90 days. You can zoom in to display data only from a subset of the 90-day range.

To do this, select the pause icons ({status-paused}) and slide them along the horizontal axis:

  • To select a later start date, slide the left pause icon to the right.
  • To select an earlier end date, slide the right pause icon to the left.

Exclude dimensions from charts

By default, insights display all available dimensions on the chart.

To exclude a dimension, from the legend below the chart, select the name of the dimension.

Configure group insights

GitLab reads insights from the default configuration file.

To configure group insights:

  1. Create a new file .gitlab/insights.yml in a project that belongs to your group.
  2. On the left sidebar, at the top, select Search GitLab ({search}) to find your group.
  3. Select Settings > General.
  4. Expand Analytics and find the Insights section.
  5. Select the project that contains your .gitlab/insights.yml configuration file.
  6. Select Save changes.