가치 스트림 대시보드

Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
  • GitLab 15.8에서 사용 중단된 Beta 기능인 ‘group_analytics_dashboards_page’라는 플래그와 함께 도입되었습니다(기본적으로 비활성화).
  • 기본적으로 활성화된 상태로, GitLab 15.11에서 ‘group_analytics_dashboards_page’라는 플래그를 사용 중단된 Beta 기능으로 발표되었습니다.
  • GitLab 16.0에서 일반적으로 이용 가능 합니다. ‘group_analytics_dashboards_page’ 플래그가 제거되었습니다.

가치 스트림 대시보드를 개선하는 데 도움을 주시려면 여기에서 경험에 대한 피드백을 공유해 주세요. 자세한 내용은 가치 스트림 관리 범주 방향 페이지를 참조하세요.

가치 스트림 대시보드는 디지털 변환 향상을 위한 트렌드, 패턴 및 기회를 식별하는 데 사용할 수 있는 사용자 정의 대시보드입니다. 가치 스트림 대시보드의 중앙 집중화된 UI는 모든 이해관계자가 조직에 관련된 동일한 측정 항목 집합에 액세스하고 보는 데 사용되는 진실의 단일 소스(SSOT) 역할을 합니다.

가치 스트림 대시보드에는 다음과 같은 지표를 시각화하는 두 가지 패널(DevSecOps 지표 비교 및 DORA 실현 점수)가 포함되어 있습니다:

가치 스트림 대시보드를 사용하면 다음을 할 수 있습니다:

  • 정해진 기간 동안 위의 지표를 추적하고 비교합니다.
  • 조기에 하락하는 경향을 식별합니다.
  • 보안 노출을 이해합니다.
  • 개별 프로젝트나 지표를 분석하여 개선 조치를 취합니다.

참고: 가치 스트림 대시보드에 표시된 데이터는 백엔드에서 지속적으로 수집됩니다. Ultimate 티어로 업그레이드하면 과거 GitLab 사용 및 성능에 대한 기록을 확인할 수 있으며 이전 데이터에 대한 지표를 볼 수 있습니다.

가치 스트림 대시보드 패널

가치 스트림 대시보드 패널은 기본 구성이 있지만 대시보드 패널을 사용자 정의할 수도 있습니다.

DevSecOps 지표 비교 패널

  • GitLab 16.9에 기여자 수 지표가 추가되었습니다.

DevSecOps 지표 비교는 그룹이나 프로젝트에 대한 DORA4, 취약점 및 흐름 지표를 월간 기준, 지난 달, 그 전 달 및 지난 180일 동안 표시합니다.

이 시각화를 통해 여러 DevOps 지표에 대한 고수준의 사용자 정의된 보기를 얻을 수 있으며, 매월 개선되었는지 이해할 수 있습니다. 그룹, 프로젝트 및 팀 간에 성능을 한눈에 비교할 수 있습니다. 이 시각화를 통해 가장 큰 가치 기여자, 과도한 성능 또는 성능이 부족한 팀 및 프로젝트를 식별할 수 있습니다.

DevOps 지표 비교

또한, 추가 분석을 위해 지표를 자세히 살펴볼 수 있습니다. 지표 위로 마우스를 가져가면 지표에 대한 설명과 관련 문서 페이지로 이동하는 링크가 표시됩니다.

월간 값은 이전 달과 비교하여 증감률을 나타냅니다.

지난 6개월 동안의 선 긋기는 값의 추세를 나타내며, 증가율을 나타내는 것이 아닙니다. 선 긋기 색깔은 청에서 녹색으로, 녹색이 긍정적인 추세를 나타내고, 청색이 부정적인 추세를 나타냅니다. 선 긋기를 통해 시간이 지남에 따른 지표 추세(계절적 변화와 같은)를 식별할 수 있습니다.

참고: 기여자 수 지표는 그룹 수준에서만 GitLab.com에서 사용할 수 있습니다. 비교 패널에서 이 지표를 보려면 ClickHouse를 설정하고 기능 플래그 ‘clickhouse_data_collection’ 및 ‘event_sync_worker_for_click_house’를 활성화해야 합니다.

