분석 대시보드

Tier: Ultimate Offering: Self-managed Status: Experiment
  • GitLab 15.9에서 실험 기능으로 도입되었습니다. 기본적으로 비활성화된 combined_analytics_dashboards 플래그와 함께.
Self-managed GitLab에서는 기본적으로 이 기능을 사용할 수 없습니다. 프로젝트별 또는 전체 인스턴스에 이 기능을 사용할 수 있도록 하려면 관리자가 combined_analytics_dashboards라는 플래그를 활성화할 수 있습니다. GitLab.com 및 전용 GitLab에서는 이 기능을 사용할 수 없습니다. 이 기능은 프로덕션 환경에서 사용할 준비가 되지 않았습니다.

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

데이터 소스

데이터 소스는 대시보드 필터 및 시각화가 해당 데이터베이스 또는 데이터 컬렉션에 연결되어 쿼리하고 결과를 검색하는 데 사용되는 것입니다.

다음 데이터 소스가 분석 대시보드에 구성되어 있습니다:

기여하려면 새로운 시각화 데이터 소스를 추가하십시오.

내장된 대시보드

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

제품 분석

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

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

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

  • 이슈 391970에 댓글을 작성하십시오.
  • group::product analytics 라벨이 지정된 이슈를 생성하십시오.

값 스트림 관리

사용자 정의 대시보드

사용자 정의 대시보드를 사용하면 사용 사례에 가장 관련 있는 메트릭을 위해 시각화를 설계 및 생성할 수 있습니다. 대시보드 디자이너를 사용하여 사용자 정의 대시보드를 만들 수 있습니다.

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

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

대시보드 디자이너

  • 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 플래그가 제거되었습니다.
note
이 기능은 product analytics 데이터 소스와만 호환됩니다.

시각화 디자이너를 사용하여:

프로젝트 대시보드 보기

전제 조건:

  • 프로젝트에 대해 최소한의 개발자 역할이 있어야 합니다.

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

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

값 스트림 대시보드 보기

  • GitLab 16.7에서 project_analytics_dashboard_dynamic_vsd라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화됩니다.
Self-managed GitLab에서는 기본적으로 이 기능을 사용할 수 없습니다. 프로젝트별 또는 전체 인스턴스에 이 기능을 사용할 수 있도록 하려면 관리자가 combined_analytics_dashboards 및 project_analytics_dashboard_dynamic_vsd라는 플래그를 활성화할 수 있습니다. GitLab.com 및 전용 GitLab에서는 이 기능을 사용할 수 없습니다. 이 기능은 프로덕션 환경에서 사용할 준비가 되지 않았습니다.

전제 조건:

  • 프로젝트에 대해 최소한의 보고자 역할이 있어야 합니다.
  • 값 스트림 대시보드의 개요 백그라운드 집계가 활성화되어 있어야 합니다.

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

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

그룹 대시보드 보기

Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated Status: Experiment
Self-managed GitLab에서는 기본적으로 이 기능을 사용할 수 있습니다. 이 기능을 숨기려면 관리자가 group_analytics_dashboards라는 플래그를 비활성화할 수 있습니다. GitLab.com 및 전용 GitLab에서는 이 기능을 사용할 수 있습니다.

전제 조건:

  • 그룹에 대해 최소한의 보고자 역할이 있어야 합니다.

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

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

가치 스트림 대시보드 보기

  • 이 소개는 기본적으로 비활성화되어 있지만, GitLab 16.6에 group_analytics_dashboard_dynamic_vsd라는 플래그와 함께 소개되었습니다.

플래그: Self-managed GitLab의 경우, 기본적으로 이 기능을 사용할 수 없습니다. 그룹이나 전체 인스턴스에 사용할 수 있도록 하려면 관리자가 group_analytics_dashboard_dynamic_vsd라는 피처 플래그를 활성화해야 합니다. GitLab.com 및 전용 GitLab에서는 이 기능을 사용할 수 없습니다. 이 기능은 프로덕션 환경에 사용하기에 적합하지 않습니다.

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

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

대시보드 위치 변경

프리퀘즈 :

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

그룹 대시보드

note
이 기능은 이슈 #411572의 일부로 그룹 수준 대시보드와 연결될 것입니다.

그룹의 대시보드 위치를 변경하려면:

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

프로젝트 대시보드

대시보드는 일반적으로 분석 데이터가 검색되는 프로젝트에 정의됩니다. 그러나 대시보드를위한 별도의 프로젝트를 생성할 수도 있습니다. 대시보드 정의에 특정 액세스 규칙을 적용하거나 여러 프로젝트 간에 대시보드를 공유하려는 경우 권장합니다.

note
대시보드는 동일한 그룹에 위치한 프로젝트 간에만 공유할 수 있습니다.

프로젝트 대시보드의 위치를 변경하려면:

  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 문서에 나열되어 있습니다.
  • 옵션에 기재된 열 차트는 ECharts 문서에 나열되어 있습니다.
  • 데이터 테이블.
  • 단일 통계, decimalPlaces (숫자, 기본값은 0)를 설정하는 유일한 옵션이 있습니다.

대시보드에 대한 차트를 정의하려면:

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

예를 들어, 이벤트 수를 시간별로 보여주는 라인 차트를 생성하려면 visualizations 폴더에 line_chart.yaml 파일을 만듭니다. 이 파일에는 다음과 같은 필수 필드가 있어야 합니다:

  • 버전
  • 유형
  • 데이터
  • 옵션

기여하려면 새 시각화 렌더 유형 추가를 참조하세요.

사용자 정의 대시보드 만들기

사용자 정의 대시보드를 만들려면:

  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. 저장을 선택합니다.

시각화를 저장한 후에는 해당 프로젝트의 새로운 또는 기존의 사용자 정의 대시보드에 추가할 수 있습니다.

문제 해결

대시보드를 로드하는 동안 오류가 발생했습니다.

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

잘못된 시각화 구성

대시보드 패널이 시각화 구성이 잘못되었다는 메시지를 표시하는 경우, 시각화 구성이 시각화 JSON 스키마와 일치하는지 확인하세요.

대시보드 패널 오류

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