• DevOps metrics comparison panel
• View the value streams dashboard
• Customize the dashboard panels
  • Using query parameters
  • Using YAML configuration
• Dashboard metrics and drill-down reports

Value Streams Dashboard

You can leave feedback on dashboard bugs or functionality in issue 381787. For more information, see also the Value Stream Management category direction page.

The Value Streams Dashboard is a customizable dashboard you can use to identify trends, patterns, and opportunities for digital transformation improvements.

With the Value Streams Dashboard, you can compare software delivery metrics. This comparison can help you understand whether projects and groups are improving.

The Value Streams Dashboard includes the following metrics:

• DORA metrics
• Value Stream Analytics (VSA) - flow metrics
• Vulnerabilities metrics.

The Value Streams Dashboard allows you to:

• Aggregate data records from different APIs.
• Track software performance (DORA) and flow of value (VSA) across the organization.

DevOps metrics comparison panel

The DevOps metrics comparison displays DORA4 and flow metrics for a group or project in the month-to-date, last month, the month before, and the past 180 days.

This visualization helps you get a high-level custom view over multiple DevOps metrics and understand whether they’re improving month over month. You can compare the performance between groups, projects, and teams at a glance. This visualization helps you identify the teams and projects that are the largest value contributors, overperforming, or underperforming.

You can also drill down the metrics for further analysis. When you hover over a metric, a tooltip displays an explanation of the metric and a link to the related documentation page.

View the value streams dashboard

Prerequisite:

• To view the value streams dashboard for a group, you must have at least the Reporter role for the group.

To view the value streams dashboard:

1. On the left sidebar, at the top, select Search GitLab () to find your project or group.
2. Select Analyze > Value stream analytics.
3. Below the Filter results text box, in the Lifecycle metrics row, select Value Streams Dashboard / DORA.
4. Optional. To open the new page, append this path /analytics/dashboards/value_streams_dashboard to the group URL (for example, https://gitlab.com/groups/gitlab-org/-/analytics/dashboards/value_streams_dashboard).

Customize the dashboard panels

You can customize the Value Streams Dashboard and configure what subgroups and projects to include in the page.

A view can display maximum four subgroups or projects.

Using query parameters

To display multiple subgroups and projects, specify their path as a URL parameter.

For example, the parameter query=gitlab-org/gitlab-ui,gitlab-org/plan-stage displays three separate panels, one each for the:

• gitlab-org group
• gitlab-ui project
• gitlab-org/plan-stage subgroup

Using YAML configuration

To customize the default content of the page, you need to create a YAML configuration file in a project of your choice. In this file you can define various settings and parameters, such as title, description, and number of panels and labels filters. The file is schema-driven and managed with version control systems like Git. This enables tracking and maintaining a history of configuration changes, reverting to previous versions if necessary, and collaborating effectively with team members. Query parameters can still be used to override the YAML configuration.

First, you need to set up the project.

Prerequisite:

• You must have at least the Maintainer role for the group.

1. On the left sidebar, at the top, select Search GitLab () to find your group.
2. Select Settings > General.
3. Expand Analytics.
4. Select the project where you would like to store your YAML configuration file.
5. Select Save changes.

After you have set up the project, set up the configuration file:

1. On the left sidebar, at the top, select Search GitLab () to find your project.
2. In the default branch, create the configuration file: .gitlab/analytics/dashboards/value_streams/value_streams.yaml.
3. In the value_streams.yaml configuration file, fill in the configuration options:

# title - Change the title of the Value Streams Dashboard. [optional]
title: 'Custom Dashboard title'

# description - Change the description of the Value Streams Dashboard. [optional]
description: 'Custom description'

# panels - List of panels that contain panel settings.
#   title - Change the title of the panel. [optional]
#   data.namespace - The Group or Project path to use for the chart panel.
#   data.exclude_metrics - Hide rows by metric ID from the chart panel.
#   data.filter_labels -
#     Only show results for data that matches the queried label(s). If multiple labels are provided,
#     only a single label needs to match for the data to be included in the results.
#     Compatible metrics (other metrics will be automatically excluded):
#       * lead_time
#       * cycle_time
#       * issues
#       * issues_completed
#       * merge_request_throughput
#     (This option is dependant on the `vsd_graphql_dora_and_flow_metrics` feature.)
panels:
  - title: 'My Custom Project'
    data:
      namespace: group/my-custom-project
  - data:
      namespace: group/another-project
      filter_labels:
        - in_development
        - in_review
  - title: 'My Custom Group'
    data:
      namespace: group/my-custom-group
      exclude_metrics:
        - deployment_frequency
        - change_failure_rate
  - data:
      namespace: group/another-group

The following example has an option configuration for a panel for the my-group namespace:

  panels:
    - data:
        namespace: my-group

For an overview of editing label filters in the configuration file, see GitLab Value Streams Dashboard - Label filters demo.

Dashboard metrics and drill-down reports