값 스트림 대시보드

Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
  • GitLab 15.8에서 group_analytics_dashboards_page라는 플래그로 닫힌 베타 기능으로 소개되었습니다. 기본적으로 비활성화됨.
  • GitLab 15.11에서 group_analytics_dashboards_page라는 플래그로 열린 베타 기능으로 출시되었습니다. 기본적으로 활성화됨.
  • GitLab 16.0에서 일반 사용 가능합니다. group_analytics_dashboards_page 기능 플래그가 제거됨.

값 스트림 대시보드를 개선하기 위해 조사에서 사용자 경험에 대한 피드백을 공유해 주세요. 자세한 정보는 값 스트림 관리 범주 방향 페이지를 참조하십시오.

값 스트림 대시보드는 디지털 변형 개선의 추세, 패턴 및 기회를 식별하는 데 사용할 수 있는 사용자 정의 대시보드입니다. 값 스트림 대시보드의 중앙 집중형 UI는 모든 이해 관계자가 조직과 관련 있는 동일한 메트릭 세트를 액세스하고 볼 수 있는 단일 정보원(SSOT) 역할을 합니다. 값 스트림 대시보드에는 다음과 같은 메트릭을 시각화하는 패널이 포함되어 있습니다.

값 스트림 대시보드를 사용하면 다음을 수행할 수 있습니다.

  • 시간 경과에 따라 위의 메트릭을 추적하고 비교합니다.
  • 조기에 하락하는 추세를 식별합니다.
  • 보안 노출을 이해합니다.
  • 개별 프로젝트나 메트릭으로 드릴다운하여 개선 조치를 취합니다.
  • 소프트웨어 개발 수명주기(SDLC)에 AI를 추가한 영향을 이해하고 GitLab Duo에 대한 투자의 수익성을 증명합니다.

클릭을 통한 데모는 값 스트림 관리 제품 투어에서 확인할 수 있습니다.

참고: 값 스트림 대시보드에서 표시되는 데이터는 백엔드에서 지속적으로 수집됩니다. 얼티밋 티어로 업그레이드하면 과거 GitLab 사용 및 성능에 대한 메트릭에 액세스할 수 있으며 과거 데이터를 볼 수 있습니다.

값 스트림 대시보드 패널

값 스트림 대시보드 패널은 기본 구성이 있지만 대시보드 패널을 사용자 정의할 수도 있습니다. 값 스트림 대시보드에는 네 가지 패널이 포함되어 있습니다.

  • 개요
  • DevSecOps 메트릭 비교
  • DORA Performers 점수

개요 패널

  • GitLab 16.7에서 group_analytics_dashboard_dynamic_vsd라는 플래그와 함께 소개되었습니다. 기본적으로 비활성화됨.
  • GitLab 17.0에서 일반 사용 가능합니다.
  • GitLab 17.0에서 group_analytics_dashboard_dynamic_vsd 플래그가 제거되었습니다.

개요 패널은 주요 DevOps 메트릭을 시각화함으로써 상위 네임스페이스의 활동에 대한 전체적인 개요를 제공합니다. 패널에는 다음을 위한 메트릭이 표시됩니다.

  • 서브그룹
  • 프로젝트
  • 사용자
  • 이슈
  • 병합 요청
  • 파이프라인

개요 패널에 표시되는 데이터는 일괄 처리 방식으로 수집됩니다. GitLab은 각 서브그룹에 대해 데이터베이스에 레코드 수를 저장한 다음 이를 집계하여 상위 그룹의 메트릭을 제공합니다. 데이터는 월별로, 월 말에 또는 GitLab 시스템의 부하에 따라 최선을 다해 집계됩니다.

자세한 정보는 epic 10417를 참조하십시오.

참고: 개요 패널에서 메트릭을 보려면 백그라운드 집계가 활성화되어 있어야 합니다.

DevSecOps 메트릭 비교 패널

  • Contributor count metric at the group level이 GitLab 16.9에서 GitLab.com에 소개되었습니다.

