バリューストリームダッシュボード

Value Streams Dashboardは、デジタル変革の改善のためのトレンド、パターン、および機会を特定するために使用できる、カスタマイズ可能なダッシュボードです。Value Streams Dashboardの一元化されたUIは、すべての関係者が組織に関連する同じメトリクスセットにアクセスして表示できる、single source of truth（SSOT）として機能します。Value Streams Dashboardには、次のメトリクスを視覚化するパネルが含まれています:

• DORAメトリクス
• バリューストリーム分析 (VSA) - フローメトリクス
• 脆弱性
• GitLab Duoコード提案

Value Streams Dashboardを使用すると、次のことができます:

• 以前にリストされたメトリクスを、一定期間にわたって追跡および比較します。
• 下降トレンドを早期に特定します。
• セキュリティの露出を理解します。
• 個々のプロジェクトまたはメトリクスにドリルダウンして、改善のためのアクションを実行します。
• ソフトウェア開発ライフサイクル（SDLC）へのAIの追加の影響を理解し、GitLab Duoへの投資のROIを実証します。

クリックスルーデモについては、バリューストリーム管理製品ツアーを参照してください。

Value Streams Dashboardをグループの分析ダッシュボードとして表示するには、次のようにします:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
2. 分析 > 分析ダッシュボードを選択します。
3. 使用可能なダッシュボードのリストから、バリューストリームダッシュボードを選択します。

パネル

Value Streams Dashboardパネルにはデフォルトの設定がありますが、ダッシュボードパネルをカスタマイズすることもできます。

概要

概要パネルは、主要なDevOpsメトリクスを視覚化することにより、トップレベルネームスペースのアクティビティーの全体像を提供します。パネルには、次のメトリクスが表示されます:

• サブグループ
• プロジェクト
• ユーザー
• イシュー
• マージリクエスト
• パイプライン

概要パネルに表示されるデータは、バッチ処理によって収集されます。GitLabは、データベース内の各サブグループのレコード数を格納し、レコード数を集計して、トップレベルのメトリクスを提供します。データは毎月、月末頃に、GitLabシステムの負荷に応じて、可能な限り集計されます。

詳細については、エピック10417を参照してください。

DevSecOpsメトリクスの比較

DevSecOpsメトリクス比較パネルには、過去6か月間のグループまたはプロジェクトのメトリクスが表示されます。これらのビジュアライゼーションは、主要なDevSecOpsメトリクスが前月比で改善されているかどうかを理解するのに役立ちます。Value Stream Dashboardには、3つのDevSecOpsメトリクス比較パネルが表示されます:

• ライフサイクルメトリクス
• DORAメトリクス（Ultimateのみ）
• セキュリティメトリクス（Ultimateのみ、少なくともデベロッパーロール）

各比較パネルでは、次のことができます:

• グループ、プロジェクト、チーム間のパフォーマンスをひとめで比較します。
• 最大のバリューストリームコントリビューター、オーバーパフォームしている、またはアンダーパフォームしているチームとプロジェクトを特定します。
• 詳細な分析のためにメトリクスをドリルダウンします。

メトリクスにカーソルを合わせると、メトリクスの説明と、関連するドキュメントページへのリンクがツールチップに表示されます。

**Change %**列は、前月からのメトリクス値の増加または減少率も示します（6か月前と比較）。

トレンド列にはスパークラインが表示され、時間の経過に伴うメトリクスのトレンドのパターンを識別するのに役立ちます。スパークラインの色は青から緑の範囲で、緑は正のトレンドを示し、青は負のトレンドを示します。

DORAパフォーマーズスコア

DORAパフォーマーズスコアパネルは、グループレベルの棒チャートであり、組織のDevOpsパフォーマンスレベルのステータスを、最後の完全なカレンダー月のさまざまなプロジェクト全体で視覚化します。

このチャートは、プロジェクトのDORAスコアの内訳であり、高、中、または低として分類されています。このチャートは、グループ内のすべての子プロジェクトを集計します。

このチャートのバーには、スコアカテゴリごとのプロジェクトの合計数が表示され、毎月計算されます。チャートからデータ（たとえば、含まれていません）を除外するには、凡例で除外するシリーズを選択します。各バーにカーソルを合わせると、スコアの定義を説明するダイアログが表示されます。