DORA 성취 점수 패널

플래그: Self-managed GitLab에서는 이 기능이 기본적으로 활성화되어 있습니다. 이 기능을 숨기려면 관리자가 dora_performers_score_panel이라는 기능 플래그를 비활성화해야 합니다. GitLab Dedicated의 경우에는 이 기능이 사용할 수 있습니다.

DORA 지표 성취 점수 패널은 조직의 DevOps 성능 수준을 다른 프로젝트 간에 시각화한 막대 차트입니다.

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

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

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

지표 설명 높음 중간 낮음
배포 빈도 하루에 프로덕션으로의 배포 횟수 ≥30 1-29 <1
변경 사항 리드타임 코드 커밋부터 성공적으로 프로덕션에서 실행되기까지 걸리는 날 수 ≤7 8-29 ≥30
서비스 복구 시간 서비스 이슈 또는 사용자에 영향을 미치는 결함이 발생했을 때 서비스를 복구하는 데 걸리는 날 수 ≤1 2-6 ≥7
변경 실패율 프로덕션에 대한 변경 사항 중 변화로 인해 서비스가 저하된 백분율 ≤15% 16%-44% ≥45%

이러한 점수는 Google의 DORA 2022 가속화 DevOps 보고서의 분류를 기반으로 합니다.

프로젝트 주제로 DORA Performers 점수 필터링

YAML 구성을 사용하여 할당된 주제에 따라 표시되는 프로젝트를 필터링할 수 있습니다.

panels:
  - data:
      namespace: group/my-custom-group
      filter_project_topics:
        - JavaScript
        - Vue.js

여러 주제가 제공된 경우 모든 주제가 일치해야 결과에 포함됩니다.

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

세부 정보: Tier: Ultimate Offering: Self-managed, GitLab Dedicated

Value Stream 대시보드의 개요 집계를 활성화하거나 비활성화하려면 다음을 수행하세요:

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

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

가치 스트림 대시보드 보기

필수 조건:

  • 그룹에 대해 적어도 리포터 역할이 있어야 합니다.
  • 가치 스트림 대시보드의 개요 배경 집계가 활성화되어 있어야 합니다.

가치 스트림 대시보드를 보려면:

  • 분석 대시보드에서:

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

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

또한 group 또는 project에 대한 분석 대시보드로 렌더링된 가치 스트림 대시보드를 볼 수 있습니다.

대시보드 패널 사용자 정의

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

쿼리 매개변수 사용

여러 개의 서브그룹 및 프로젝트를 표시하려면 URL 매개변수로 경로를 지정합니다.

예를 들어, 매개변수 query=gitlab-org/gitlab-ui,gitlab-org/plan-stage는 다음을 위한 개별 패널을 표시합니다:

  • gitlab-org 그룹
  • gitlab-ui 프로젝트
  • gitlab-org/plan-stage 서브그룹

YAML 구성 사용

페이지의 기본 콘텐츠를 사용자 정의하려면 원하는 프로젝트에 YAML 구성 파일을 생성해야 합니다. 이 파일에서 제목, 설명, 패널 및 레이블 필터 수 등과 같은 다양한 설정 및 매개변수를 정의할 수 있습니다. 이 파일은 스키마에 따라 관리되며 Git과 같은 버전 관리 시스템으로 관리됩니다. 이를 통해 필요한 경우 설정 변경 이력을 추적하고 유지, 필요한 경우 이전 버전으로 복귀하며 팀 구성원과 효과적으로 협업할 수 있습니다. 쿼리 매개변수는 YAML 구성을 무시하고 사용할 수 있습니다.

먼저 프로젝트를 설정해야 합니다.

필수 조건:

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

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 기본 브랜치에서 구성 파일을 생성합니다: .gitlab/analytics/dashboards/value_streams/value_streams.yaml.
  3. value_streams.yaml 구성 파일에서 구성 옵션을 입력합니다:
# title - 가치 스트림 대시보드의 제목을 변경합니다.
title: '사용자 정의 대시보드 제목'

# description - 가치 스트림 대시보드의 설명을 변경합니다. [선택 사항]
description: '사용자 정의 설명'

# panels - 패널 설정을 포함하는 패널 목록입니다.
#   title - 패널의 제목을 변경합니다. [선택 사항]
#   data.namespace - 차트 패널에 사용할 그룹 또는 프로젝트 경로입니다.
#   data.exclude_metrics - 차트 패널에서 메트릭 ID별로 숨기기.
#   data.filter_labels -
#     쿼리된 레이블과 일치하는 데이터에 대해서만 결과를 표시합니다. 여러 레이블이 제공된 경우 데이터 하나만 일치하면 됩니다.
#     호환되는 메트릭(다른 메트릭은 자동으로 제외됩니다):
#       * 리드 시간
#       * 주기 시간
#       * 이슈
#       * 완료된 이슈
#       * 병합 요청 처리량
panels:
  - title: ' 사용자 정의 프로젝트'
    data:
      namespace: group/my-custom-project
  - data:
      namespace: group/another-project
      filter_labels:
        - in_development
        - in_review
  - title: ' 사용자 정의 그룹'
    data:
      namespace: group/my-custom-group
      exclude_metrics:
        - deployment_frequency
        - change_failure_rate
  - data:
      namespace: group/another-group

다음 예는 my-group 네임스페이스에 대해 패널을 위한 옵션 설정을 보여줍니다:

  panels:
    - data:
        namespace: my-group

구성 파일에서 레이블 필터를 편집하는 개요에 대한 동영상을 보려면 GitLab Value Streams Dashboard - Label filters demo를 참조하십시오.

그룹 분석 대시 보드 스키마

self-managed GitLab의 경우 기본적으로 이 기능을 사용할 수 없습니다. 그룹 단위로 또는 전체 인스턴스에 대해 사용할 수 있도록 하려면 관리자가 group_analytics_dashboard_dynamic_vsd라는 특성 플래그를 활성화해야 합니다. GitLab.com의 경우 이 기능을 사용할 수 없습니다.

사용자 정의 분석 대시 보드로 가치 스트림 대시 보드 렌더링하려면 새로운 및 기존 YAML 스키마를 업데이트해야 합니다. 업데이트된 필드는 대시 보드 패널의 표시 및 레이아웃에 대해 더 많은 유연성을 제공합니다.

필드 설명
title 패널의 사용자 정의 이름
queryOverrides (이전에 data) 시각화별 데이터 쿼리 매개변수 재정의
namespace (queryOverrides의 하위 필드) 패널에 사용할 그룹 또는 프로젝트 경로
visualization 렌더링할 시각화 유형. 지원되는 옵션은 dora_chart, dora_performers_score, usage_overview입니다.
gridAttributes 패널의 크기 및 위치
xPos (gridAttributes의 하위 필드) 패널의 가로 위치
yPos (gridAttributes의 하위 필드) 패널의 세로 위치
width (gridAttributes의 하위 필드) 패널의 너비 (최대 12)
height (gridAttributes의 하위 필드) 패널의 높이
# title - 가치 스트림 대시 보드의 제목 변경 [옵션]
title: '사용자 정의 대시 보드 제목'

# description - 가치 스트림 대시 보드의 설명 변경 [옵션]
description: '사용자 정의 설명'