DevSecOps 메트릭 비교는 지난 한 달, 지난 달, 그 전 달, 지난 180일 동안 그룹이나 프로젝트의 DORA4, 취약점 및 흐름 메트릭을 표시합니다. 이 시각화를 통해 주요 DevSecOps 메트릭이 달 별로 개선되는지 이해할 수 있습니다.

비교 패널에서는 다음을 수행할 수 있습니다.

  • 한눈에 그룹, 프로젝트 및 팀 간의 성능을 비교합니다.
  • 가장 큰 가치 기여자, 과도한 성과, 미흡한 성과를 식별합니다.
  • 추가 분석을 위해 메트릭을 드릴 다운합니다.

메트릭 위로 마우스를 올리면 메트릭 설명과 관련 문서 페이지로 이어지는 링크가 포함된 툴팁이 표시됩니다.

월별 값은 지난 달과 비교하여 백분율 증감을 나타냅니다.

지난 6개월간의 스파크라인은 시간에 따른 가치 추세를 나타내며 백분율 증감률이 아닙니다. 스파크라인의 색깔은 양(+)/음(-)의 추세를 나타내는데, 녹색은 긍정적 추세를, 파란색은 부정적 추세를 나타냅니다. 스파크라인을 통해 시간에 따른 메트릭 추세의 패턴(계절적 변화 등)을 식별할 수 있습니다.

라벨로 DevSecOps 메트릭 비교 패널 필터링

라벨 필터는 각 적격한 메트릭의 드릴 다운 보고서 URL에 쿼리 매개변수로 추가되어 자동으로 적용됩니다. 구성 파일의 비교 패널이 filters.labels로 활성화된 경우, 드릴 다운 링크는 패널 필터에서 라벨을 상속합니다. 

panels:
  - title: "Group dora and issue metrics"
    visualization: dora_chart
    queryOverrides:
      namespace: my-dora-group
      filters:
        labels:
          - in_development
          - in_review

DORA Performers 점수 패널

  • GitLab 16.3에서 dora_performers_score_panel이라는 플래그로 소개되었습니다. 기본적으로 비활성화됨.
  • GitLab 16.9에서 GitLab.com에서 활성화되었습니다.
  • GitLab 16.11에서 일반 사용 가능합니다. dora_performers_score_panel 기능 플래그가 제거됨.

DORA Performers 점수 패널은 지난 달 동안 프로젝트별로 조직의 DevOps 성능 수준을 시각화하는 그룹 수준 막대 차트입니다.

차트는 프로젝트의 DORA 점수를 높음, 보통, 낮음으로 분류하여 보여줍니다. 차트는 그룹의 모든 하위 프로젝트를 집계합니다.

차트 막대는 월별로 계산된 각 점수 범주별 전체 프로젝트 수를 표시합니다. 차트에서 데이터를 제외하려면(예: 포함되지 않음), 범례에서 제외하려는 시리즈를 선택하십시오. 각 막대를 가리키면 점수 정의를 설명하는 대화 상자가 표시됩니다.

예를 들어, 배포 빈도(속도)에 대한 높은 점수가 있는 프로젝트는 하루에 한 번 이상의 프로덕션 배포가 있다는 것을 의미합니다.

메트릭 설명 높음 보통 낮음
배포 빈도 하루에 프로덕션에 배포하는 회수 ≥30 1-29 <1
변경 사항에 대한 리드 타임 코드 커밋부터 프로덕션에서 성공적으로 실행되는 데 걸리는 일수 ≤7 8-29 ≥30
서비스 복구 시간 사용자에 영향을 미치는 서비스 이슈 또는 결함이 발생했을 때 서비스를 복원하는 데 걸리는 일수 ≤1 2-6 ≥7
변경 실패율 프로덕션에 변경한 사항 중 서비스 저하로 이어진 비율 ≤15% 16%-44% ≥45%

