분석 대시보드

Tier: Ultimate Offering: Self-Managed
  • 실험 기능인 combined_analytics_dashboards 플래그로 GitLab 15.9에 도입되었으며 기본으로 비활성화되어 있습니다.
  • combined_analytics_dashboards는 GitLab 16.11에서 기본적으로 활성화되었습니다.
  • combined_analytics_dashboards는 GitLab 17.1에서 제거되었습니다.

분석 대시보드를 사용하여 수집된 데이터를 시각화할 수 있습니다. GitLab에서 제공하는 내장 대시보드를 사용하거나 사용자 정의 시각화로 자체 대시보드를 만들 수 있습니다.

데이터 소스

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

분석 대시보드는 다음 데이터 소스를 사용합니다:

또한 사용자 정의 시각화 데이터 소스를 추가할 수 있습니다.

내장 대시보드

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

제품 분석 대시보드

제품 분석이 활성화되고 온보딩된 경우 두 개의 내장 대시보드를 사용할 수 있습니다:

  • 대상 그룹은 사용자 및 세션 수와 같은 트래픽과 관련된 지표를 표시합니다.
  • 동작은 페이지 뷰 및 이벤트 수와 같은 사용자 활동과 관련된 지표를 표시합니다.

가치 스트림 관리 대시보드

사용자 정의 대시보드

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

  • 각 프로젝트마다 무제한의 대시보드를 가질 수 있습니다. 유일한 제한은 저장소 크기 제한일 수 있습니다.
  • 각 대시보드는 하나 이상의 시각화를 참조할 수 있습니다.
  • 시각화는 여러 대시보드 간에 공유됩니다.

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

대시보드 디자이너

  • GitLab 16.1에서 combined_analytics_dashboards_editor 플래그와 함께 도입되었으며 기본으로 비활성화되어 있습니다.
  • GitLab 16.6에서 GA로 변경되었습니다. combined_analytics_dashboards_editor 플래그가 삭제되었습니다.

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

시각화 디자이너

  • GitLab 16.4에서 combined_analytics_visualization_editor 플래그와 함께 도입되었으며 기본으로 비활성화되어 있습니다.
  • GitLab 16.7에서 GA로 변경되었습니다. combined_analytics_visualization_editor 플래그가 삭제되었습니다.

참고: 이 기능은 제품 분석 데이터 소스와만 호환됩니다.

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

프로젝트 대시보드 보기

필수 구성 요소:

  • 프로젝트에 대한 적어도 Reporter 역할이 있어야 합니다.

프로젝트의 대시보드 목록(내장 및 사용자 정의)을 보려면:

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

그룹 대시보드 보기

Tier: Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated
  • GitLab 16.2에서 group_analytics_dashboards 플래그와 함께 도입되었으며 기본으로 비활성화되어 있습니다.
  • GitLab 16.8에서 GA로 변경되었습니다.
  • group_analytics_dashboards 플래그가 GitLab 16.11에서 제거되었습니다.

필수 구성 요소:

  • 그룹에 대한 적어도 Reporter 역할이 있어야 합니다.

그룹의 대시보드 목록(내장 및 사용자 정의)을 보거나 보려면:

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

가치 스트림 대시보드 보기

  • GitLab 16.6에서 group_analytics_dashboard_dynamic_vsd 플래그와 함께 도입되었으며 기본으로 비활성화되어 있습니다.
  • GitLab 17.0에서 GA로 변경되었습니다.
  • group_analytics_dashboard_dynamic_vsd 플래그가 GitLab 17.0에서 제거되었습니다.

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

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

대시보드 위치 변경

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

전제 조건:

  • 프로젝트 또는 해당 프로젝트가 속한 그룹에 대한 관리자 역할(Maintainer)을 가져야 합니다.

그룹 대시보드

참고: 이슈 411572는 이 기능을 그룹 수준 대시보드에 연결하는 것을 제안합니다.

그룹 대시보드의 위치를 변경하려면 다음 단계를 수행하세요:

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

프로젝트 대시보드

기본적으로 사용자 정의 대시보드는 현재 프로젝트에 저장됩니다. 왜냐하면 대시보드는 일반적으로 분석 데이터를 검색하는 프로젝트에서 정의됩니다. 그러나 대시보드를 위한 별도의 프로젝트를 만들 수도 있습니다. 대시보드 정의에 특정 액세스 규칙을 강제로 적용하거나 여러 프로젝트 간에 대시보드를 공유하려는 경우 이 설정이 권장됩니다.

참고: 같은 그룹에 위치한 프로젝트 간에만 대시보드를 공유할 수 있습니다.

프로젝트 대시보드의 위치를 변경하려면 다음 단계를 수행하세요:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다. 또는 를 선택하고 새 프로젝트/저장소를 선택하여 대시보드 파일을 저장할 프로젝트를 만듭니다.
  2. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 분석 프로젝트를 찾습니다.
  3. 설정 > 분석을 선택합니다.
  4. 분석 대시보드 섹션에서 대시보드 파일 프로젝트를 선택합니다.
  5. 변경 사항 저장을 선택합니다.

대시보드 정의

대시보드를 정의하려면 다음 단계를 수행하세요:

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

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

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

Tier: Limited time, Ultimate. 2024년 10월 17일에 GitLab Duo Enterprise로 Ultimate 제공. Offering: GitLab.com Status: Experiment
  • GitLab 16.11에서 실험 기능으로 소개되었으며 기본적으로 비활성화된 generate_cube_query라는 플래그로 제공됩니다.

전제 조건:

GitLab Duo를 사용하여 사용자 정의 시각화를 생성하는 방법:

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

  6. GitLab Duo로 생성 섹션에서 프롬프트를 입력합니다. 예를 들어:

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

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

이 실험 기능에 대한 피드백은 이슈 455363에서 제공하세요.

시각화 쿼리 빌더

  • GitLab 17.1에서 도입되었으며 기본적으로 비활성화된 analytics_visualization_designer_filtering라는 플래그로 제공됩니다.
  • GitLab 17.2에서 일반적으로 이용 가능하게 되었으며 피쳐 플래그 analytics_visualization_designer_filtering가 제거되었습니다.

사용자 정의 시각화의 결과를 필터링하고 정제하기 위해 측정 항목 및 치수를 사용할 수 있습니다:

  • 측정 항목: 계산할 수 있는 속성입니다. 측정 항목은 기본적으로 집계됩니다.
  • 치수: 측정 항목과 관련된 속성입니다. 하나의 측정 항목에 여러 치수를 추가할 수 있습니다.

일부 측정 항목으로 사용자 정의 이벤트 이름별로 필터링할 수 있습니다:

  • 추적된 이벤트 수
  • 추적된 이벤트 중복 사용자 수

참고: 측정 항목을 변경하거나 제거할 때 종속 치수도 제거될 수 있습니다.

문제 해결

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

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

잘못된 대시보드 구성

대시보드에 구성이 잘못되었다는 전역 오류 메시지가 표시되면 대시보드 JSON 스키마와 일치하는지 확인하세요.

잘못된 시각화 구성

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

대시보드 패널 오류

대시보드 패널이 오류 메시지를 표시하면:

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

GitLab Duo로 시각화 생성이 예기치 않은 결과를 반환

GitLab Duo가 기대된 대로 유용한 결과를 제공하지 않는 경우 쿼리를 수정해 보세요:

  • 날짜 범위를 지정합니다. 예: 2023년부터 2024년까지의 고유 사용자 수, 월별 그룹화
  • 시각화 디자이너에 표시된 메트릭 및 치수와 동일한 이름을 사용합니다. 예: 기존 고객 대신 재방문 사용자.