# panels - 패널 설정을 포함하는 패널 목록
#   title - 패널의 제목 변경
#   queryOverrides.namespace - 차트 패널에 사용할 그룹 또는 프로젝트 경로
#   options.exclude_metrics - 차트 패널에서 메트릭 ID별로 행 숨기기
#   options.filter_labels -
#     쿼리된 레이블에 일치하는 데이터만 표시합니다. 여러 레이블을 제공하는 경우 결과에 포함되려면 하나의 레이블만 일치하면 됩니다.
#     호환되는 메트릭(다른 메트릭은 자동으로 제외됨):
#       * 리드 타임
#       * 사이클 타임
#       * 이슈
#       * 완료된 이슈
#       * 병합 요청 처리량
panels:
  - title: '그룹 사용량 개요'
    visualization: usage_overview
    queryOverrides:
      namespace: group
    gridAttributes:
      yPos: 1
      xPos: 1
      height: 1
      width: 12
  - title: '그룹 dora 비교'
    visualization: dora_chart
    queryOverrides:
      namespace: group
    gridAttributes:
      yPos: 2
      xPos: 1
      height: 12
      width: 12
    options:
      filter_labels:
        - in_development
        - in_review
  - title: ' 프로젝트 dora 비교'
    visualization: dora_chart
    queryOverrides:
      namespace: group/my-project
    gridAttributes:
      yPos: 26
      xPos: 1
      height: 12
      width: 12
    options:
      exclude_metrics:
        - deployment_frequency
        - change_failure_rate

DevSecOps 메트릭 비교 패널을 레이블로 필터링

레이블 필터는 각 적합한 메트릭의 드릴다운 보고서 URL에 쿼리 매개변수로 추가되어 자동으로 적용됩니다. 구성 파일의 비교 패널이 ‘filter_labels’로 활성화되어 있는 경우 드릴다운 링크는 패널 필터에서 레이블을 상속받습니다.

  - data:
      namespace: group/another-project
      filter_labels:
        - in_development
        - in_review

대시 보드 메트릭 및 드릴다운 보고서

메트릭 설명 드릴다운 보고서 문서 페이지 ID
배포 빈도 프로덕션으로의 평균 배포 횟수. 이 메트릭은 가치가 최종 사용자에게 전달되는 빈도를 측정합니다. 배포 빈도 탭 배포 빹도 deployment_frequency
변경의 리드 타임 커밋을 성공적으로 프로덕션으로 전달하는 데 걸리는 시간. 이 메트릭은 CI/CD 파이프라인의 효율성을 반영합니다. 리드 타임 탭 변경의 리드 타임 lead_time_for_changes
서비스 복원 시간 조직이 프로덕션에서 발생한 장애로부터 복구하는 데 걸리는 시간. 서비스 복원 시간 탭 서비스 복원 시간 time_to_restore_service
변경 실패율 프로덕션에서 사건을 일으키는 배포의 백분율. 변경 실패율 탭 변경 실패율 change_failure_rate
리드 타임 이슈 생성부터 이슈 종료까지의 중간 시간. 가치 스트림 분석 이슈의 리드 타임 및 사이클 타임 보기 lead_time
사이클 타임 링크된 이슈의 병합 요청의 가장 이른 커밋부터 해당 이슈가 종료될 때까지의 중간 시간. VSA 개요 이슈의 리드 타임 및 사이클 타임 보기 cycle_time
생성된 이슈 생성된 새 이슈 수. 이슈 분석 이슈 분석 issues
완료된 이슈 월별로 닫힌 이슈 수. 이슈 분석 이슈 분석 issues_completed
배포 횟수 프로덕션으로의 총 배포 횟수. 병합 요청 분석 병합 요청 분석 deploys
병합 요청 처리량 월별 병합된 병합 요청 수. 그룹 생산성 분석, 프로젝트 병합 요청 분석 그룹 생산성 분석 프로젝트 병합 요청 분석 merge_request_throughput
기여자 수 그룹에서 기여한 월간 고유 사용자 수. 기여 분석 사용자 기여 이벤트 contributor_count
중요한 취약점 시간당 프로젝트 또는 그룹의 중요한 취약점 시간당 취약점 보고서 취약점 보고서 vulnerability_critical
높은 취약점 시간당 프로젝트 또는 그룹의 높은 취약점 시간당 취약점 보고서 취약점 보고서 vulnerability_high

Jira와 함께 사용하는 Value Streams 대시보드 지표

다음 지표들은 Jira를 사용하지 않아도 됩니다:

  • DORA 배포 빈도
  • DORA 변경 사항의 리드 타임
  • 배포 횟수
  • 병합 요청 처리량
  • 취약점