프로젝트 주제별로 DORA 퍼포머 점수 필터링

YAML 구성을 사용하여 대시보드를 사용자 정의할 때 주제로 할당된 프로젝트를 필터링할 수 있습니다. 

panels:
  - title: "내 DORA 퍼포머 점수"
    visualization: dora_performers_score
    queryOverrides:
      namespace: group/my-custom-group
      filters:
        projectTopics:
          - JavaScript
          - Vue.js

여러 주제를 제공하는 경우 프로젝트가 결과에 포함되려면 모든 주제가 일치해야 합니다.

개요 배경 집계 활성화 또는 비활성화

Tier: Ultimate Offering: Self-managed, GitLab Dedicated

Value Streams 대시보드의 개요 집계 활성화 또는 비활성화하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 상위 그룹을 찾습니다.
  2. 설정 > 분석을 선택합니다.
  3. Value Streams Dashboard에서 Value Streams 대시보드의 개요 배경 집계 활성화 확인란을 선택하거나 선택 해제합니다.

그룹에서 집계된 사용량 카운트를 검색하려면 GraphQL API를 사용합니다.

Value Streams 대시보드 보기

필수 구성 요소:

  • 그룹에 대해 적어도 리포터 역할이 있어야 합니다.
  • Value Streams 대시보드의 개요 배경 집계가 활성화되어 있어야 합니다.
  • 비교 패널에서 기여자 카운트 메트릭을 보려면 ClickHouse를 설정해야 합니다.

