• 데이터 소스
• 내장 대시보드
  • 제품 분석
  • 가치 스트림 관리
• 사용자 정의 대시보드
• 대시보드 디자이너
• 시각화 디자이너
• 프로젝트 대시보드 보기
  • 가치 스트림 대시보드 보기
• 그룹 대시보드 보기
  • 가치 스트림 대시보드 보기
• 대시보드 위치 변경
  • 그룹 대시보드
  • 프로젝트 대시보드
• 대시보드 정의
• 차트 시각화 정의
• 사용자 정의 대시보드 생성
• 사용자 정의 대시보드 편집
• 사용자 정의 시각화 만들기
  • GitLab Duo를 사용하여 사용자 정의 시각화 생성
• 문제 해결
  • 대시보드 로드 중에 문제가 발생했습니다.
  • 유효하지 않은 시각화 구성
  • 대시보드 패널 오류
  • GitLab Duo를 사용한 시각화 생성이 예상치 못한 결과를 반환하는 경우

분석 대시보드

• GitLab 15.9에 Experiment 기능으로 도입됨. 기본으로 비활성화되어 있는 combined_analytics_dashboards 플래그가 있습니다.
• combined_analytics_dashboards이 기본으로 활성화되었습니다. (GitLab 16.11)

분석 대시보드를 사용하여 수집된 데이터를 시각화할 수 있습니다. 내장 대시보드를 사용하거나 사용자 정의 시각화로 직접 만들 수 있습니다.

데이터 소스

데이터 소스는 대시보드 필터 및 시각화에서 사용할 수 있는 데이터베이스 또는 데이터 집합에 대한 연결입니다.

분석 대시보드에 구성된 다음 데이터 소스들은 다음과 같습니다:

• 제품 분석
• 가치 스트림 관리

기여하려면 새 시각화 데이터 소스 추가하기를 참조하세요.

내장 대시보드

분석을 시작하는 데 도움이 되도록, GitLab은 미리 정의된 시각화가 포함된 내장 대시보드를 제공합니다. 이러한 대시보드는 By GitLab로 라벨이 지정되어 있으며 편집할 수 없습니다. 대신, 유사한 스타일의 사용자 정의 대시보드를 만들 수 있습니다.

제품 분석

제품 분석이 활성화되고 온보딩될 때 두 가지 내장 대시보드가 추가됩니다:

• Audience는 사용자 및 세션과 같은 트래픽 관련 지표를 표시합니다.
• Behavior는 페이지 뷰 및 이벤트와 같은 사용자 활동 관련 지표를 표시합니다.

제품 분석의 개발에 대한 자세한 정보는 그룹 방향 페이지를 참조하십시오. 버그 또는 기능에 대한 피드백을 제공하려면:

• 이슈 391970에 의견을 남기세요.
• group::product analytics 라벨이 지정된 이슈를 만드세요.

가치 스트림 관리

• 가치 스트림 대시보드는 DevOps 성능, 보안 노출 및 작업 흐름 최적화와 관련된 지표를 표시합니다.

사용자 정의 대시보드

사용자 정의 대시보드를 사용하여 사용 사례에 가장 관련 있는 지표에 대한 시각화를 디자인하고 만들 수 있습니다. 대시보드 디자이너를 사용하여 사용자 정의 대시보드를 만들 수 있습니다.

• 각 프로젝트는 무제한의 대시보드를 가질 수 있습니다. 유일한 제한 사항은 리포지터리 크기 제한일 수 있습니다.
• 각 대시보드는 하나 이상의 시각화를 참조할 수 있습니다.
• 시각화는 대시보드 간에 공유됩니다.

프로젝트 유지 보수자는 코드 소유자 및 승인 규칙과 같은 기능을 사용하여 대시보드 변경에 대한 승인 규칙을 강제로 적용할 수 있습니다. 대시보드 파일은 프로젝트의 다른 코드와 함께 소스 제어로 버전 관리됩니다.

대시보드 디자이너

• GitLab 16.1에 combined_analytics_dashboards_editor이라는 플래그와 함께 도입되었습니다. 기본으로 비활성화됨.
• GitLab 16.6에서 일반적으로 사용 가능해졌으며 combined_analytics_dashboards_editor 플래그가 제거되었습니다.

