- 가치 스트림 대시보드 패널
- 개요 배경 집계 활성화 또는 비활성화
- 값 스트림 대시보드 보기
- 대시보드 패널 사용자 정의
- 대시보드 메트릭 및 드릴다운 보고서
- Jira를 사용하지 않는 Value Streams 대시보드 지표
가치 스트림 대시보드
- GitLab 15.8에서 Closed Beta 기능으로 소개되었으며 기본적으로
group_analytics_dashboards_page
라는 플래그가 설정되어 비활성화되어 있습니다.- GitLab 15.11에서는 Open Beta 기능으로 출시되었으며 기본적으로
group_analytics_dashboards_page
라는 플래그가 설정되어 활성화되어 있습니다.- GitLab 16.0에서 일반적으로 사용 가능합니다. ‘group_analytics_dashboards_page’ 피처 플래그가 제거되었습니다.
가치 스트림 대시보드를 개선하는 데 도움을 주려면 이 설문조사에서 사용 경험에 대한 피드백을 공유해주세요. 더 많은 정보는 Value Stream Management 카테고리 방향 페이지를 참조하세요.
가치 스트림 대시보드는 디지털 변형 개선을 위한 트렌드, 패턴, 기회를 식별하는 데 사용할 수 있는 사용자 정의 가능한 대시보드입니다. 가치 스트림 대시보드의 중앙 집중식 UI는 모든 이해관계자가 조직에 관련된 동일한 메트릭 세트를 액세스하고 볼 수 있는 단일 진실의 원천(SSOT) 역할을 합니다.
가치 스트림 대시보드에는 두 개의 패널(DevSecOps 메트릭 비교 및 DORA Performers 점수)이 포함되어 있어 다음과 같은 메트릭을 시각화합니다:
가치 스트림 대시보드를 사용하면 다음을 수행할 수 있습니다:
- 일정 기간동안 위의 메트릭을 추적하고 비교합니다.
- 조기에 하락하는 경향을 파악합니다.
- 보안 노출을 이해합니다.
- 개별 프로젝트나 메트릭을 자세히 살펴 개선 조치를 취합니다.
가치 스트림 대시보드 패널
가치 스트림 대시보드 패널은 기본적으로 구성되어 있지만대시보드 패널을 사용자 정의할 수도 있습니다.
DevSecOps 메트릭 비교 패널
- GitLab 16.9에서 기여자 수 메트릭이 추가되었습니다.
DevSecOps 메트릭 비교는 그룹이나 프로젝트의 DORA4, 취약점 및 흐름 메트릭을 현재 달, 지난 달, 이전 달, 지난 180일 동안의 데이터를 시각화합니다.
이 시각화는 여러 개의 DevOps 메트릭에 대한 고수준 사용자 정의 뷰를 제공하고 월별로 개선되고 있는지 여부를 이해하는 데 도움이 됩니다. 여러 그룹, 프로젝트 및 팀의 성능을 빠르게 비교할 수 있습니다. 이 시각화를 통해 가치가 가장 큰 기여자, 고퍼포머인 프로젝트 및 팀을 식별하는 데 도움이 됩니다.
메트릭 위로 마우스를 올리면 해당 메트릭에 대한 설명과 관련 문서 페이지로의 링크가 표시되는 툴팁이 표시됩니다.
월별 값은 이전 달과 비교했을 때의 증가 또는 감소율을 나타냅니다.
지난 6개월 동안의 sparkline은 시간에 따른 가치 트렌드를 나타내며 백분율 변화율이 아닙니다. 스파크라인의 색상은 파란색에서 초록색까지이며, 초록색은 긍정적인 트렌드를 나타내고, 파란색은 부정적인 트렌드를 나타냅니다. 스파크라인을 통해 시간에 따른 메트릭 트렌드(계절적 변화 등)를 식별할 수 있습니다.
clickhouse_data_collection
및 event_sync_worker_for_click_house
를 활성화해야 합니다.DORA Performers 점수 패널
- GitLab 16.3에서 도입되었으며 기본적으로
dora_performers_score_panel
이라는 플래그가 설정되어 비활성화되어 있습니다.- GitLab 16.9에서 GitLab.com에서 활성화되었습니다.
DORA 메트릭 Performers 점수 패널은 여러 프로젝트 간의 조직의 DevOps 성능 수준을 시각화한 막대형 차트입니다.
차트는 프로젝트의 DORA 점수를 높음, 중간, 낮음으로 분류한 것을 보여줍니다. 이는 그룹의 모든 하위 프로젝트를 집계합니다.
차트의 각 막대는 매월 계산된 각 점수 범주의 총 프로젝트 수를 표시합니다. 차트에서 데이터를 제외하려면(예: “포함되지 않음”) 범례에서 제외하려는 시리즈를 선택하세요. 각 막대에 마우스를 올리면 해당 점수의 정의를 설명하는 대화 상자가 표시됩니다.
예를 들어, 프로젝트가 배포 빈도(속도)에 대해 높은 점수를 가지면, 하루에 한 번 이상의 프로덕션 배포가 있는 것을 의미합니다.
메트릭 | 설명 | 높음 | 중간 | 낮음 |
---|---|---|---|---|
배포 빈도 | 하루에 프로덕션으로의 배포 횟수 | ≥30 | 1-29 | <1 |
변경에 대한 리드 타임 | 코드가 커밋된 후 프로덕션에서 성공적으로 실행되기까지 걸리는 날짜 수 | ≤7 | 8-29 | ≥30 |
서비스 복원 시간 | 서비스 인시던트 또는 사용자에 영향을 미치는 결함이 발생했을 때 서비스를 복원하는 데 걸리는 날짜 수 | ≤1 | 2-6 | ≥7 |
변경 실패율 | 프로덕션에 대한 변경 중 서비스 저하된 변경의 백분율 | ≤15% | 16%-44% | ≥45% |
이 점수는 구글의 DORA 2022 가속화 DevOps 보고서의 분류를 기반으로 합니다.
프로젝트 주제별로 DORA Performers 점수 필터링
YAML 구성을 사용하면 할당된 주제에 따라 표시되는 프로젝트를 필터링할 수 있습니다.
panels:
- data:
namespace: group/my-custom-group
filter_project_topics:
- JavaScript
- Vue.js
여러 주제를 제공하는 경우 모든 주제가 일치해야 결과에 포함됩니다.
개요 배경 집계 활성화 또는 비활성화
- GitLab 16.1에 도입되었습니다. 기본적으로 비활성화된
value_stream_dashboard_on_off_setting
플래그와 함께.- GitLab 16.4에서 Self-managed에서 활성화되었습니다.
- GitLab 16.6에서
value_stream_dashboard_on_off_setting
피처 플래그가 제거되었습니다.
값 스트림 대시보드의 개요 카운트 집계를 활성화 또는 비활성화하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 설정 > 일반을 선택합니다.
- 분석을 확장합니다.
- 값 스트림 대시보드에서 값 스트림 대시보드 개요 배경 집계 활성화 확인란을 선택하거나 선택 해제합니다.
그룹에서 집계된 사용량 카운트를 검색하려면 GraphQL API를 사용합니다.
값 스트림 대시보드 보기
필수 조건:
- 그룹에 대한 적어도 Reporter 역할이 있어야 합니다.
- 값 스트림 대시보드의 개요 배경 집계가 활성화되어 있어야 합니다.
값 스트림 대시보드 보기:
-
분석 대시보드:
- 그룹 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 분석 > 분석 대시보드를 선택합니다.
-
값 스트림 분석에서:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
- 분석 > 값 스트림 분석을 선택합니다.
- 결과 필터링 텍스트 상자 아래 라이프사이클 지표 행에서 값 스트림 대시보드 / DORA를 선택합니다.
- 선택 사항. 새 페이지를 열려면 그룹 URL에 이 경로
/analytics/dashboards/value_streams_dashboard
를 추가합니다(예:https://gitlab.com/groups/gitlab-org/-/analytics/dashboards/value_streams_dashboard
).
그룹 또는 프로젝트에 대해 분석 대시보드로 렌더링된 값 스트림 대시보드를 또한 볼 수 있습니다.
대시보드 패널 사용자 정의
값 스트림 대시보드를 사용자 정의하고 페이지에 포함할 서브그룹 및 프로젝트를 구성할 수 있습니다.
쿼리 매개변수 사용
여러 서브그룹 및 프로젝트를 표시하려면 URL 매개변수로 해당 경로를 지정합니다.
예를 들어, 매개변수 query=gitlab-org/gitlab-ui,gitlab-org/plan-stage
는 각각 다음과 같이 별도의 패널을 표시합니다.
-
gitlab-org
그룹 -
gitlab-ui
프로젝트 -
gitlab-org/plan-stage
서브그룹
YAML 구성 사용
- GitLab 16.10에서 그룹 분석 대시보드에 대한 스키마가 변경되었습니다.
페이지의 기본 콘텐츠를 사용자 정의하려면 원하는 프로젝트에 YAML 구성 파일을 만들어야 합니다. 이 파일에서는 제목, 설명 및 패널 및 레이블 필터 수와 같은 여러 설정 및 매개변수를 정의할 수 있습니다. 이 파일은 스키마 기반으로 작성되며 Git과 같은 버전 관리 시스템으로 관리됩니다. 이를 통해 필요한 경우 구성 변경의 이력을 추적하고 유지하거나 이전 버전으로 복구하며 팀원과 효과적으로 협업할 수 있습니다. 쿼리 매개변수는 여전히 YAML 구성을 재정의하는 데 사용할 수 있습니다.
먼저 프로젝트를 설정해야 합니다.
필수 조건:
- 해당 그룹의 적어도 Maintainer 역할이 있어야 합니다.
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
- 설정 > 일반을 선택합니다.
- 분석을 확장합니다.
- YAML 구성 파일을 저장하려는 프로젝트를 선택합니다.
- 변경 사항 저장을 선택합니다.
프로젝트를 설정한 후, 구성 파일을 설정합니다:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 기본 브랜치에서 구성 파일을 생성합니다:
.gitlab/analytics/dashboards/value_streams/value_streams.yaml
. -
value_streams.yaml
구성 파일에서 구성 옵션 작성:
# title - 값 스트림 대시보드의 제목 변경
title: 'Custom Dashboard title'
# description - 값 스트림 대시보드의 설명 변경. [옵션]
description: 'Custom description'
# panels - 패널 설정을 포함하는 패널 디렉터리
# title - 패널 제목 변경. [옵션]
# data.namespace - 차트 패널에 사용할 그룹 또는 프로젝트 경로.
# data.exclude_metrics - 차트 패널에서 메트릭 ID에 따라 행 숨기기.
# data.filter_labels -
# 질의 레이블과 일치하는 데이터만 표시합니다. 여러 레이블을 제공하는 경우 데이터가 결과에 포함되려면 단일 레이블만 일치하면 됩니다.
# 호환 가능한 메트릭(다른 메트릭은 자동으로 제외됨):
# * lead_time
# * cycle_time
# * issues
# * issues_completed
# * merge_request_throughput
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 값 스트림 대시보드 - 레이블 필터 데모를 참조하세요.
그룹 분석 대시보드 스키마
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 -
# 요청된 레이블과 일치하는 데이터만 표시합니다. 여러 레이블이 제공된 경우
# 결과에 포함되기 위해 데이터가 하나의 레이블과 일치해야 합니다.
# 호환되는 메트릭 (다른 메트릭은 자동으로 제외됨):
# * lead_time
# * cycle_time
# * issues
# * issues_completed
# * merge_request_throughput
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
|
사이클 타임 | 연결된 이슈의 Merge Request의 가장 이른 커밋부터 해당 이슈가 닫힐 때까지의 중앙값 시간. | VSA 개요 | 이슈의 리드 타임 및 사이클 타임 보기 | cycle_time
|
생성된 이슈 | 생성된 새 이슈의 수. | 이슈 분석 | 이슈 분석 | issues
|
완료된 이슈 | 월별로 종료된 이슈 수. | 이슈 분석 | 이슈 분석 | issues_completed
|
배포 횟수 | 프로덕션 환경으로의 총 배포 횟수. | Merge Request 분석 | Merge Request 분석 | deploys
|
Merge Request 처리량 | 월별로 Merge된 Merge Request 수. | 그룹 프로덕션성 분석, 프로젝트 Merge Request 분석 | 그룹 프로덕션성 분석 프로젝트 Merge Request 분석 | merge_request_throughput
|
기여자 수 | 그룹에서 월별 고유한 기여 사용자 수. | 기여 분석 | 사용자 기여 이벤트 | contributor_count
|
중요한 취약점 시간대별 | 프로젝트 또는 그룹에서 중요한 취약점 시간대별 | 취약점 보고서 | 취약점 보고서 | vulnerability_critical
|
높은 취약점 시간대별 | 프로젝트 또는 그룹에서 높은 취약점 시간대별 | 취약점 보고서 | 취약점 보고서 | vulnerability_high
|
Jira를 사용하지 않는 Value Streams 대시보드 지표
다음 지표들은 Jira를 사용하지 않습니다:
- DORA 배포 빈도
- DORA 변경 사항의 리드 타임
- 배포 횟수
- Merge Request 처리량
- 취약점