Value Streams 대시보드를 보려면:

  • 분석 대시보드에서:

    1. 그룹 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
    2. 분석 > 분석 대시보드를 선택합니다.

  • Value Stream Analytics에서:

    1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
    2. 분석 > Value stream analytics를 선택합니다.
    3. 결과 필터 텍스트 상자 아래 Lifecycle metrics 행에서 Value Streams Dashboard / DORA를 선택합니다.
    4. 선택 사항. 새 페이지를 열려면 이 경로(/analytics/dashboards/value_streams_dashboard)를 그룹 URL에 추가합니다(예: https://gitlab.com/groups/gitlab-org/-/analytics/dashboards/value_streams_dashboard).

프로젝트용 Value Streams 대시보드 보기

필수 구성 요소:

  • 프로젝트에 대해 적어도 리포터 역할이 있어야 합니다.
  • Value Streams 대시보드의 개요 배경 집계가 활성화되어 있어야 합니다.

프로젝트용 분석 대시보드로 Value Streams 대시보드를 보려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 분석 > 분석 대시보드를 선택합니다.
  3. 제공되는 대시보드 목록에서 Value Streams Dashboard를 선택합니다.

Value Streams 대시보드 보고서 예약

CI/CD 구성요소인 Value Streams 대시보드 예약 보고 도구를 사용하여 보고서를 예약할 수 있습니다. 이 도구를 사용하면 관련 데이터를 포함한 적절한 대시보드를 수동으로 검색할 필요 없이 시간과 노력을 절약하여 분석에 집중할 수 있습니다. 보고서를 예약하여 조직의 의사 결정자가 적극적이고 적시에 관련 정보를 수신할 수 있습니다.

예약된 보고서 도구는 공개 GitLab GraphQL API를 통해 프로젝트 또는 그룹에서 메트릭을 수집한 다음 GitLab Flavored Markdown을 사용하여 보고서를 작성하고 지정된 프로젝트에 이슈를 엽니다. 이슈에는 Markdown 형식의 비교 메트릭 테이블이 포함됩니다.

예약 보고서 예시를 참조하세요. 자세한 내용은 블로그 글 새로운 예약 보고서 생성 도구로 Value Stream 관리를 간소화를 참조하세요.

대시보드 패널 사용자 정의

Value Streams 대시보드를 사용자 정의하고 페이지에 포함할 서브그룹 및 프로젝트를 구성할 수 있습니다.

대시보드 페이지의 기본 콘텐츠를 사용자 정의하기 전에 YAML 구성 파일을 선택한 프로젝트에 만들어야 합니다. 이 파일에서 제목, 설명, 패널 및 레이블 필터 수와 같은 여러 설정 및 매개변수를 정의할 수 있습니다. 이 파일은 스키마 기반으로 관리 및 추적되며 Git과 같은 버전 관리 시스템으로 관리됩니다. 필요할 경우 이전 버전으로 되돌리기도 하고 팀원과 협력할 수도 있습니다. YAML 구성을 재정의하는 쿼리 매개변수도 사용할 수 있습니다.

대시보드 패널을 사용자 정의하기 전에 YAML 구성 파일을 저장할 프로젝트를 선택해야 합니다.

필수 구성 요소:

  • 그룹에 대해 적어도 메인테이너 역할이 있어야 합니다.
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 분석을 선택합니다.
  3. YAML 구성 파일을 저장하려는 프로젝트를 선택합니다.
  4. 변경 사항 저장을 선택합니다.

프로젝트를 설정한 후 구성 파일을 설정합니다.

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 이전 단계에서 선택한 프로젝트를 찾습니다.
  2. 기본 브랜치에서 구성 파일을 생성합니다: .gitlab/analytics/dashboards/value_streams/value_streams.yaml.
  3. value_streams.yaml 구성 파일에 구성 옵션을 작성합니다.
필드 설명
title 패널의 사용자 정의 이름
queryOverrides (이전에 data) 각 시각화에 특정한 데이터 쿼리 매개변수를 재정의합니다.
namespace (queryOverrides의 하위 필드) 패널에 사용할 그룹 또는 프로젝트 경로
filters (queryOverrides의 하위 필드) 각 시각화 유형에 대한 쿼리 필터링. 지원되는 시각화를 참조하세요.
visualization 렌더링할 시각화 유형. 지원되는 옵션은 dora_chart, dora_performers_score, usage_overview입니다.
gridAttributes 패널의 크기와 위치
xPos (gridAttributes의 하위 필드) 패널의 가로 위치
yPos (gridAttributes의 하위 필드) 패널의 세로 위치
width (gridAttributes의 하위 필드) 패널의 너비(최대 12)
height (gridAttributes의 하위 필드) 패널의 높이 
# version - 대시보드 스키마의 최신 버전
version: "2"

# title - Value Streams 대시보드의 사용자 정의 이름
title: "사용자 정의 대시보드 제목"

# description - Value Streams 대시보드의 설명 변경(선택 사항)
description: "사용자 정의 설명"

# panels - 패널 설정을 포함하는 패널 목록
#   title - 패널의 사용자 정의 이름
#   visualization - 렌더링할 시각화 유형
#   gridAttributes - 패널의 크기와 위치
#   queryOverrides.namespace - 차트 패널에 사용할 그룹 또는 프로젝트 경로
#   queryOverrides.filters.excludeMetrics - 차트 패널에서 메트릭 ID에 의해 행 숨기기
#   queryOverrides.filters.labels -
#     쿼리된 레이블과 일치하는 데이터만 표시합니다. 여러 레이블을 제공하는 경우 해당 데이터가 결과에 포함되려면 단일 레이블만 일치하면 됩니다.
#     호환되는 메트릭(다른 메트릭은 자동으로 제외됨):
#       * 리드 타임
#       * 사이클 타임
#       * 이슈
#       * 완료된 이슈
#       * 머지 요청 처리량
panels:
  - title: "그룹 사용 개요"
    visualization: usage_overview
    queryOverrides:
      namespace: group
      filters:
        include:
          - 그룹
          - 프로젝트
    gridAttributes:
      yPos: 1
      xPos: 1
      height: 1
      width: 12
  - title: "그룹 DORA 및 이슈 메트릭"
    visualization: dora_chart
    queryOverrides:
      namespace: group
      filters:
        excludeMetrics:
          - 배포 빈도
          - 배포
        labels:
          - in_development
          - in_review
    gridAttributes:
      yPos: 2
      xPos: 1
      height: 12
      width: 12
  - title: "내 DORA 퍼포머 점수"
    visualization: dora_performers_score
    queryOverrides:
      namespace: group/my-project
      filters:
        projectTopics:
          - ruby
          - javasript
    gridAttributes:
      yPos: 26
      xPos: 1
      height: 12
      width: 12

### 지원되는 시각화 필터

`queryOverrides` 필드의 `filters` 하위 필드를 사용하여 패널에 표시된 데이터를 사용자 정의할 수 있습니다.

#### DevSecOps 지표 비교 패널 필터

`dora_chart` 시각화를 위한 필터입니다.

|필터|설명|지원되는 값|
|---|---|---|
|`excludeMetrics`|차트 패널에서 메트릭 ID별로 행을 숨김| `deployment_frequency`, `lead_time_for_changes`,`time_to_restore_service`, `change_failure_rate`, `lead_time`, `cycle_time`, `issues`, `issues_completed`, `deploys`, `merge_request_throughput`, `median_time_to_merge`, `contributor_count`, `vulnerability_critical`, `vulnerability_high`|
| `labels` | 레이블별 데이터 필터링 | 사용 가능한 그룹 레이블. 레이블 필터링은 다음 메트릭에서 지원됩니다: `lead_time`, `cycle_time`, `issues`, `issues_completed`, `merge_request_throughput`, `median_time_to_merge`. |

#### DORA Performers 점수 패널 필터

`dora_performers_score` 시각화를 위한 필터입니다.

|필터|설명|지원되는 값|
|---|---|---|
|`projectTopics`|할당된 [topics](../project/project_topics.md)에 따라 표시되는 프로젝트 필터링| 사용 가능한 그룹 토픽|

#### 사용 개요 패널 필터

`usage_overview` 시각화를 위한 필터입니다.

##### 그룹 및 하위 그룹 네임스페이스

|필터|설명|지원되는 값|
|---|---|---|
|`include`|기본적으로 모든 사용 가능 항목을 표시하는 데 반환되는 메트릭을 제한함| `groups`, `projects`, `issues`, `merge_requests`, `pipelines`, `users`|

##### 프로젝트 네임스페이스

|필터|설명|지원되는 값|
|---|---|---|
|`include`|기본적으로 모든 사용 가능 항목을 표시하는 데 반환되는 메트릭을 제한함| `issues`, `merge_requests`, `pipelines`|

## 대시보드 지표 및 드릴다운 보고서

| 지표 | 설명 | 드릴다운 보고서 | 문서 페이지 | ID |
| ------ | ----------- | --------------- | ------------------ | -- |
| 배포 주기 | 하루에 프로덕션으로의 평균 배포 횟수. 이 지표는 가치를 최종 사용자에게 전달하는 빈도를 측정합니다. | [배포 주기 탭](https://gitlab.com/groups/gitlab-org/-/analytics/ci_cd?tab=deployment-frequency) | [배포 주기](dora_metrics.md#deployment-frequency) | `deployment_frequency` |
| 변경 사항의 리드타임 | 커밋을 프로덕션으로 성공적으로 전달하는 데 걸리는 시간. 이 지표는 CI/CD 파이프라인의 효율성을 반영합니다. | [리드타임 탭](https://gitlab.com/groups/gitlab-org/-/analytics/ci_cd?tab=lead-time) | [변경 사항의 리드타임](dora_metrics.md#lead-time-for-changes) | `lead_time_for_changes` |
| 서비스 복구 시간 | 조직이 프로덕션에서의 장애로부터 복구하는 데 걸리는 시간. | [서비스 복구 시간 탭](https://gitlab.com/groups/gitlab-org/-/analytics/ci_cd?tab=time-to-restore-service) | [서비스 복구 시간](dora_metrics.md#time-to-restore-service) | `time_to_restore_service` |
| 변경 실패율 | 프로덕션에서 사고를 일으키는 배포의 백분율. | [변경 실패율 탭](https://gitlab.com/groups/gitlab-org/-/analytics/ci_cd?tab=change-failure-rate) | [변경 실패율](dora_metrics.md#change-failure-rate) | `change_failure_rate` |
| 리드타임 | 이슈 생성에서 이슈 종료까지의 중간 시간. | [Value Stream Analytics](https://gitlab.com/groups/gitlab-org/-/analytics/value_stream_analytics) | [이슈의 리드타임 및 사이클 타임 보기](../group/value_stream_analytics/index.md#lifecycle-metrics) | `lead_time` |
| 사이클 타임 | 문제의 병합 요청으로부터 이슈가 종료될 때까지의 중간 시간. | [VSA 개요](https://gitlab.com/groups/gitlab-org/-/analytics/value_stream_analytics) | [이슈의 리드타임 및 사이클 타임 보기](../group/value_stream_analytics/index.md#lifecycle-metrics) | `cycle_time` |
| 생성된 이슈 | 생성된 새 이슈의 수. | [이슈 분석](https://gitlab.com/groups/gitlab-org/-/issues_analytics) | [이슈 분석](../../user/group/issues_analytics/index.md) | `issues` |
| 종료된 이슈 | 월별 종료된 이슈 수. | [이슈 분석](https://gitlab.com/groups/gitlab-org/-/issues_analytics) | [이슈 분석](../../user/group/issues_analytics/index.md) | `issues_completed` |
| 배포 횟수 | 프로덕션으로 배포된 총 횟수. | [병합 요청 분석](https://gitlab.com/gitlab-org/gitlab/-/analytics/merge_request_analytics) | [병합 요청 분석](merge_request_analytics.md) | `deploys` |
| 병합 요청 처리량 | 월별 병합 요청 수. | [그룹 생산성 분석](productivity_analytics.md), [프로젝트 병합 요청 분석](https://gitlab.com/gitlab-org/gitlab/-/analytics/merge_request_analytics)  | [그룹 생산성 분석](productivity_analytics.md) [프로젝트 병합 요청 분석](merge_request_analytics.md) | `merge_request_throughput` |
| 병합까지의 중앙 시간 | 병합 요청 생성부터 병합 요청이 병합될 때까지의 중앙 시간. | [그룹 생산성 분석](productivity_analytics.md), [프로젝트 병합 요청 분석](https://gitlab.com/gitlab-org/gitlab/-/analytics/merge_request_analytics)  | [그룹 생산성 분석](productivity_analytics.md) [프로젝트 병합 요청 분석](merge_request_analytics.md) | `median_time_to_merge` |
| 기여자 수 | 그룹에서 매월 고유 사용자의 기여 횟수.| [기여 분석](https://gitlab.com/groups/gitlab-org/-/contribution_analytics) | [사용자 기여 이벤트](../profile/contributions_calendar.md#user-contribution-events) | `contributor_count` |
| 시간당 심각한 취약점 | 프로젝트 또는 그룹의 시간당 심각한 취약점 수 | [취약점 보고서](https://gitlab.com/gitlab-org/gitlab/-/security/vulnerability_report) | [취약점 보고서](../application_security/vulnerability_report/index.md) | `vulnerability_critical` |
| 시간당 높은 취약점 | 프로젝트 또는 그룹의 시간당 높은 취약점 수 | [취약점 보고서](https://gitlab.com/gitlab-org/gitlab/-/security/vulnerability_report) | [취약점 보고서](../application_security/vulnerability_report/index.md) | `vulnerability_high` |

## Jira와 함께 사용되는 가치 스트림 대시보드 지표

다음 지표들은 Jira를 사용에 따라 달라지지 않습니다:

- DORA 배포 빈도
- DORA 변경의 리드 타임
- 배포 횟수
- 병합 요청 처리량
- 병합까지의 중앙값 시간
- 취약점