분석 대시보드

Tier: Ultimate Offering: Self-managed
  • GitLab 15.9에서 실험 기능으로 도입되었습니다. combined_analytics_dashboards라는 플래그와 함께 제공됩니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 16.11에서 기본적으로 combined_analytics_dashboards가 활성화되었습니다.
  • GitLab 17.1에서 combined_analytics_dashboards가 제거되었습니다.

분석 대시보드는 수집된 데이터를 시각화하는 데 도움을 줍니다.
GitLab에서 제공하는 기본 제공 대시보드를 사용하거나 사용자 지정 시각화로 자신의 대시보드를 생성할 수 있습니다.

데이터 소스

데이터 소스는 대시보드 필터 및 시각화를 사용하여 결과를 쿼리하고 검색할 수 있는 데이터베이스 또는 데이터 모음에 대한 연결입니다.

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

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

기본 제공 대시보드

분석을 시작하는 데 도움을 주기 위해, GitLab은 미리 정의된 시각화와 함께 기본 제공 대시보드를 제공합니다.
이 대시보드는 By GitLab로 표시됩니다.
기본 제공 대시보드를 편집할 수는 없지만 유사한 스타일로 사용자 지정 대시보드를 생성할 수 있습니다.

제품 분석 대시보드

제품 분석이 활성화되고 온보딩되면 두 개의 기본 제공 대시보드가 제공됩니다:

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

Value Stream Management 대시보드

사용자 지정 대시보드

사용자 지정 대시보드를 사용하여 사용자 사례와 가장 관련성이 높은 메트릭을 위한 시각화를 설계하고 생성합니다.
대시보드 디자이너를 사용하여 사용자 지정 대시보드를 생성할 수 있습니다.

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

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

대시보드 디자이너

  • 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가 제거되었습니다.

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

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

프로젝트 대시보드 보기

전제 조건:

  • 프로젝트에 대해 최소한 Reporter 역할을 가져야 합니다.

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

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

그룹 대시보드 보기

세부 사항: Tier: Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

  • 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에서 일반적으로 사용 가능합니다.
  • GitLab 17.0에서 기능 플래그 group_analytics_dashboard_dynamic_vsd가 제거되었습니다.

그룹의 분석 대시보드로서 가치 흐름 대시보드를 보려면:

  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. 선택 사항. 대시보드에 추가할 새로운 시각화를 생성하려면 차트 시각화 정의를 참조하세요.

예를 들어, 세 개의 대시보드(전환 퍼널, 인구 통계 breakdown 및 북극성 메트릭)와 모든 대시보드에 적용되는 하나의 시각화(라인 차트)를 만들고 싶다면, 파일 구조는 다음과 같이 보입니다:

.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. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

  2. Analyze > Analytics dashboards를 선택합니다.

  3. New dashboard를 선택합니다.

  4. New dashboard 입력란에 대시보드의 이름을 입력합니다.

  5. 오른쪽의 Add visualizations 목록에서 대시보드에 추가할 시각화를 선택합니다.

  6. 선택 사항. 원하는 대로 선택한 패널을 드래그하거나 크기를 조정합니다.

  7. Save를 선택합니다.

사용자 정의 대시보드 편집

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

기존 사용자 정의 대시보드를 편집하려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

  2. Analyze > Analytics dashboards를 선택합니다.

  3. 사용 가능한 대시보드 목록에서 편집할 사용자 정의 대시보드(By GitLab 레이블이 없는 대시보드)를 선택합니다.

  4. Edit를 선택합니다.

  5. 선택 사항. 대시보드의 제목을 변경합니다.

  6. 선택 사항. 오른쪽의 Add visualizations 목록에서 대시보드에 추가할 다른 시각화를 선택합니다.

  7. 선택 사항. 대시보드에서 패널을 선택하고 원하는 대로 드래그하거나 크기를 조정합니다.

  8. Save를 선택합니다.

사용자 정의 시각화 생성

사용자 정의 시각화를 생성하려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

  2. Analyze > Analytics dashboards를 선택합니다.

  3. Visualization designer를 선택합니다.

  4. Visualization title 필드에 시각화의 이름을 입력합니다.

  5. Visualization type 드롭다운 목록에서 시각화 유형을 선택합니다.

  6. What metric do you want to visualize? 섹션에서 측정값이나 차원을 선택합니다.

  7. Save를 선택합니다.

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

GitLab Duo로 사용자 정의 시각화 생성

Tier: For a limited time, Ultimate. On October 17, 2024, Ultimate with GitLab Duo Enterprise.

Offering: GitLab.com

Status: Experiment

  • GitLab 16.11에서 experiment 기능으로 도입 with a flag named generate_cube_query. 기본적으로 비활성화되어 있습니다.

사전 요구 사항:

자연어 쿼리를 사용하여 GitLab Duo로 사용자 정의 시각화를 생성하려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.

  2. Analyze > Analytics dashboards를 선택합니다.

  3. Visualization designer를 선택합니다.

  4. Visualization title 필드에 시각화의 이름을 입력합니다.

  5. Visualization type 드롭다운 목록에서 시각화 유형을 선택합니다.

  6. Generate with GitLab Duo 섹션에 프롬프트를 입력합니다. 예를 들면:

    • 일일 세션

    • 주별로 그룹화된 고유 사용자 수

    • 가장 인기 있는 페이지는 무엇입니까?

    • 각 브라우저에서 몇 명의 고유 사용자가 있습니까?

  7. Generate with GitLab Duo를 선택합니다.

  8. Save를 선택합니다.

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

이 실험적 기능에 대한 피드백은 issue 455363에서 제공해주세요.

시각화 쿼리 빌더

  • 도입됨 GitLab 17.1에서 analytics_visualization_designer_filtering이라는 플래그와 함께. 기본적으로 비활성화됨.
  • 일반 제공됨 GitLab 17.2. 기능 플래그 analytics_visualization_designer_filtering 제거됨.

사용자는 측정값 및 차원을 사용하여 맞춤형 시각화의 결과를 필터링하고 정제할 수 있습니다:

  • 측정값: 계산할 수 있는 속성. 측정값은 기본적으로 집계됩니다.
  • 차원: 측정값과 관련된 특성. 측정값에 여러 차원을 추가할 수 있습니다.

사용자는 선택한 측정값으로 사용자 정의 이벤트 이름으로 필터링할 수 있습니다:

  • 추적된 이벤트 수
  • 추적된 이벤트 고유 사용자 수

참고: 측정값을 변경하거나 제거하면 의존하는 차원도 제거될 수 있습니다.

문제 해결

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

대시보드에 데이터 로드에 실패했다는 전역 오류 메시지가 표시되면 먼저 페이지를 새로 고침해 보세요.

오류가 계속 발생하는 경우:

유효하지 않은 대시보드 구성

대시보드에 구성 오류가 있다는 전역 오류 메시지가 표시되면, 귀하의 구성 사항이 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년까지의 고유 사용자 수, 월별 그룹화.
  • 시각화 디자이너에 표시된 것과 동일한 이름의 지표 및 차원을 사용하세요. 예: 기존 고객 대신 재방문 사용자.