• 통찰력 보기
  • 딥 링크를 사용하여 통찰력 보고서 액세스
• 통찰력 차트와 상호 작용
  • 다른 보고서 표시
  • 막대 차트 주석 보기
  • 차트 확대
  • 차트에서 차원 제외
  • 차트에서 상세 정보 보기
• 프로젝트 통찰력 구성
• 그룹 통찰력 구성
• 통찰력 구성 파일
• 통찰력 구성 매개변수
  • title
  • description
  • type
  • query
    • query.data_source
    • issuable 쿼리 매개변수
      • query.params.issuable_type
      • query.params.issuable_state
    • query.params.filter_labels
    • query.params.collection_labels
    • query.group_by
    • query.period_limit
    • query.period_field
    • DORA 쿼리 매개변수
    • query.metric
    • query.group_by
    • query.period_limit
    • query.environment_tiers
  • projects
    • projects.only
• 완전한 인사이트 구성 예시

통찰력

• GitLab 12.0에서 소개되었습니다.

프로젝트 및 그룹의 통찰력을 구성하여 다음과 같은 데이터를 탐색할 수 있습니다.

• 특정 기간 동안 생성 및 종료된 이슈.
• 병합 요청이 병합되기까지의 평균 시간.
• Triage hygiene.

또한 그룹에 필요한 사용자 정의 통찰력 보고서를 만들 수 있습니다.

통찰력 보기

사전 요구 사항: - 프로젝트 통찰력의 경우 프로젝트에 액세스하고 그의 병합 요청 및 이슈에 대한 정보를 볼 수 있는 권한이 있어야 합니다. - 그룹 통찰력의 경우 그룹을 볼 수 있는 권한이 있어야 합니다.

프로젝트 또는 그룹에 대한 통찰력을 보려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트나 그룹을 찾습니다.
2. 분석 > 통찰력을 선택합니다.
3. 보고서를 보려면 보고서 선택 드롭다운 목록을 선택합니다.

딥 링크를 사용하여 통찰력 보고서 액세스

딥 링크를 사용하여 특정 보고서로 사용자를 직접 이동시킬 수 있습니다.

깊은 링크를 만들려면 보고서 키를 통찰력 보고서 URL의 끝에 추가합니다. 예를 들어 bugsCharts 키가 있는 GitLab 보고서의 깊은 링크 URL은 https://gitlab.com/gitlab-org/gitlab/insights/#/bugsCharts입니다.

통찰력 차트와 상호 작용

통찰력 차트와 상호 작용하여 그룹 활동에 대한 자세한 내용을 볼 수 있습니다.

다른 보고서 표시

통찰력 페이지에서 사용 가능한 보고서 중 하나를 표시하려면 보고서 선택 드롭다운 목록에서 원하는 보고서를 선택합니다.

막대 차트 주석 보기

각 막대 위로 마우스를 가져가면 주석을 볼 수 있습니다.

차트 확대

통찰력은 지난 90일간의 데이터를 표시합니다. 90일 범위의 일부 데이터만 표시하려면 확대할 수 있습니다.

이를 위해 일시 중지 아이콘()을 선택하고 수평축을 따라 이동합니다.

• 시작 날짜를 변경하려면 왼쪽 일시 중지 아이콘을 왼쪽이나 오른쪽으로 이동합니다.
• 종료 날짜를 변경하려면 오른쪽 일시 중지 아이콘을 왼쪽이나 오른쪽으로 이동합니다.

차트에서 차원 제외

기본적으로 통찰력은 차트에서 모든 사용 가능한 차원을 표시합니다.

차원을 제외하려면 차트 아래의 범례에서 차원의 이름을 선택합니다.

차트에서 상세 정보 보기

• GitLab 16.7에 소개되었습니다.
• GitLab 16.9에서 모든 issuables 차트에 대한 지원을 확장하도록 변경되었습니다.

query.data_source가 issuables인 모든 차트의 데이터를 자세히 살펴볼 수 있습니다.

특정 우선 순위나 심각도에 대한 데이터의 드릴다운 보고서를 보려면:

• 차트에서 드릴다운하려는 막대 스택을 선택합니다.

