분석 대시보드

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

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

데이터 소스

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

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

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

내장 대시보드

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

제품 분석

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

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

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

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

가치 스트림 관리

사용자 정의 대시보드

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

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

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

대시보드 디자이너

대시보드 디자이너를 사용하여:

시각화 디자이너

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

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

프로젝트 대시보드 보기

전제 조건:

  • 프로젝트에 대해 적어도 개발자 역할이 있어야 합니다.

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

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

가치 스트림 대시보드 보기

  • 소개된 것은 GitLab 16.7에서 [프로젝트 분석 대시보드 동적 가치 스트림 대시보드](../../administration/feature_flags.md)라는 플래그와 함께입니다. 기본으로 비활성화됩니다.

플래그: 자체 관리 GitLab에서 기본적으로이 기능을 사용할 수 없습니다. 프로젝트 또는 전체 인스턴스에 사용할 수 있게하려면 관리자가 combined_analytics_dashboards 및 project_analytics_dashboard_dynamic_vsd라는 기능 플래그를 활성화할 수 있습니다. GitLab.com 및 GitLab Dedicated의 경우이 기능을 사용할 수 없습니다. 이 기능은 프로덕션 환경에서 사용할 준비가되지 않았습니다.

전제 조건: 프로젝트에 대한 적어도 기고자 역할이 있어야합니다. 가치 스트림 대시 보드에 대한 개요 백그라운드 집계를 활성화해야합니다.

프로젝트의 분석 대시 보드로서 가치 스트림 대시 보드를보려면 다음 단계를 따르세요:

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

그룹 대시 보드보기

티어: Ultimate 제공: GitLab.com, 자체 호스팅, GitLab Dedicated 상태: 실험
  • 사용 도입 GitLab 16.2에서 [그룹 분석 대시 보드](../../administration/feature_flags.md)라는 플래그와 함께. 기본으로 비활성화됩니다.
  • GitLab.com 및 자체 호스팅에는 GitLab 16.8 이후에 활성화되었습니다.

플래그: 자체 관리 GitLab에서 기본적으로이 기능을 사용할 수 있습니다. 기능을 숨기려면 관리자가 group_analytics_dashboards라는 플래그를 비활성화할 수 있습니다. GitLab.com 및 GitLab Dedicated의 경우이 기능을 사용할 수 있습니다.

전제 조건: 그룹에 대한 적어도 기고자 역할이 있어야합니다.

그룹의 대시 보드 목록 (기본 빌트인 및 사용자 정의 모두)을보려면:

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

가치 스트림 대시보드 보기

플래그: 자체 관리 GitLab에서 기본적으로이 기능을 사용할 수 없습니다. 그룹 당 또는 전체 인스턴스에 사용할 수 있도록하려면 관리자가 group_analytics_dashboard_dynamic_vsd라는 기능 플래그를 활성화할 수 있습니다. GitLab.com 및 GitLab Dedicated의 경우이 기능을 사용할 수 없습니다. 이 기능은 프로덕션 환경에서 사용할 준비가되지 않았습니다.

그룹의 분석 대시 보드로서 가치 스트림 대시 보드를보려면 다음 단계를 따르세요:

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

대시 보드의 위치 변경

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

전제 조건: 프로젝트 또는 해당 프로젝트의 그룹에 대한 유지 관리자 역할을하십시오.

그룹 대시 보드

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 documentation에 나열된 옵션을 사용한 선 차트.
  • ECharts documentation에 나열된 옵션을 사용한 막대 차트.
  • 데이터 테이블.
  • 싱글 상태, decimalPlaces를 설정하는 유일한 옵션이 있습니다(숫자, 기본값은 0).

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

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

예를 들어, visualizations 폴더에서 시간별 이벤트 수를 보여주는 선 차트를 만들기 위해 예시로 line_chart.yaml 파일을 생성하고 다음 필수 필드를 포함해야 합니다:

  • version
  • type
  • data
  • options

기여하려면 새로운 시각화 렌더 타입 추가를 참조하세요.

사용자 정의 대시보드 생성

사용자 정의 대시보드를 생성하려면:

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

사용자 정의 대시보드 편집

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

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

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

사용자 정의 시각화 생성

사용자 정의 시각화를 만들려면:

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

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

문제 해결

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

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

시각화 구성이 잘못됨

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

대시보드 패널 오류

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

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