대시보드 디자이너를 사용하여 다음을 할 수 있습니다:

• 사용자 정의 대시보드 만들기.
• 사용자 정의 대시보드 편집을 통해:
  • 대시보드의 이름 변경
  • 시각화 추가 및 제거
  • 패널 크기 조정 또는 이동

시각화 디자이너

• GitLab 16.4에 combined_analytics_visualization_editor 플래그와 함께 도입되었습니다. 기본으로 비활성화됨.
• GitLab 16.7에서 일반적으로 사용 가능해졌으며 combined_analytics_visualization_editor 플래그가 제거되었습니다.

시각화 디자이너를 사용하여 다음을 할 수 있습니다:

• 사용자 정의 시각화 만들기.
• GitLab Duo로 사용자 정의 시각화 생성.
• 사용 가능한 데이터 탐색.

프로젝트 대시보드 보기

필수 사항:

• 프로젝트의 최소한 Developer 역할을 할당받아야 합니다.

프로젝트의 대시보드(내장 및 사용자 정의) 디렉터리을 보려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 분석 > 분석 대시보드를 선택합니다.
3. 사용 가능한 대시보드 디렉터리에서 보고 싶은 대시보드를 선택합니다.

가치 스트림 대시보드 보기

• GitLab 16.7에 project_analytics_dashboard_dynamic_vsd라는 플래그와 함께 도입되었습니다. 기본으로 비활성화됨.

필수 사항:

• 프로젝트의 최소한 Reporter 역할을 할당받아야 합니다.
• 가치 스트림 대시보드의 개요 배경 집계가 활성화되어 있어야 합니다.

프로젝트의 분석 대시보드로 가치 스트림 대시보드를 보려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 분석 > 분석 대시보드를 선택합니다.
3. 사용 가능한 대시보드 디렉터리에서 Value Streams Dashboard를 선택합니다.

그룹 대시보드 보기

• GitLab 16.2에 group_analytics_dashboards라는 플래그와 함께 도입되었습니다. 기본으로 비활성화됨.
• GitLab 16.8에서 일반적으로 사용 가능해졌습니다.
• GitLab 16.11에서 피처 플래그 group_analytics_dashboards가 제거되었습니다.

필수 사항:

• 그룹의 최소한 Reporter 역할을 할당받아야 합니다.

그룹의 대시보드(내장 및 사용자 정의) 디렉터리을 보려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 분석 > 분석 대시보드를 선택합니다.
3. 보려는 대시보드를 사용 가능한 대시보드 디렉터리에서 선택합니다.

가치 스트림 대시보드 보기

• GitLab 16.6에 group_analytics_dashboard_dynamic_vsd라는 플래그와 함께 도입되었습니다. 기본으로 비활성화됨.
• GitLab 17.0에서 일반적으로 사용 가능해졌으며 group_analytics_dashboard_dynamic_vsd 플래그가 제거되었습니다.

그룹의 분석 대시보드로 가치 스트림 대시보드를 보려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
2. 분석 > 분석 대시보드를 선택합니다.
3. Value Streams Dashboard를 사용 가능한 대시보드 디렉터리에서 선택합니다.

대시보드 위치 변경

프로젝트 또는 그룹 대시보드의 위치를 변경할 수 있습니다.

전제 조건:

• 프로젝트가 속한 그룹이나 프로젝트에 대해 적어도 Maintainer 역할을 가져야 합니다.

그룹 대시보드

그룹 대시보드의 위치를 변경하려면 다음을 수행합니다:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 대시보드 파일을 저장할 프로젝트를 찾습니다. 대시보드를 생성한 그룹에 프로젝트가 속해 있어야 합니다.
2. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
3. 설정 > 분석을 선택합니다.
4. 분석 대시보드 섹션에서 대시보드 파일 프로젝트를 선택합니다.
5. 변경 저장을 선택합니다.

프로젝트 대시보드

대시보드는 일반적으로 분석 데이터가 검색될 프로젝트에 정의됩니다. 그러나 대시보드를 위한 별도의 프로젝트를 가져도 됩니다. 대시보드 정의에 특정 액세스 규칙을 강제하거나 여러 프로젝트 사이에서 대시보드를 공유하려는 경우에 권장됩니다.