프로젝트 통찰력 구성

사전 요구 사항: - 프로젝트 구성에 따라 최소한 Developer 역할이 있어야 합니다.

프로젝트 통찰력은 프로젝트의 .gitlab/insights.yml 파일로 구성됩니다. 프로젝트에 구성 파일이 없으면 그룹 구성을 사용합니다.

.gitlab/insights.yml 파일은 프로젝트 또는 그룹의 보고서에 표시되는 차트의 구조와 순서, 차트의 스타일을 정의하는 YAML 파일입니다.

프로젝트 통찰력을 구성하려면 .gitlab/insights.yml 파일을 만듭니다. 방법은 다음과 같습니다: - 로컬로 프로젝트의 루트 디렉토리에 만들고 변경 사항을 푸시합니다. - UI에서: 1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다. 1. 파일 목록 위에서 커밋할 브랜치를 선택하고 플러스 아이콘을 선택한 후 새 파일을 선택합니다. 1. 파일 이름 텍스트 상자에 .gitlab/insights.yml를 입력합니다. 1. 큰 텍스트 상자에서 파일 내용을 업데이트합니다. 1. 변경사항 커밋을 선택합니다.

구성 파일을 만든 후 프로젝트의 그룹에도 사용할 수 있습니다.

그룹 통찰력 구성

GitLab은 기본 구성 파일에서 통찰력을 읽습니다.

그룹 통찰력을 구성하려면 다음과 같은 단계를 따릅니다: 1. 그룹에 속한 프로젝트에서 .gitlab/insights.yml 파일을 만듭니다. 1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾습니다. 1. 설정 > 일반을 선택합니다. 1. 분석을 확장하고 Insights 섹션을 찾습니다. 1. .gitlab/insights.yml 구성 파일을 포함하는 프로젝트를 선택합니다. 1. 변경 사항 저장을 선택합니다.

통찰력 구성 파일

.gitlab/insights.yml 파일에서:

• 구성 매개변수는 차트 동작을 정의합니다.
• 각 보고서에는 고유한 키와 가져와 표시할 차트의 컬렉션이 있습니다.
• 각 차트 정의는 키-값 쌍으로 구성된 해시로 이루어져 있습니다.

다음 예는 하나의 차트로 하나의 보고서를 표시하는 단일 정의를 보여줍니다.

bugsCharts:
  title: "버그용 차트"
  charts:
    - title: "월별 생성된 버그"
      description: "월별 생성된 열린 버그"
      type: bar
      query:
        data_source: issuables
        params:
          issuable_type: issue
          issuable_state: opened
          filter_labels:
            - bug
          group_by: month
          period_limit: 24

통찰력 구성 매개변수

다음 표는 차트 매개변수를 나열합니다:

title

title을 사용하여 차트 제목을 업데이트합니다. 제목은 통찹력 보고서에 표시됩니다.

예시:

monthlyBugsCreated:
  title: "월별 생성된 버그"

description

description을 사용하여 차트에 설명을 추가합니다. 이 설명은 제목 아래 차트 위에 표시됩니다.

예시:

monthlyBugsCreated:
  title: "월별 생성된 버그"
  description: "월별 생성된 열린 버그"

type

type을 사용하여 차트 유형을 정의합니다.

지원되는 값:

이름	예시:
bar
bar (시계열, 즉, group_by가 사용될 경우)
line
stacked-bar

dora 데이터 원본은 bar 및 line 차트 유형을 지원합니다.

예시:

monthlyBugsCreated:
  title: "월별 생성된 버그"
  type: bar

query

query를 사용하여 차트의 데이터 원본 및 필터링 조건을 정의합니다.

예시:

monthlyBugsCreated:
  title: "월별 생성된 버그"
  description: "월별 생성된 열린 버그"
  type: bar
  query:
    data_source: issuables
    params:
      issuable_type: issue
      issuable_state: opened
      filter_labels:
        - bug
      collection_labels:
        - S1
        - S2
        - S3
        - S4
      group_by: week
      period_limit: 104

data_source 파라미터 없는 레거시 형식은 아직 지원됩니다:

monthlyBugsCreated:
  title: "월별 생성된 버그"
  description: "월별 생성된 열린 버그"
  type: bar
  query:
    issuable_type: issue
    issuable_state: opened
    filter_labels:
      - bug
    collection_labels:
      - S1
      - S2
      - S3
      - S4
    group_by: week
    period_limit: 104

query.data_source

data_source를 사용하여 데이터를 노출하는 데이터 원본을 정의합니다.

지원되는 값:

• issuables: 병합 요청이나 이슈 데이터를 노출합니다.
• dora: DORA 지표를 노출합니다.

issuable 쿼리 매개변수

query.params.issuable_type

query.params.issuable_type을 사용하여 차트를 생성할 이슈 가능 유형을 정의합니다.

지원되는 값:

• issue: 차트가 이슈 데이터를 표시합니다.
• merge_request: 차트가 병합 요청 데이터를 표시합니다.

query.params.issuable_state

query.params.issuable_state을 사용하여 질의된 이슈 가능의 현재 상태로 필터링합니다.

기본적으로 opened 상태 필터가 적용됩니다.

지원되는 값:

• opened: 열린 이슈 또는 병합 요청.
• closed: 닫힌 이슈 또는 병합 요청.
• locked: 토론이 잠긴 이슈 또는 병합 요청.
• merged: 병합된 병합 요청.
• all: 모든 상태의 이슈 또는 병합 요청.

query.params.filter_labels

query.params.filter_labels는 쿼리 된 이슈에 적용된 라벨로 필터링하는 데 사용합니다.

기본적으로 라벨 필터가 적용되지 않습니다. 선택된 이슈에는 모든 정의된 라벨이 적용되어야합니다.

예시:

monthlyBugsCreated:
  title: "매월 생성된 리그레션"
  type: bar
  query:
    data_source: issuables
    params:
      issuable_type: issue
      issuable_state: opened
      filter_labels:
        - bug
        - regression

query.params.collection_labels

query.params.collection_labels는 구성된 라벨에 의해 이슈들을 그룹화하는 데 사용됩니다. 기본적으로 그룹화가 적용되지 않습니다.

예시:

weeklyBugsBySeverity:
  title: "심각도별 주간 버그"
  type: stacked-bar
  query:
    data_source: issuables
    params:
      issuable_type: issue
      issuable_state: opened
      filter_labels:
        - bug
      collection_labels:
        - S1
        - S2
        - S3
        - S4

query.group_by

query.group_by를 사용하여 차트의 X-축을 정의합니다.

지원되는 값:

• day: 일별 데이터 그룹화
• week: 주별 데이터 그룹화
• month: 월별 데이터 그룹화

query.period_limit

query.period_limit를 사용하여 시간 상의 얼마나 이전에 이슈들을 쿼리할지를 정의합니다 (query.period_field를 사용).

이 값은 query.group_by에 정의된 값을 기준으로 합니다. 예를 들어, query.group_by: 'day' 및 query.period_limit: 365를 정의한 경우, 차트에는 지난 365일간의 데이터가 표시됩니다.

기본적으로 query.group_by에 따라 기본값이 적용됩니다.

query.period_field

query.period_field를 사용하여 이슈들을 그룹화하는 데 사용할 타임스탬프 필드를 정의합니다.

지원되는 값:

• created_at (기본값): created_at 필드를 사용하여 데이터를 그룹화
• closed_at: closed_at 필드를 사용하여 데이터를 그룹화 (이슈 전용)
• merged_at: merged_at 필드를 사용하여 데이터를 그룹화 (병합 요청 전용)

period_field는 다음과 같이 자동 설정됩니다:

• query.issuable_state가 closed이면 closed_at
• query.issuable_state가 merged이면 merged_at
• 그 외에는 created_at

참고: 이 버그가 해결되기 전까지, merged_at 대신 created_at이 표시될 수 있습니다. created_at이 대신 사용됩니다.

DORA 쿼리 매개변수

• GitLab 15.3에서 도입됨.

dora 데이터 소스와 함께 DORA 차트 정의를 만들기 위해 DORA 특정 쿼리를 사용합니다.

예시:

dora:
  title: "DORA 차트"
  charts:
    - title: "DORA 배포 빈도"
      type: bar # 또는 line
      query:
        data_source: dora
        params:
          metric: deployment_frequency
          group_by: day
          period_limit: 10
      projects:
        only:
          - 38
    - title: "DORA 변경의 리드 타임"
      description: "DORA 변경의 리드 타임"
      type: bar
      query:
        data_source: dora
        params:
          metric: lead_time_for_changes
          group_by: day
          environment_tiers:
            - staging
          period_limit: 30

query.metric

query.metric을 사용하여 쿼리할 DORA 메트릭을 정의합니다.

지원되는 값:

• deployment_frequency (기본값)
• lead_time_for_changes
• time_to_restore_service
• change_failure_rate

query.group_by

query.group_by를 사용하여 차트의 X-축을 정의합니다.

지원되는 값:

• day (기본값): 일별 데이터 그룹화
• month: 월별 데이터 그룹화

query.period_limit

query.period_limit를 사용하여 과거 메트릭을 얼마나 쿼리할지를 정의합니다 (기본값: 15). 최대 기간은 180일 또는 6개월입니다.

query.environment_tiers

query.environment_tiers를 사용하여 계산에 포함할 환경의 배열을 정의합니다.

지원되는 값:

• production(기본값)
• staging
• testing
• development
• other

projects

이슈들이 쿼리되는 프로젝트를 제한하는 데 projects를 사용합니다:

• .gitlab/insights.yml이 그룹의 인사이트로 사용되는 경우, projects를 사용하여 이슈들을 쿼리할 프로젝트를 정의합니다. 기본적으로 그룹 아래의 모든 프로젝트가 사용됩니다.
• .gitlab/insights.yml이 프로젝트의 인사이트로 사용되는 경우, 다른 프로젝트를 지정해도 결과가 생성되지 않습니다. 기본적으로 프로젝트가 사용됩니다.

projects.only

projects.only을 사용하여 쿼리되는 이슈들의 프로젝트를 지정하세요.

이 매개변수에 나열된 프로젝트는 다음 경우에 무시됩니다.

• 프로젝트가 존재하지 않을 때.
• 현재 사용자가 읽을 권한이 충분하지 않을 때.
• 그룹 외부에 위치할 때.

예시:

monthlyBugsCreated:
  title: "매월 생성된 버그"
  description: "월별로 생성된 오픈된 버그"
  type: bar
  query:
    data_source: issuables
    params:
      issuable_type: issue
      issuable_state: opened
      filter_labels:
        - bug
  projects:
    only:
      - 3                         # 프로젝트 ID를 사용할 수 있습니다.
      - groupA/projectA           # 혹은 전체 프로젝트 경로
      - groupA/subgroupB/projectC # 하위 그룹의 프로젝트를 포함할 수 있습니다.
      - groupB/project            # 그룹 외부의 프로젝트는 무시됩니다.

완전한 인사이트 구성 예시

.projectsOnly: &projectsOnly
  projects:
    only:
      - 3
      - groupA/projectA
      - groupA/subgroupB/projectC

bugsCharts:
  title: "버그에 대한 차트"
  charts:
    - title: "매월 생성된 버그"
      description: "월별로 생성된 오픈된 버그"
      type: bar
      <<: *projectsOnly
      query:
        data_source: issuables
        params:
          issuable_type: issue
          issuable_state: opened
          filter_labels:
            - bug
          group_by: month
          period_limit: 24

    - title: "심각도에 따른 주간 버그"
      type: stacked-bar
      <<: *projectsOnly
      query:
        data_source: issuables
        params:
          issuable_type: issue
          issuable_state: opened
          filter_labels:
            - bug
          collection_labels:
            - S1
            - S2
            - S3
            - S4
          group_by: week
          period_limit: 104

    - title: "팀별 월간 버그"
      type: line
      <<: *projectsOnly
      query:
        data_source: issuables
        params:
          issuable_type: merge_request
          issuable_state: opened
          filter_labels:
            - bug
          collection_labels:
            - Manage
            - Plan
            - Create
          group_by: month
          period_limit: 24