たとえば、プロジェクトのデプロイ頻度（開発速度）が高い場合、そのプロジェクトは1日に1回以上本番環境にデプロイしていることを意味します。

詳細については、ブログ投稿「GitLab Value Streams DashboardのDORAパフォーマーズスコアの内側」を参照してください。

プロジェクトトピックでパネルをフィルタリングする

YAML設定ファイルでダッシュボードをカスタマイズすると、割り当てられたトピックで表示されるプロジェクトをフィルタリングできます。

panels:
  - title: 'My dora performers scores'
    visualization: dora_performers_score
    queryOverrides:
      namespace: group/my-custom-group
      filters:
        projectTopics:
          - JavaScript
          - Vue.js

複数のトピックが指定されている場合、プロジェクトが結果に含まれるためには、すべてのトピックが一致する必要があります。

DORAメトリクス別のプロジェクト

Projects by DORA metric（DORAメトリクス別のプロジェクト）パネルは、プロジェクト全体の組織のDevOpsパフォーマンスレベルのステータスをリストするグループレベルのテーブルです。

このテーブルには、グループおよびサブグループの子プロジェクトからデータを集計して、すべてのプロジェクトがDORAメトリクスとともにリストされます。このメトリクスは、最後の完全なカレンダー月について集計されます。

メトリクス値でプロジェクトをソートして、パフォーマンスの高いプロジェクト、中程度のパフォーマンスのプロジェクト、およびパフォーマンスの低いプロジェクトを特定できます。さらに調査するために、プロジェクト名を選択して、そのプロジェクトのページにドリルダウンできます。

概要バックグラウンド集計の有効化または無効化

Value Streams Dashboardの概要カウント集計を有効または無効にするには:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。このグループはトップレベルにある必要があります。
2. 設定 > 分析を選択します。
3. バリューストリームダッシュボードで、バリューストリームダッシュボードの概要画面のバックグラウンドでの集計を有効にするの概要画面のバックグラウンドでの集計を有効にする]チェックボックスを選択またはクリアします。

グループ内の集計された使用状況カウントを取得するには、GraphQL APIを使用します。

Value Streams Dashboardの表示

前提要件:

• グループまたはプロジェクトに対するレポーター以上のロールが必要です。
• 概要バックグラウンド集計を有効にする必要があります。
• 比較パネルでコントリビューター数のメトリクスを表示するには、ClickHouseを設定する必要があります。
• 本番環境へのデプロイを追跡するには、グループまたはプロジェクトに本番環境へのデプロイ階層の環境が必要です。
• サイクルタイムを測定するには、イシューがコミットメッセージからクロスリンクされている必要があります。

グループの場合

グループのValue Streams Dashboardを表示するには:

• 分析ダッシュボードから:

  1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
  2. 分析 > 分析ダッシュボードを選択します。

• バリューストリーム分析から:

  1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。
  2. 分析 > バリューストリーム分析を選択します。
  3. 結果をフィルタリングテキストボックスの下のライフサイクルメトリクス行で、Value Streams Dashboard / DORA（バリューストリームダッシュボード） / DORA]を選択します。
  4. オプション。新しいページを開くには、このパス/analytics/dashboards/value_streams_dashboardをグループURL（たとえば、https://gitlab.com/groups/gitlab-org/-/analytics/dashboards/value_streams_dashboard）に追加します。

プロジェクトの場合

Value Streams Dashboardをプロジェクトの分析ダッシュボードとして表示するには:

1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
2. 分析 > 分析ダッシュボードを選択します。
3. 使用可能なダッシュボードのリストから、バリューストリームダッシュボードを選択します。

レポートのスケジュール

CI/CDコンポーネントバリューストリームダッシュボードスケジュールされたレポートツールを使用して、レポートをスケジュールできます。このツールを使用すると、関連データを含む適切なダッシュボードを手動で検索する必要がなくなるため、時間と労力を節約し、インサイトの分析に集中できます。レポートをスケジュールすることで、組織の意思決定者が、プロアクティブでタイムリーかつ関連性の高い情報を受け取ることができるようにします。