프로젝트 대시보드의 위치를 변경하려면 다음을 수행합니다:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾거나, 프로젝트 파일을 저장할 프로젝트를 만들기 위해 와 새 프로젝트/리포지터리 생성을 선택합니다.
2. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 분석 프로젝트를 찾습니다.
3. 설정 > 분석을 선택합니다.
4. 확장을 선택하여 사용자 정의 대시보드 프로젝트를 확인합니다.
5. 분석 대시보드 섹션에서 대시보드 파일 프로젝트를 선택합니다.
6. 변경 저장을 선택합니다.

대시보드 정의

대시보드를 정의하려면 다음을 수행합니다:

1. .gitlab/analytics/dashboards/에서 대시보드와 같은 이름의 디렉터리를 만듭니다.

   각 대시보드에는 자체 디렉터리가 있어야 합니다.

2. 새 디렉터리에서 디렉터리와 동일한 이름의 .yaml 파일을 만듭니다. 예: .gitlab/analytics/dashboards/my_dashboard/my_dashboard.yaml.

   이 파일에는 대시보드 정의가 포함되어야 합니다. 이는 ee/app/validators/json_schemas/analytics_dashboard.json에 정의된 JSON 스키마를 준수해야 합니다.

3. 선택 사항. 대시보드에 추가할 새 시각화를 만들려면 차트 시각화 정의를 참조하십시오.

예를 들어, 세 가지 대시보드(변환 퍼널, 인구 통계 분석, 핵심 메트릭)와 모든 대시보드에 적용되는 시각화(라인 차트)를 만들려면 파일 구조는 다음과 같을 것입니다:

.gitlab/analytics/dashboards
├── conversion_funnels
│  └── conversion_funnels.yaml
├── demographic_breakdown
│  └── demographic_breakdown.yaml
├── north_star_metrics
|  └── north_star_metrics.yaml
├── visualizations
│  └── example_line_chart.yaml

차트 시각화 정의

다양한 차트를 정의하고 그 중 일부에 시각화 옵션을 추가할 수 있습니다:

• ECharts 문서(https://echarts.apache.org/en/option.html)에 나열된 옵션이 있는 라인 차트,
• ECharts 문서(https://echarts.apache.org/en/option.html)에 나열된 옵션이 있는 막대 차트,
• 데이터 테이블,
• 단일 상태, decimalPlaces를 설정하는 유일한 옵션(숫자, 기본값은 0).

대시보드에 차트를 정의하려면 다음을 수행합니다:

1. .gitlab/analytics/dashboards/visualizations/ 디렉터리에 .yaml 파일을 만듭니다. 파일 이름은 해당 시각화를 설명하는 것이어야 합니다.
2. .yaml 파일에서 JSON 스키마에 따라 시각화 구성을 정의합니다. ee/app/validators/json_schemas/analytics_visualization.json의 스키마를 준수해야 합니다.

예를 들어, 분석을 통해 시간이 지남에 따른 이벤트 카운트를 보여주는 라인 차트를 만들려면 visualizations 폴더에 line_chart.yaml 파일을 생성하고 아래 필수 필드를 포함시킵니다:

• version
• type
• data
• options

기부 방법은 새 시각화 렌더 유형 추가를 참조하십시오.

사용자 정의 대시보드 생성

사용자 정의 대시보드를 만들려면 다음을 수행합니다:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 분석 > 분석 대시보드를 선택합니다.
3. 새 대시보드를 선택합니다.
4. 새 대시보드 입력란에 대시보드의 이름을 입력합니다.
5. 오른쪽의 시각화 추가 디렉터리에서 대시보드에 추가할 시각화를 선택합니다.
6. 선택 사항. 원하는 대로 선택한 패널을 드래그하여 크기를 조정합니다.
7. 저장을 선택합니다.

사용자 정의 대시보드 편집

대시보드 디자이너에서 사용자 정의 대시보드의 제목을 편집하고 대시보드에 시각화를 추가하거나 크기를 조정할 수 있습니다.

기존 사용자 정의 대시보드를 편집하려면 다음을 수행합니다:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 분석 > 대시보드를 선택합니다.
3. 사용 가능한 대시보드 디렉터리에서 편집하려는 사용자 정의 대시보드(By GitLab 라벨이 없는 대시보드)를 선택합니다.
4. 편집을 선택합니다.
5. 선택 사항. 대시보드의 제목을 변경합니다.
6. 선택 사항. 오른쪽의 시각화 추가 디렉터리에서 다른 시각화를 선택하여 대시보드에 추가합니다.
7. 선택 사항. 대시보드에서 패널을 선택하고 원하는 대로 드래그하여 크기를 조정합니다.
8. 저장을 선택합니다.

사용자 정의 시각화 만들기

사용자 정의 시각화를 만들려면 다음을 수행합니다:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 분석 > 대시보드를 선택합니다.
3. 시각화 디자이너를 선택합니다.
4. 시갛화 제목 필드에 시각화의 이름을 입력합니다.
5. 시각화 유형 드롭다운 디렉터리에서 시각화 유형을 선택합니다.
6. 어떤 메트릭을 시각화하고 싶으신가요? 섹션에서 쿼리하려는 메트릭을 선택합니다.
7. 선택 사항. 쿼리를 구체화하려면 차원을 선택합니다.
8. 저장을 선택합니다.

시각화를 저장한 후에는 동일한 프로젝트의 새로운 대시보드나 기존 대시보드에 추가할 수 있습니다.

GitLab Duo를 사용하여 사용자 정의 시각화 생성

• 피처 플래그(generate_cube_query라는 이름의)로 함께실험 기능으로 GitLab 16.11에서 도입되었습니다. 기본적으로 비활성화됩니다.

전제 조건:

• 프로젝트의 상위 그룹은 실험 및 베타 기능이 활성화되어 있어야 합니다.

GitLab Duo를 사용하여 사용자 정의 시각화를 생성하려면 다음을 수행합니다:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 분석 > 대시보드를 선택합니다.
3. 시각화 디자이너를 선택합니다.
4. 시갛화 제목 필드에 시각화의 이름을 입력합니다.
5. 시각화 유형 드롭다운 디렉터리에서 시각화 유형을 선택합니다.

6. GitLab Duo로 생성 섹션에서 자연어 쿼리를 입력합니다. 예:

   • 매일 세션
   • 주별로 그룹화된 고유 사용자 수
   • 가장 인기 있는 페이지는 무엇인가요?
   • 각 브라우저는 몇 명의 고유 사용자를 가지고 있나요?
7. GitLab Duo로 생성을 선택합니다.
8. 저장을 선택합니다.

시각화를 저장한 후에는 동일한 프로젝트의 새로운 대시보드나 기존 대시보드에 추가할 수 있습니다.

문제 해결

대시보드 로드 중에 문제가 발생했습니다.

대시보드에 데이터를 로드할 수 없다는 전역 오류 메시지가 표시되면, 먼저 페이지를 새로고침해보세요. 오류가 계속되면:

• ee/app/validators/json_schemas/analytics_dashboard.json에 정의된 대시보드 JSON 스키마와 일치하는지 확인하세요.
• 제품 분석을 위해 관리자 및 프로젝트 설정을 확인하고 올바르게 설정되어 있는지 확인하세요.

유효하지 않은 시각화 구성

대시보드 패널이 시각화 구성이 유효하지 않다는 메시지를 표시하면, 시각화 구성이 ee/app/validators/json_schemas/analytics_visualization.json에 정의된 시각화 JSON 스키마와 일치하는지 확인하세요.

대시보드 패널 오류

대시보드 패널에 오류 메시지가 표시되는 경우:

• Cube 쿼리 및 시각화 구성을 확인하고 올바르게 설정되어 있는지 확인하세요.
• 제품 분석의 경우, 시각화의 Cube 쿼리가 유효한지도 확인하세요.

GitLab Duo를 사용한 시각화 생성이 예상치 못한 결과를 반환하는 경우

GitLab Duo를 사용하여 예상한 것이나 유용한 결과를 얻지 못하면, 쿼리를 편집해보세요:

• 날짜 범위를 지정하세요. 예: 2023년부터 2024년까지 월별로 그룹화된 고유 사용자 수.
• 시각화 디자이너에 표시된 것과 동일한 메트릭 및 디멘젼 이름을 사용하세요. 예: 기존 사용자 대신에 돌아오는 사용자.