スケジュールされたレポートツールは、パブリックGitLab GraphQL APIを介してプロジェクトまたはグループからメトリクスを収集し、GitLab Flavored Markdownを使用してレポートをビルドし、指定されたプロジェクトでイシューを開きます。このイシューには、Markdown形式の比較メトリクステーブルが含まれています。

スケジュールされたレポートの例を参照してください。詳細については、ブログ記事「新しいスケジュールされたレポート生成ツールがバリューストリーム管理を簡素化」を参照してください。

ダッシュボードパネルのカスタマイズ

Value Streams Dashboardをカスタマイズして、ページに含めるサブグループとプロジェクトを設定できます。

ページのデフォルトコンテンツをカスタマイズするには、選択したプロジェクトでYAML設定ファイルを作成する必要があります。このファイルでは、タイトル、説明、パネル数など、さまざまな設定とパラメータを定義できます。このファイルは、スキーマ駆動型であり、Gitなどのバージョン管理システムで管理されます。これにより、設定変更の履歴の追跡と維持、必要に応じて以前のバージョンへの復元、およびチームメンバーとの効果的なコラボレーションが可能になります。クエリパラメータを使用して、YAML設定をオーバーライドすることもできます。

ダッシュボードパネルをカスタマイズする前に、YAML設定ファイルを格納するプロジェクトを選択する必要があります。

前提要件:

• グループのメンテナーロール以上を持っている必要があります。

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
2. 設定 > 分析を選択します。
3. YAML設定ファイルを保存するプロジェクトを選択します。
4. 変更を保存を選択します。

プロジェクトを設定したら、設定ファイルを設定します:

1. 左側のサイドバーで、検索または移動先を選択し、前の手順で選択したプロジェクトを見つけます。
2. デフォルトのブランチに、設定ファイル.gitlab/analytics/dashboards/value_streams/value_streams.yamlを作成します。
3. value_streams.yaml設定ファイルで、設定オプションを入力します:

# version - The latest version of the analytics dashboard schema
version: '2'

# title - Change the title of the Value Streams Dashboard.
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.
#   visualization - The type of visualization to be rendered
#   gridAttributes - The size and positioning of the panel
#   queryOverrides.namespace - The Group or Project path to use for the chart panel
#   queryOverrides.filters.excludeMetrics - Hide rows by metric ID from the chart panel.
panels:
  - title: 'Group usage overview'
    visualization: usage_overview
    queryOverrides:
      namespace: group
      filters:
        include:
          - groups
          - projects
    gridAttributes:
      yPos: 1
      xPos: 1
      height: 1
      width: 12
  - title: 'Group dora and issue metrics'
    visualization: ai_impact_table
    queryOverrides:
      namespace: group
      filters:
        excludeMetrics:
          - deployment_frequency
          - deploys
    gridAttributes:
      yPos: 2
      xPos: 1
      height: 12
      width: 12
  - title: 'My dora performers scores'
    visualization: dora_performers_score
    queryOverrides:
      namespace: group/my-project
      filters:
        projectTopics:
          - ruby
          - javascript
    gridAttributes:
      yPos: 26
      xPos: 1
      height: 12
      width: 12

サポートされているビジュアライゼーションフィルター

queryOverridesフィールドのfiltersサブフィールドを使用して、パネルに表示されるデータをカスタマイズできます。

DevSecOpsメトリクス比較パネルフィルター

ai_impact_tableビジュアライゼーションのフィルター。

DORAパフォーマーズスコアパネルフィルター

dora_performers_scoreビジュアライゼーションのフィルター。

使用状況の概要パネルフィルター

usage_overviewビジュアライゼーションのフィルター。

グループおよびサブグループのネームスペース

プロジェクトネームスペース

追加のパネルフィルター（非推奨）

dora_chartの可視化のためのフィルター。

ダッシュボードのメトリクスとドリルダウンレポート

次の表は、バリューストリームダッシュボードで利用可能なメトリクスの概要と、説明、ドリルダウンレポートの名前を示しています。

Jiraとのメトリクス

次のメトリクスは、Jiraの使用に依存しません:

• デプロイ頻度
• 変更のリードタイム
• デプロイ数
• マージリクエストスループット
• マージまでの中央値時間
• 脆弱性