InfoGrab DocsInfoGrab Docs

GLQL 표시 유형

요약

표시 유형은 임베드된 뷰가 GLQL 쿼리 결과를 렌더링하는 방식을 제어합니다. display 매개변수를 설정하지 않으면 결과는 목록으로 렌더링됩니다. 일부 표시 유형은 모든 쿼리에서 동작합니다. 다음 표시 유형은 모든 모드에서 사용할 수 있습니다.

히스토리
  • GitLab 17.4에서 glql_integration이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 18.3에서 일반적으로 사용 가능해졌습니다. 기능 플래그 glql_integration 이 제거되었습니다.

표시 유형은 임베드된 뷰가 GLQL 쿼리 결과를 렌더링하는 방식을 제어합니다. 표시 유형은 뷰 소스의 display 매개변수로 설정합니다.

display 매개변수를 설정하지 않으면 결과는 목록으로 렌더링됩니다.

일부 표시 유형은 모든 쿼리에서 동작합니다. 다른 유형은 데이터를 차원과 메트릭으로 집계하는 분석 모드에서만 동작합니다.

다음 표시 유형은 모든 모드에서 사용할 수 있습니다.

표시 유형 display 값 설명
테이블 table 결과당 한 행, 필드당 한 칼럼으로 구성된 테이블입니다.
목록 list 결과를 순서 없는 목록으로 표시합니다.
순서 있는 목록 orderedList 결과를 번호가 매겨진 목록으로 표시합니다.

다음 표시 유형은 분석 모드에서만 사용할 수 있습니다.

표시 유형 display 값 설명
단일 통계 stat 집계된 메트릭 하나를 큰 값으로 표시합니다.
칼럼 차트 columnChart 차원으로 정의한 카테고리 간에 메트릭을 비교하는 차트입니다.
바 차트 barChart 차원으로 정의한 카테고리 간에 메트릭을 비교하는 수평 차트입니다.
바 목록 barList 각 차원 값이 전체에서 차지하는 비중을 보여 주는 수평 차트입니다.
라인 차트 lineChart 추세를 보여 주기 위해 하나 이상의 메트릭을 차원에 따라 선으로 나타내는 차트입니다.
영역 차트 areaChart 추세와 규모를 보여 주기 위해 하나 이상의 메트릭을 차원에 따라 채워진 영역으로 나타내는 차트입니다.
히트 맵 heatMap 차원 값 쌍마다 하나씩 음영 처리된 셀로 구성된 격자이며, 셀이 어두울수록 값이 큽니다.
양방향 바 차트 divergingBarChart 공유 카테고리 칼럼을 중심으로 두 메트릭을 좌우로 마주 보게 배치하고, 각 메트릭을 그 절반의 가장 큰 막대에 맞춰 조정하는 차트입니다.

테이블#

히스토리
  • GitLab 19.5에서 동적 설명과 hiddenMetrics가 도입되었습니다.

테이블은 결과당 한 행, 필드당 한 칼럼으로 렌더링합니다.

칼럼을 기준으로 테이블을 정렬하려면 칼럼 헤더를 선택합니다. 이 뷰는 전체 결과 집합이 아니라 뷰에 로드된 행의 순서를 변경합니다.

테이블은 결과를 설명할 수 있습니다. 이 기능에는 분석 모드가 필요합니다. displayConfig 아래에 description을 설정하고, 칼럼에서 제외할 메트릭은 hiddenMetrics에 지정합니다. 플레이스홀더 구문과 규칙은 동적 설명을 참조합니다.

페이지 사이처럼 행이 바뀔 때도 칼럼 경계를 유지하려면 displayConfig 아래에 columnWidths를 설정합니다. 이 옵션은 칼럼 이름을 테이블 너비에 대한 백분율(1에서 100)에 매핑합니다. 너비를 지정하지 않은 칼럼은 남은 공간을 나눠 가집니다. 너비를 지정한 칼럼에 들어가지 않는 텍스트는 잘리며, 마우스를 올리면 전체 텍스트를 볼 수 있습니다.

displayConfig:
  columnWidths:
    group: 35
    project: 25

예시#

gitlab-org/gitlab 프로젝트에서 현재 사용자에게 할당된 열린 이슈 다섯 개를 title, state, health, epic, milestone, weight, updated 칼럼과 함께 테이블로 표시하려면 다음과 같이 작성합니다.

```glql
display: table
title: My open issues
fields: title, state, health, epic, milestone, weight, updated
limit: 5
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened
```

목록#

목록은 결과를 순서 없는 목록으로 렌더링합니다. 목록은 기본 표시 유형입니다.

예시#

gitlab-org/gitlab 프로젝트에서 현재 사용자에게 할당된 열린 이슈 다섯 개를 순서로 정렬하고 title, health, due 필드와 함께 목록으로 표시하려면 다음과 같이 작성합니다.

```glql
display: list
fields: title, health, due
limit: 5
sort: due asc
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened
```

순서 있는 목록#

순서 있는 목록은 결과를 번호가 매겨진 목록으로 렌더링합니다. 순위처럼 결과의 순서가 의미를 갖는 경우 순서 있는 목록을 사용합니다.

예시#

gitlab-org/gitlab 프로젝트에서 현재 사용자에게 할당된 열린 이슈 다섯 개를 순서로 정렬하고 title, health, due 필드와 함께 순서 있는 목록으로 표시하려면 다음과 같이 작성합니다.

```glql
display: orderedList
fields: title, health, due
limit: 5
sort: due asc
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened
```

단일 통계#

히스토리
  • GitLab 19.2에서 도입되었습니다.
  • GitLab 19.5에서 compact 표시 옵션이 도입되었습니다.
  • GitLab 19.5에서 동적 설명이 도입되었습니다.
  • GitLab 19.6에서 시간 구간 차원이 도입되었습니다.

단일 통계는 분석 모드의 집계된 메트릭 하나를 큰 값으로 시각화합니다. 합계나 비율처럼 핵심 숫자를 강조할 때 단일 통계를 사용합니다.

단일 통계에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 하나 이상의 메트릭을 metrics 매개변수로 설정합니다. 통계는 첫 번째 메트릭의 값을 표시하며, 설명에서 참조하지 않는 나머지 메트릭은 무시합니다.
  • dimensions가 없거나, created(granularity=30d)와 같은 시간 구간 차원이 정확히 하나 있어야 합니다.

시간 구간 차원이 있으면 통계는 가장 최근 구간의 값을 표시합니다. 통계는 구간을 날짜순으로 정렬하므로, sort는 어느 구간이 가장 최근인지에 영향을 주지 않습니다. 그 앞의 구간은 이전 기간이 되어 추세 배지로 표시됩니다. churnedUsersCount처럼 기간을 비교하는 메트릭에 사용합니다. 이러한 메트릭은 각 구간의 앞 구간과 비교해 계산되므로, 결과의 가장 앞 구간은 기준선일 뿐입니다. 통계는 결과에 이전 기간보다 앞선 구간도 있을 때만 추세 배지를 표시합니다.

값은 메트릭에 따라 자동으로 서식이 지정됩니다. 예를 들어 개수는 천 단위 구분 기호를 사용하고 비율은 백분율로 표시됩니다. 숫자를 1.45M과 같은 간략 표기로 렌더링하려면 displayConfig 아래에 compact: true를 설정합니다. 비율은 백분율 형식을 유지하고, 기간은 가장 큰 단위로 줄어듭니다. 예를 들어 1h 1m 1s는 1h가 됩니다.

값을 설명하려면 displayConfig 아래에 description을 설정합니다. 플레이스홀더 구문과 규칙은 동적 설명을 참조합니다.

예시#

지난 30일간 Code Suggestions 총 개수를 단일 통계로 표시하려면 다음과 같이 작성합니다.

```glql
display: stat
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
metrics: totalCount
```

쿼리가 선택한 다른 메트릭으로 값을 설명하려면 다음과 같이 작성합니다.

```glql
display: stat
displayConfig:
  description: "%{acceptedCount} of %{shownCount} suggestions accepted"
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
metrics: acceptanceRate, acceptedCount, shownCount
```

칼럼 차트#

히스토리
  • GitLab 19.1에서 도입되었습니다.
  • GitLab 19.5에서 maxSeries 표시 옵션이 도입되었습니다.

칼럼 차트는 분석 모드의 집계된 데이터를 시각화합니다. 차원으로 정의한 카테고리 간에 메트릭을 비교할 때 칼럼 차트를 사용합니다.

칼럼 차트에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 결과를 그룹화할 dimensions 한 개 또는 두 개.
  • 표시할 메트릭 하나 이상(metrics 매개변수 사용).

차원과 메트릭의 개수에 따라 차트가 렌더링되는 방식이 결정됩니다.

  • 차원 하나에 메트릭이 하나 이상이면 메트릭마다 칼럼을 그립니다. 이 칼럼들을 쌓으려면 displayConfig 아래에 stacked: true를 설정합니다. 메트릭이 하나면 stacked는 눈에 보이는 효과가 없습니다.
  • 차원 둘에 메트릭이 하나면 두 번째 차원으로 그룹화된 누적 칼럼 차트를 그립니다. 차원이 두 개면 메트릭은 하나만 사용할 수 있고, GitLab은 displayConfig.stacked를 무시합니다.

차원이 두 개이면 displayConfig 아래의 maxSeries 옵션이 두 번째 차원 값 중 자체 세그먼트를 갖는 값의 개수를 제한합니다. 합계가 가장 큰 값은 자체 세그먼트를 유지하고, 나머지는 Other (N) 세그먼트로 합쳐집니다. 제한을 넘는 값이 하나뿐이면 그대로 유지됩니다. maxSeries가 없으면 모든 값이 세그먼트를 갖습니다. 0보다 큰 정수가 아닌 maxSeries 값은 무시됩니다.

예시#

지난 30일간 언어별 Code Suggestions 사용량을 칼럼 차트로 표시하려면 다음과 같이 작성합니다.

```glql
display: columnChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount
```

메트릭을 나란히 그리는 대신 하나의 칼럼으로 쌓으려면 다음과 같이 작성합니다.

```glql
display: columnChart
displayConfig:
  stacked: true
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: acceptedCount, rejectedCount
```

바 차트#

히스토리
  • GitLab 19.2에서 도입되었습니다.
  • GitLab 19.4에서 categoryLabels, colorBy, showAxisTitles 표시 옵션이 도입되었습니다.

바 차트는 분석 모드의 집계된 데이터를 수평 막대로 시각화합니다. 특히 카테고리 레이블이 긴 경우, 차원으로 정의한 카테고리 간에 메트릭을 비교할 때 바 차트를 사용합니다.

바 차트에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 결과를 그룹화할 dimensions 한 개 또는 두 개.
  • 표시할 메트릭 하나 이상(metrics 매개변수 사용).

차원과 메트릭의 개수에 따라 차트가 렌더링되는 방식이 결정됩니다.

  • 차원 하나에 메트릭이 하나 이상이면 메트릭마다 막대를 그립니다. 이 막대들을 쌓으려면 displayConfig 아래에 stacked: true를 설정합니다. 메트릭이 하나면 stacked는 눈에 보이는 효과가 없습니다.
  • 차원 둘에 메트릭이 하나면 두 번째 차원으로 그룹화된 누적 바 차트를 그립니다. 차원이 두 개면 메트릭은 하나만 사용할 수 있고, GitLab은 displayConfig.stacked를 무시합니다.

바 차트는 첫 번째 행을 맨 아래에 그리므로, 가장 큰 값을 맨 위에 두려면 오름차순으로 정렬합니다. 차트의 높이는 행에 필요한 만큼이며, 기본 차트 높이까지입니다.

바 차트는 displayConfig 아래에서 다음 옵션도 받습니다.

  • categoryLabels: valueAndShare는 각 카테고리의 값과 전체에서 차지하는 비율을 카테고리 레이블 뒤에 덧붙입니다(예: Returning · 1,555 · 78%). 기본값인 plain은 카테고리 이름만 표시합니다. 이 옵션은 usersCount, totalCount, acceptedCount와 같은 개수 메트릭이면서 차원 하나와 메트릭 하나를 사용하는 경우에만 적용되며, 그 외에는 무시됩니다. 전체는 표시된 행의 합계이므로 비율의 합은 항상 표시된 값의 100%입니다. 비율은 각 항목이 정확히 하나의 카테고리에 속할 때만 의미가 있습니다. 예를 들어 usersCount에서 여러 카테고리에서 활동한 사용자는 각 행에서 한 번씩 집계되므로, 이 비율은 사용자의 비율이 아닙니다. 쿼리에서 limit를 사용하면 전체는 현재 페이지의 행만 포함합니다.
  • colorBy: category는 계열 전체에 한 가지 색을 쓰는 대신 각 막대에 파란색 계열의 고유한 단색 음영을 지정합니다. 맨 위 막대는 가장 진한 음영을 받으며, 라이트 모드에서는 가장 어둡고 다크 모드에서는 가장 밝은 음영이어서 어느 모드에서든 막대를 읽을 수 있습니다. 차원 하나와 메트릭 하나가 필요하며, 그 외에는 무시됩니다.
  • showAxisTitles: false는 두 축의 제목을 모두 숨깁니다.

예시#

지난 30일간 언어별 Code Suggestions 사용량을 바 차트로 표시하려면 다음과 같이 작성합니다.

```glql
display: barChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount
```

메트릭을 나란히 그리는 대신 하나의 막대로 쌓으려면 다음과 같이 작성합니다.

```glql
display: barChart
displayConfig:
  stacked: true
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: acceptedCount, rejectedCount
```

각 언어가 수락된 제안에서 차지하는 비율을 레이블이 있고 막대마다 색이 다른 형태로, 축 제목 없이 표시하려면 다음과 같이 작성합니다.

```glql
display: barChart
displayConfig:
  categoryLabels: valueAndShare
  colorBy: category
  showAxisTitles: false
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: acceptedCount
sort: acceptedCount asc
```

바 목록#

히스토리
  • GitLab 19.4에서 도입되었습니다.
  • GitLab 19.5에서 valueLabels, color, scale 표시 옵션이 도입되었습니다.
  • GitLab 19.5에서 차원이 없는 쿼리의 메트릭별 행과 color: gray가 도입되었습니다.
  • GitLab 19.5에서 차원 두 개의 누적 막대와 maxSeries 표시 옵션이 도입되었습니다.
  • GitLab 19.5에서 metricRows 표시 옵션이 도입되었습니다.
  • GitLab 19.5에서 동적 설명과 hiddenMetrics가 도입되었습니다.

바 목록은 분석 모드의 집계된 데이터를 수평 막대로 시각화합니다. 기본적으로 각 막대의 길이는 가장 큰 행과 비교한 값이 아니라 그 행이 전체 행 합계에서 차지하는 비율입니다. 바 목록은 "전체에서 이것이 차지하는 비중은 얼마인가"에 답하고, 바 차트는 "이들을 서로 비교하면 어떠한가"에 답합니다.

바 목록에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 최대 두 개의 dimensions 값.
  • metrics 매개변수로 설정하는 메트릭 하나 이상.

차원이 하나이면 각 행은 그 차원의 값이며, 첫 번째 메트릭이 행의 값을 결정합니다. 메트릭을 둘 이상 지정한 쿼리는 첫 번째 메트릭만 렌더링하고 나머지는 무시합니다. 행은 값의 내림차순으로 정렬됩니다. 차원이 세 개 이상이거나, 차원이 두 개이면서 메트릭이 둘 이상이면 뷰에서 유효성 검사 오류가 발생합니다.

차원이 없으면 각 메트릭이 하나의 행이 되며, 쿼리에서 지정한 순서를 따릅니다. 중앙값과 75번째 백분위수 병합 시간처럼 하나의 측정값에 대한 백분위수나 개수를 비교할 때 사용합니다. 각 행의 값은 해당 메트릭의 단위로 서식이 지정되므로, 기간은 밀리초 단위의 숫자가 아니라 9h 24m으로 표시됩니다. 이 행들은 순서를 유지하고, Other 행으로 합쳐지지 않으며, 이전 기간 대비 변화를 표시하지 않습니다. 머지 리퀘스트가 없는 백분위수처럼 응답에 값이 없는 메트릭은 빈 막대와 함께 엠 대시(—)로 렌더링됩니다.

일부 메트릭은 차원을 제거할 수 없습니다. returningUsersCount처럼 한 시간 구간을 이전 구간과 비교하는 메트릭에는 날짜 차원이 필요합니다. 차원이 있는 쿼리에서 메트릭당 한 행을 얻으려면 displayConfig 아래에 metricRows: true를 설정합니다. 값은 응답의 첫 번째 행에서 가져오므로, 원하는 행이 맨 앞에 오도록 쿼리를 정렬합니다. 이러한 메트릭 하나를 단일 숫자로 표시하려면 대신 단일 통계를 사용합니다.

차원이 있으면 displayConfig 아래의 maxRows 옵션이 페이지당 표시할 행 수를 설정합니다. 기본값은 6이며, 행은 값이 큰 순서로 순위가 매겨집니다. 쿼리가 더 많은 행을 반환하면 Previous와 Next 컨트롤이 이미 자동으로 가져온 행을 넘겨 보여 주므로, 페이지를 넘겨도 새로 가져오는 데이터는 없습니다. 가져오기는 1,000행에서 멈추므로 페이지 이동은 처음 1,000행까지만 다룹니다. 페이지 크기를 넘는 행이 하나뿐이면 새 페이지를 시작하지 않고 첫 페이지에 남습니다. 비율은 모든 페이지의 합계를 기준으로 유지됩니다. 0보다 큰 정수가 아닌 maxRows 값은 기본값으로 대체됩니다.

전체에서 차지하는 비중은 메트릭이 개수나 합계일 때만 의미가 있습니다. 평균이나 중앙값 같은 메트릭에서는 비중의 기준이 되는 합계에 의미가 없습니다.

차원이 없는 바 목록은 메트릭마다 막대 하나를 렌더링합니다. 막대를 만들지 않고 설명에만 사용할 메트릭을 선택하려면 displayConfig 아래의 hiddenMetrics에 추가합니다. 플레이스홀더 구문과 hiddenMetrics 규칙은 동적 설명을 참조합니다.

차원 하나#

각 행은 차원의 값 하나입니다.

각 행의 레이블은 막대 끝 뒤에 값을 표시하며, displayConfig 아래의 valueLabels로 제어합니다.

  • valueLabels: shareAndValue가 기본값입니다. 행이 전체에서 차지하는 비율과 간략한 값을 표시합니다(예: 89% · 85.6k).
  • valueLabels: value는 행의 값만 전체 자릿수로 표시합니다(예: 1,071). 비율보다 개수가 더 중요할 때 사용합니다.

막대 색은 displayConfig 아래의 color로 설정합니다.

  • color: orange가 기본값이며 기존 모양과 같습니다.
  • color: blue는 다른 GLQL 차트가 첫 번째 계열에 쓰는 파란색, 즉 차트 팔레트의 기본 색으로 막대를 그립니다.
  • color: gray는 색이 있는 목록 옆에 기준선을 표시할 때 쓰는 중립 회색 막대를 그립니다.

막대 길이는 displayConfig 아래의 scale로 설정하는 척도를 기준으로 측정합니다.

  • scale: total이 기본값입니다. 막대의 길이는 그 행이 전체 행 합계에서 차지하는 비율이므로, 트랙은 전체의 100%를 나타내고 막대 뒤의 빈 공간은 나머지 합계를 나타냅니다.
  • scale: max는 가장 큰 행이 트랙을 가득 채우고 다른 모든 막대는 이에 상대적으로 크기가 정해져, 막대가 행끼리 서로 비교됩니다. 행이 많거나 고르게 분포되어 전체에 대한 비율로는 모든 막대가 짧아질 때 사용합니다.

레이블은 scale의 영향을 받지 않습니다. valueLabels: shareAndValue에서는 scale과 관계없이 전체에서 차지하는 비율을 계속 표시합니다.

valueLabels, color, scale에 다른 값을 지정하면 뷰에서 유효성 검사 오류가 발생합니다.

차원 두 개#

각 행은 첫 번째 차원의 값이며, 막대는 두 번째 차원의 값마다 하나씩 누적 세그먼트로 나뉘고 차트 아래에 범례가 표시됩니다. 행의 레이블은 간략한 합계입니다.

displayConfig 아래의 maxSeries 옵션이 두 번째 차원 값 중 자체 세그먼트를 갖는 값의 개수를 제한하며, 나머지는 Other (N) 세그먼트로 합쳐집니다. 제한을 넘는 세그먼트가 하나뿐이면 그대로 유지됩니다. 기본값은 6입니다.

행은 차원 하나일 때와 같은 maxRows 및 컨트롤로 페이지가 나뉘며, 각 행은 세그먼트를 유지합니다.

범례 항목을 선택하면 해당 세그먼트가 숨겨지고, 남은 막대와 레이블의 크기가 보이는 합계에 맞게 다시 조정됩니다.

valueLabels, color, scale 옵션과 이전 기간 비교는 차원이 하나일 때만 적용됩니다.

예시#

지난 30일간 언어별 Code Suggestions 사용량을 바 목록으로 표시하려면 다음과 같이 작성합니다.

```glql
display: barList
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount
```

기본값인 여섯 개보다 많은 행을 표시하려면 다음과 같이 작성합니다.

```glql
display: barList
displayConfig:
  maxRows: 10
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount
```

지난 30일간 Duo Agent Platform 세션을 플로 유형별로, 각 레이블에는 값만 표시하고 막대는 전체가 아닌 가장 큰 행을 기준으로 크기를 정해 파란색으로 표시하려면 다음과 같이 작성합니다.

```glql
display: barList
displayConfig:
  valueLabels: value
  color: blue
  scale: max
mode: analytics
query: type = AgentPlatformSession and created >= -30d
dimensions: flowType
metrics: usersCount
```

지난 30일간 병합된 머지 리퀘스트의 병합 시간 중앙값과 75번째 백분위수를 백분위수당 한 행으로, 더 긴 막대가 트랙을 가득 채우게 비교하려면 다음과 같이 작성합니다.

```glql
display: barList
displayConfig:
  valueLabels: value
  scale: max
mode: analytics
query: type = MergeRequest and merged >= -30d
metrics: timeToMergeQuantile(0.5) as "Median", timeToMergeQuantile(0.75) as "p75"
```

한 기간에 활동한 사용자를 이전 기간에도 세션이 있었던 사용자와 없었던 사용자로 나누어 각각 한 행으로 표시하려면 다음과 같이 작성합니다. returningUsersCount는 이전 기간 없이는 비교 대상이 없으므로 쿼리는 연속된 30일 기간 두 개를 다루며, metricRows가 나중 구간을 읽도록 가장 최신 버킷을 먼저 정렬합니다. origin은 버킷을 범위의 시작에 고정하여 Unix 에포크부터 세지 않고 범위에 맞게 정렬합니다.

```glql
display: barList
displayConfig:
  metricRows: true
mode: analytics
query: type = DuoWorkflow and created >= 2026-07-16 and created < 2026-09-14
dimensions: created(granularity=30d, origin=2026-07-16)
metrics: joinedUsersCount as "New", returningUsersCount as "Returning"
sort: created desc
```

지난 30일간 사용자별 세션을 플로 유형별로 나누되, 자체 세그먼트를 갖는 플로 유형을 최대 네 개로 제한하려면 다음과 같이 작성합니다.

```glql
display: barList
displayConfig:
  maxSeries: 4
mode: analytics
query: type = AgentPlatformSession and created >= -30d
dimensions: user, flowType
metrics: totalCount
```

라인 차트#

히스토리
  • GitLab 19.1에서 도입되었습니다.

라인 차트는 분석 모드의 집계된 데이터를 하나 이상의 선으로 시각화합니다. 시간 경과처럼 차원에 따라 메트릭이 어떻게 변하는지 보여줄 때 라인 차트를 사용합니다.

라인 차트에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • x축에 사용할 dimension 정확히 하나.
  • 표시할 metric 하나 이상. 각 메트릭은 별도의 선으로 렌더링됩니다.

예시#

지난 30일간 언어별 Code Suggestions 사용량을 라인 차트로 표시하고, 전체 제안 수와 수락된 제안 수를 각각 한 개의 선으로 나타내려면 다음과 같이 작성합니다.

```glql
display: lineChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount, acceptedCount
```

영역 차트#

히스토리
  • GitLab 19.3에서 도입되었습니다.

영역 차트는 분석 모드의 집계된 데이터를 하나 이상의 채워진 영역으로 시각화합니다. 시간 경과처럼 차원에 따라 메트릭이 어떻게 변하는지 보여주고, 추세 이면의 규모를 강조할 때 영역 차트를 사용합니다.

영역 차트에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 결과를 그룹화할 dimensions 한 개 또는 두 개.
  • 표시할 메트릭 하나 이상(metrics 매개변수 사용).

차원과 메트릭의 개수에 따라 차트가 렌더링되는 방식이 결정됩니다.

  • 차원 하나에 메트릭이 하나 이상이면 메트릭마다 영역을 그립니다. 영역은 반투명하게 채워진 채로 겹칩니다. 대신 영역을 누적해 쌓으려면 displayConfig 아래에 stacked: true를 설정합니다. 메트릭이 하나면 stacked는 눈에 보이는 효과가 없습니다.
  • 차원 둘에 메트릭이 하나면 두 번째 차원으로 그룹화된 누적 영역 차트를 그립니다. 차원이 두 개면 메트릭은 하나만 사용할 수 있고, GitLab은 displayConfig.stacked를 무시합니다.

예시#

지난 30일간 표시된 Code Suggestions와 수락된 Code Suggestions를 겹치는 영역으로 표시하려면 다음과 같이 작성합니다.

```glql
display: areaChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: timestamp
metrics: shownCount, acceptedCount
```

대신 메트릭을 누적해 쌓으려면 다음과 같이 작성합니다.

```glql
display: areaChart
displayConfig:
  stacked: true
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: timestamp
metrics: shownCount, acceptedCount
```

히트 맵#

히스토리
  • GitLab 19.4에서 도입되었습니다.
  • GitLab 19.5에서 maxColumns 및 maxRows 표시 옵션이 도입되었습니다.

히트 맵은 분석 모드의 집계된 데이터를 차원 값 쌍마다 셀 하나씩 음영 처리한 격자로 시각화합니다. 두 차원에 걸쳐 메트릭 하나를 한 번에 비교하고, 가장 큰 값이 어디에 있는지 확인할 때 히트 맵을 사용합니다.

히트 맵에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 결과를 그룹화할 dimensions 정확히 두 개. 첫 번째는 칼럼 방향으로, 두 번째는 행 방향으로 배치됩니다.
  • 셀의 음영 기준이 되는 메트릭 정확히 하나(metrics 매개변수 사용).

각 셀에는 값이 표시되며, 값이 커질수록 밝은 색에서 어두운 색으로 음영이 짙어집니다. 음영은 결과의 값에서 도출한 고정 구간을 사용하므로, 셀이 어두우면 항상 값이 더 큽니다. 값이 아예 없는 셀은 가장 밝은 색이 아니라 중립적인 회색으로 표시되므로, 작은 값을 값이 없는 셀로 착각하지 않습니다. 셀에 마우스를 올리면 해당 행, 칼럼, 정확한 값이 표시됩니다.

격자 위쪽 패널에 설명을 넣으려면 displayConfig 아래에 description을 설정합니다.

격자가 그리는 차원 값의 개수를 제한하려면 displayConfig 아래에 maxColumns 또는 maxRows를 설정합니다. maxColumns는 칼럼을 따라 배치되는 첫 번째 차원의 개수를, maxRows는 행을 따라 배치되는 두 번째 차원의 개수를 제한합니다. 유지되는 값은 다른 축에 걸쳐 메트릭을 합산한 값을 기준으로 가장 큰 값이며, 제한이 적용된 축은 큰 값부터 정렬되고 동률은 레이블로 정렬됩니다. 이 정렬은 해당 축에 sort가 지정한 순서를 대체합니다. 다른 축은 계속 쿼리를 따릅니다.

제한을 넘는 값은 제외되며 격자에는 값이 빠졌다는 표시가 없으므로, 패널 제목이나 설명에 제한을 명시합니다. 두 옵션 모두 기본값이 없으며, 0보다 큰 정수가 아닌 값은 무시됩니다.

예시#

지난 30일간 IDE 별, 언어별 Code Suggestion 양을 비교하려면 다음과 같이 작성합니다.

```glql
display: heatMap
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: ideName, language
metrics: totalCount
```

격자 위에 설명을 추가하려면 다음과 같이 작성합니다.

```glql
display: heatMap
displayConfig:
  description: Code Suggestions accepted per language, by IDE.
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: ideName, language
metrics: acceptedCount
```

가장 바쁜 IDE 다섯 개만 표시하려면 다음과 같이 작성합니다.

```glql
display: heatMap
displayConfig:
  description: Code Suggestions accepted per language, for the five busiest IDEs.
  maxColumns: 5
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: ideName, language
metrics: acceptedCount
```

양방향 바 차트#

양방향 바 차트는 분석 모드의 집계된 데이터를 가운데에 놓인 공유 카테고리 칼럼을 기준으로 두 메트릭이 서로 마주 보게 시각화합니다. 첫 번째 메트릭의 막대는 중앙에서 왼쪽으로, 두 번째 메트릭의 막대는 오른쪽으로 자랍니다. 한 메트릭이 절대값에서 다른 메트릭을 압도할 수 있을 때, 카테고리 간에 두 메트릭을 비교하려면 양방향 바 차트를 사용합니다.

차트의 각 절반은 그 절반의 가장 큰 막대에 맞춰 독립적으로 조정됩니다. 따라서 어떤 카테고리가 한 메트릭에서는 작은 비중이고 다른 메트릭에서는 대부분을 차지하더라도, 두 막대 모두 차트의 자기 쪽을 가득 채웁니다. 두 절반이 서로 다른 축척을 쓰기 때문에 막대 길이는 같은 절반 안에서만 비교할 수 있고, 중앙을 넘어서는 비교할 수 없습니다.

양방향 바 차트에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 결과를 그룹화할 dimensions 값 정확히 하나.
  • 표시할 메트릭 정확히 두 개(metrics 매개변수 사용).

차원이 정확히 하나, 메트릭이 정확히 두 개가 아니면 뷰에서 검증 오류가 발생합니다.

행은 쿼리가 반환한 순서대로 렌더링됩니다. 양방향 바 차트는 자체적으로 행을 정렬하지 않으므로 이 순서는 sort로 제어합니다. 각 메트릭의 값은 해당 메트릭의 고유 단위로 서식이 지정되므로, 개수와 비율을 함께 묶을 수 있습니다.

카테고리 칼럼은 차트 너비의 일부를 차지하므로, 들어가지 않는 카테고리 레이블은 잘립니다. 패널이 좁으면 카테고리 이름을 짧게 유지합니다.

이 표시 유형에는 displayConfig 옵션이 없습니다.

예시#

지난 30일간 GitLab Duo Agent Platform의 고유 사용자 수와 전체 세션 수를 플로 유형별로 그룹화해 비교하려면 다음과 같이 작성합니다.

```glql
display: divergingBarChart
mode: analytics
query: type = AgentPlatformSession and created >= -30d
dimensions: flowType
metrics: usersCount, totalCount
sort: totalCount desc
```

동적 설명#

히스토리
  • GitLab 19.5에서 단일 통계의 동적 설명이 도입되었습니다.
  • GitLab 19.5에서 바 목록과 테이블의 동적 설명이 도입되었습니다.
  • GitLab 19.5에서 바 목록과 테이블의 hiddenMetrics가 도입되었습니다.

stat, barList, table 표시 유형은 분석 모드에서 동적 설명을 지원합니다. 설명을 사용해 시각화와 함께 결과를 한 문장으로 요약합니다.

결과를 설명하려면 displayConfig 아래에 description을 설정합니다. 설명에는 %{metricName} 플레이스홀더를 포함할 수 있으며, metricName은 metrics의 메트릭을 식별합니다. GitLab은 각 플레이스홀더를 해당 메트릭의 값으로 바꾸며, 값은 그 메트릭 고유의 단위로 서식이 지정됩니다. 쿼리가 선택하지 않은 메트릭을 지정한 플레이스홀더는 유효성 검사 오류를 표시합니다. 응답에 메트릭의 값이 없으면 해당 플레이스홀더는 엠 대시(—)로 렌더링됩니다.

메트릭은 항상 키 이름으로 식별하며, 매개변수가 있는 메트릭이 중복된 경우에만 별칭을 사용해 식별해야 합니다. 예를 들어 metrics: totalCount as "count"는 별칭이 레이블만 설정하므로 여전히 %{totalCount}로 참조합니다. 같은 메트릭이 서로 다른 매개변수로 두 번 나타나는 경우, 예를 들어 metrics: durationQuantile(0.5) as "Median", durationQuantile(0.95) as "p95 duration"에서는 각 별칭이 키가 되므로 %{Median}과 %{p95 duration}로 참조합니다.

바 목록과 테이블에서는 쿼리에 dimensions가 있으면 설명에 플레이스홀더를 사용할 수 없습니다. 사용하면 뷰에서 Description placeholders cannot be used with dimensions. 유효성 검사 오류가 발생합니다. 플레이스홀더는 단일 행을 읽으므로, 차원이 있으면 한 그룹의 값이 모든 그룹을 대표하는 것처럼 표시됩니다. 플레이스홀더가 없는 설명은 차원이 있어도 계속 동작합니다.

바 목록과 테이블에서는 displayConfig 아래의 hiddenMetrics를 막대나 칼럼에서 제외할 메트릭 목록으로 설정합니다. 플레이스홀더와 같은 방식으로 이름을 지정합니다. durationQuantile처럼 중복된 메트릭을 기본 이름으로 지정하면 그 메트릭의 모든 사본이 숨겨집니다. GitLab은 이러한 메트릭을 계속 실행하므로 설명에서 인용할 수 있습니다. 목록이 아닌 hiddenMetrics 값이나 쿼리의 메트릭이 아닌 이름은 뷰에서 유효성 검사 오류를 일으킵니다. 바 목록에는 hiddenMetrics에서 제외되지 않은 메트릭이 하나 이상 필요합니다.

설명은 시각화 위에 렌더링됩니다. 쿼리를 불러오는 동안 플레이스홀더가 포함된 설명은 숨겨지므로, 아직 없는 값 때문에 엠 대시가 깜박이는 일은 없습니다.

예시#

GitLab Duo가 생성한 머지 리퀘스트의 병합 시간 중앙값과 75번째 백분위수를 그리고, 세 번째 막대를 그리지 않으면서 병합된 건수를 인용하려면 다음과 같이 작성합니다.

```glql
display: barList
mode: analytics
query: type = MergeRequest and createdByDuo = true and merged >= -30d
metrics: timeToMergeQuantile(0.5) as "Median", timeToMergeQuantile(0.75) as "p75", throughputCount
displayConfig:
  description: "%{throughputCount} merged merge requests"
  hiddenMetrics: [throughputCount]
```

페이지네이션 지원#

히스토리
  • GitLab 19.5에서 분석 모드 시각화의 자동 페이지네이션이 도입되었습니다.
  • GitLab 19.6에서 분석 모드 테이블의 Previous 및 Next 페이지 이동이 도입되었습니다.
  • GitLab 19.6에서 columnWidths가 도입되었습니다.
  • GitLab 19.6에서 limit가 있는 분석 모드 차트의 Previous 및 Next 컨트롤이 도입되었습니다.

모든 모드에서 사용할 수 있는 표시 유형은 결과의 첫 페이지를 표시하고 추가 페이지를 가져오는 Load more 액션을 제공합니다. 자세한 내용은 페이지네이션을 참고합니다.

분석 모드의 테이블은 limit개 행(기본값 20)으로 이루어진 한 페이지를 Previous 및 Next 컨트롤과 함께 표시합니다. Next는 다음 페이지를 가져오고, Previous는 이미 가져온 페이지로 돌아갑니다. 칼럼을 기준으로 정렬하면 현재 페이지의 행이 정렬됩니다.

차트와 통계 같은 분석 모드 집계 시각화는 Load more 작업을 제공하지 않습니다. 집계 결과의 모든 페이지를 최대 1,000행까지 자동으로 가져옵니다.

쿼리가 1,000행을 넘는 집계 행을 반환하면 시각화는 처음 1,000행을 표시합니다. 모든 데이터를 보려면 쿼리에 필터를 추가하거나 더 적은 차원으로 그룹화합니다.

차트 페이지 이동#

칼럼, 라인, 바, 영역, 양방향 바 차트에 limit를 설정하면 첫 번째 차원의 값을 그 개수만큼씩 표시합니다. Previous 및 Next 컨트롤로 나머지를 넘겨 봅니다. 각 페이지는 해당 값의 모든 행을 표시하므로, 차원이 둘이면 막대에 항상 전체 세부 구성이 표시됩니다. 차원이 둘이면 범례는 모든 페이지에서 모든 계열을 나열하므로 각 계열이 같은 색을 유지합니다. 컨트롤은 이미 가져온 행을 넘겨 보므로 페이지를 넘겨도 새로 가져오는 데이터는 없으며, 페이지 이동은 처음 1,000행까지만 다룹니다. 모든 값이 한 페이지에 들어가면 컨트롤이 표시되지 않습니다.

stat, barList, heatMap에서는 limit가 대신 그 개수의 행으로 이루어진 한 페이지를 가져오며, 최대 100행까지 가능합니다.

GLQL 표시 유형

GitLab v19.6
Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

표시 유형은 임베드된 뷰가 GLQL 쿼리 결과를 렌더링하는 방식을 제어합니다. display 매개변수를 설정하지 않으면 결과는 목록으로 렌더링됩니다. 일부 표시 유형은 모든 쿼리에서 동작합니다. 다음 표시 유형은 모든 모드에서 사용할 수 있습니다.

히스토리
  • GitLab 17.4에서 glql_integration이라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 18.3에서 일반적으로 사용 가능해졌습니다. 기능 플래그 glql_integration 이 제거되었습니다.

표시 유형은 임베드된 뷰가 GLQL 쿼리 결과를 렌더링하는 방식을 제어합니다. 표시 유형은 뷰 소스의 display 매개변수로 설정합니다.

display 매개변수를 설정하지 않으면 결과는 목록으로 렌더링됩니다.

일부 표시 유형은 모든 쿼리에서 동작합니다. 다른 유형은 데이터를 차원과 메트릭으로 집계하는 분석 모드에서만 동작합니다.

다음 표시 유형은 모든 모드에서 사용할 수 있습니다.

표시 유형 display 값 설명
테이블 table 결과당 한 행, 필드당 한 칼럼으로 구성된 테이블입니다.
목록 list 결과를 순서 없는 목록으로 표시합니다.
순서 있는 목록 orderedList 결과를 번호가 매겨진 목록으로 표시합니다.

다음 표시 유형은 분석 모드에서만 사용할 수 있습니다.

표시 유형 display 값 설명
단일 통계 stat 집계된 메트릭 하나를 큰 값으로 표시합니다.
칼럼 차트 columnChart 차원으로 정의한 카테고리 간에 메트릭을 비교하는 차트입니다.
바 차트 barChart 차원으로 정의한 카테고리 간에 메트릭을 비교하는 수평 차트입니다.
바 목록 barList 각 차원 값이 전체에서 차지하는 비중을 보여 주는 수평 차트입니다.
라인 차트 lineChart 추세를 보여 주기 위해 하나 이상의 메트릭을 차원에 따라 선으로 나타내는 차트입니다.
영역 차트 areaChart 추세와 규모를 보여 주기 위해 하나 이상의 메트릭을 차원에 따라 채워진 영역으로 나타내는 차트입니다.
히트 맵 heatMap 차원 값 쌍마다 하나씩 음영 처리된 셀로 구성된 격자이며, 셀이 어두울수록 값이 큽니다.
양방향 바 차트 divergingBarChart 공유 카테고리 칼럼을 중심으로 두 메트릭을 좌우로 마주 보게 배치하고, 각 메트릭을 그 절반의 가장 큰 막대에 맞춰 조정하는 차트입니다.

테이블#

히스토리
  • GitLab 19.5에서 동적 설명과 hiddenMetrics가 도입되었습니다.

테이블은 결과당 한 행, 필드당 한 칼럼으로 렌더링합니다.

칼럼을 기준으로 테이블을 정렬하려면 칼럼 헤더를 선택합니다. 이 뷰는 전체 결과 집합이 아니라 뷰에 로드된 행의 순서를 변경합니다.

테이블은 결과를 설명할 수 있습니다. 이 기능에는 분석 모드가 필요합니다. displayConfig 아래에 description을 설정하고, 칼럼에서 제외할 메트릭은 hiddenMetrics에 지정합니다. 플레이스홀더 구문과 규칙은 동적 설명을 참조합니다.

페이지 사이처럼 행이 바뀔 때도 칼럼 경계를 유지하려면 displayConfig 아래에 columnWidths를 설정합니다. 이 옵션은 칼럼 이름을 테이블 너비에 대한 백분율(1에서 100)에 매핑합니다. 너비를 지정하지 않은 칼럼은 남은 공간을 나눠 가집니다. 너비를 지정한 칼럼에 들어가지 않는 텍스트는 잘리며, 마우스를 올리면 전체 텍스트를 볼 수 있습니다.

displayConfig:
  columnWidths:
    group: 35
    project: 25

예시#

gitlab-org/gitlab 프로젝트에서 현재 사용자에게 할당된 열린 이슈 다섯 개를 title, state, health, epic, milestone, weight, updated 칼럼과 함께 테이블로 표시하려면 다음과 같이 작성합니다.

```glql
display: table
title: My open issues
fields: title, state, health, epic, milestone, weight, updated
limit: 5
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened
```

목록#

목록은 결과를 순서 없는 목록으로 렌더링합니다. 목록은 기본 표시 유형입니다.

예시#

gitlab-org/gitlab 프로젝트에서 현재 사용자에게 할당된 열린 이슈 다섯 개를 순서로 정렬하고 title, health, due 필드와 함께 목록으로 표시하려면 다음과 같이 작성합니다.

```glql
display: list
fields: title, health, due
limit: 5
sort: due asc
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened
```

순서 있는 목록#

순서 있는 목록은 결과를 번호가 매겨진 목록으로 렌더링합니다. 순위처럼 결과의 순서가 의미를 갖는 경우 순서 있는 목록을 사용합니다.

예시#

gitlab-org/gitlab 프로젝트에서 현재 사용자에게 할당된 열린 이슈 다섯 개를 순서로 정렬하고 title, health, due 필드와 함께 순서 있는 목록으로 표시하려면 다음과 같이 작성합니다.

```glql
display: orderedList
fields: title, health, due
limit: 5
sort: due asc
query: type = Issue AND project = "gitlab-org/gitlab" AND assignee = currentUser() AND state = opened
```

단일 통계#

히스토리
  • GitLab 19.2에서 도입되었습니다.
  • GitLab 19.5에서 compact 표시 옵션이 도입되었습니다.
  • GitLab 19.5에서 동적 설명이 도입되었습니다.
  • GitLab 19.6에서 시간 구간 차원이 도입되었습니다.

단일 통계는 분석 모드의 집계된 메트릭 하나를 큰 값으로 시각화합니다. 합계나 비율처럼 핵심 숫자를 강조할 때 단일 통계를 사용합니다.

단일 통계에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 하나 이상의 메트릭을 metrics 매개변수로 설정합니다. 통계는 첫 번째 메트릭의 값을 표시하며, 설명에서 참조하지 않는 나머지 메트릭은 무시합니다.
  • dimensions가 없거나, created(granularity=30d)와 같은 시간 구간 차원이 정확히 하나 있어야 합니다.

시간 구간 차원이 있으면 통계는 가장 최근 구간의 값을 표시합니다. 통계는 구간을 날짜순으로 정렬하므로, sort는 어느 구간이 가장 최근인지에 영향을 주지 않습니다. 그 앞의 구간은 이전 기간이 되어 추세 배지로 표시됩니다. churnedUsersCount처럼 기간을 비교하는 메트릭에 사용합니다. 이러한 메트릭은 각 구간의 앞 구간과 비교해 계산되므로, 결과의 가장 앞 구간은 기준선일 뿐입니다. 통계는 결과에 이전 기간보다 앞선 구간도 있을 때만 추세 배지를 표시합니다.

값은 메트릭에 따라 자동으로 서식이 지정됩니다. 예를 들어 개수는 천 단위 구분 기호를 사용하고 비율은 백분율로 표시됩니다. 숫자를 1.45M과 같은 간략 표기로 렌더링하려면 displayConfig 아래에 compact: true를 설정합니다. 비율은 백분율 형식을 유지하고, 기간은 가장 큰 단위로 줄어듭니다. 예를 들어 1h 1m 1s는 1h가 됩니다.

값을 설명하려면 displayConfig 아래에 description을 설정합니다. 플레이스홀더 구문과 규칙은 동적 설명을 참조합니다.

예시#

지난 30일간 Code Suggestions 총 개수를 단일 통계로 표시하려면 다음과 같이 작성합니다.

```glql
display: stat
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
metrics: totalCount
```

쿼리가 선택한 다른 메트릭으로 값을 설명하려면 다음과 같이 작성합니다.

```glql
display: stat
displayConfig:
  description: "%{acceptedCount} of %{shownCount} suggestions accepted"
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
metrics: acceptanceRate, acceptedCount, shownCount
```

칼럼 차트#

히스토리
  • GitLab 19.1에서 도입되었습니다.
  • GitLab 19.5에서 maxSeries 표시 옵션이 도입되었습니다.

칼럼 차트는 분석 모드의 집계된 데이터를 시각화합니다. 차원으로 정의한 카테고리 간에 메트릭을 비교할 때 칼럼 차트를 사용합니다.

칼럼 차트에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 결과를 그룹화할 dimensions 한 개 또는 두 개.
  • 표시할 메트릭 하나 이상(metrics 매개변수 사용).

차원과 메트릭의 개수에 따라 차트가 렌더링되는 방식이 결정됩니다.

  • 차원 하나에 메트릭이 하나 이상이면 메트릭마다 칼럼을 그립니다. 이 칼럼들을 쌓으려면 displayConfig 아래에 stacked: true를 설정합니다. 메트릭이 하나면 stacked는 눈에 보이는 효과가 없습니다.
  • 차원 둘에 메트릭이 하나면 두 번째 차원으로 그룹화된 누적 칼럼 차트를 그립니다. 차원이 두 개면 메트릭은 하나만 사용할 수 있고, GitLab은 displayConfig.stacked를 무시합니다.

차원이 두 개이면 displayConfig 아래의 maxSeries 옵션이 두 번째 차원 값 중 자체 세그먼트를 갖는 값의 개수를 제한합니다. 합계가 가장 큰 값은 자체 세그먼트를 유지하고, 나머지는 Other (N) 세그먼트로 합쳐집니다. 제한을 넘는 값이 하나뿐이면 그대로 유지됩니다. maxSeries가 없으면 모든 값이 세그먼트를 갖습니다. 0보다 큰 정수가 아닌 maxSeries 값은 무시됩니다.

예시#

지난 30일간 언어별 Code Suggestions 사용량을 칼럼 차트로 표시하려면 다음과 같이 작성합니다.

```glql
display: columnChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount
```

메트릭을 나란히 그리는 대신 하나의 칼럼으로 쌓으려면 다음과 같이 작성합니다.

```glql
display: columnChart
displayConfig:
  stacked: true
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: acceptedCount, rejectedCount
```

바 차트#

히스토리
  • GitLab 19.2에서 도입되었습니다.
  • GitLab 19.4에서 categoryLabels, colorBy, showAxisTitles 표시 옵션이 도입되었습니다.

바 차트는 분석 모드의 집계된 데이터를 수평 막대로 시각화합니다. 특히 카테고리 레이블이 긴 경우, 차원으로 정의한 카테고리 간에 메트릭을 비교할 때 바 차트를 사용합니다.

바 차트에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 결과를 그룹화할 dimensions 한 개 또는 두 개.
  • 표시할 메트릭 하나 이상(metrics 매개변수 사용).

차원과 메트릭의 개수에 따라 차트가 렌더링되는 방식이 결정됩니다.

  • 차원 하나에 메트릭이 하나 이상이면 메트릭마다 막대를 그립니다. 이 막대들을 쌓으려면 displayConfig 아래에 stacked: true를 설정합니다. 메트릭이 하나면 stacked는 눈에 보이는 효과가 없습니다.
  • 차원 둘에 메트릭이 하나면 두 번째 차원으로 그룹화된 누적 바 차트를 그립니다. 차원이 두 개면 메트릭은 하나만 사용할 수 있고, GitLab은 displayConfig.stacked를 무시합니다.

바 차트는 첫 번째 행을 맨 아래에 그리므로, 가장 큰 값을 맨 위에 두려면 오름차순으로 정렬합니다. 차트의 높이는 행에 필요한 만큼이며, 기본 차트 높이까지입니다.

바 차트는 displayConfig 아래에서 다음 옵션도 받습니다.

  • categoryLabels: valueAndShare는 각 카테고리의 값과 전체에서 차지하는 비율을 카테고리 레이블 뒤에 덧붙입니다(예: Returning · 1,555 · 78%). 기본값인 plain은 카테고리 이름만 표시합니다. 이 옵션은 usersCount, totalCount, acceptedCount와 같은 개수 메트릭이면서 차원 하나와 메트릭 하나를 사용하는 경우에만 적용되며, 그 외에는 무시됩니다. 전체는 표시된 행의 합계이므로 비율의 합은 항상 표시된 값의 100%입니다. 비율은 각 항목이 정확히 하나의 카테고리에 속할 때만 의미가 있습니다. 예를 들어 usersCount에서 여러 카테고리에서 활동한 사용자는 각 행에서 한 번씩 집계되므로, 이 비율은 사용자의 비율이 아닙니다. 쿼리에서 limit를 사용하면 전체는 현재 페이지의 행만 포함합니다.
  • colorBy: category는 계열 전체에 한 가지 색을 쓰는 대신 각 막대에 파란색 계열의 고유한 단색 음영을 지정합니다. 맨 위 막대는 가장 진한 음영을 받으며, 라이트 모드에서는 가장 어둡고 다크 모드에서는 가장 밝은 음영이어서 어느 모드에서든 막대를 읽을 수 있습니다. 차원 하나와 메트릭 하나가 필요하며, 그 외에는 무시됩니다.
  • showAxisTitles: false는 두 축의 제목을 모두 숨깁니다.

예시#

지난 30일간 언어별 Code Suggestions 사용량을 바 차트로 표시하려면 다음과 같이 작성합니다.

```glql
display: barChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount
```

메트릭을 나란히 그리는 대신 하나의 막대로 쌓으려면 다음과 같이 작성합니다.

```glql
display: barChart
displayConfig:
  stacked: true
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: acceptedCount, rejectedCount
```

각 언어가 수락된 제안에서 차지하는 비율을 레이블이 있고 막대마다 색이 다른 형태로, 축 제목 없이 표시하려면 다음과 같이 작성합니다.

```glql
display: barChart
displayConfig:
  categoryLabels: valueAndShare
  colorBy: category
  showAxisTitles: false
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: acceptedCount
sort: acceptedCount asc
```

바 목록#

히스토리
  • GitLab 19.4에서 도입되었습니다.
  • GitLab 19.5에서 valueLabels, color, scale 표시 옵션이 도입되었습니다.
  • GitLab 19.5에서 차원이 없는 쿼리의 메트릭별 행과 color: gray가 도입되었습니다.
  • GitLab 19.5에서 차원 두 개의 누적 막대와 maxSeries 표시 옵션이 도입되었습니다.
  • GitLab 19.5에서 metricRows 표시 옵션이 도입되었습니다.
  • GitLab 19.5에서 동적 설명과 hiddenMetrics가 도입되었습니다.

바 목록은 분석 모드의 집계된 데이터를 수평 막대로 시각화합니다. 기본적으로 각 막대의 길이는 가장 큰 행과 비교한 값이 아니라 그 행이 전체 행 합계에서 차지하는 비율입니다. 바 목록은 "전체에서 이것이 차지하는 비중은 얼마인가"에 답하고, 바 차트는 "이들을 서로 비교하면 어떠한가"에 답합니다.

바 목록에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 최대 두 개의 dimensions 값.
  • metrics 매개변수로 설정하는 메트릭 하나 이상.

차원이 하나이면 각 행은 그 차원의 값이며, 첫 번째 메트릭이 행의 값을 결정합니다. 메트릭을 둘 이상 지정한 쿼리는 첫 번째 메트릭만 렌더링하고 나머지는 무시합니다. 행은 값의 내림차순으로 정렬됩니다. 차원이 세 개 이상이거나, 차원이 두 개이면서 메트릭이 둘 이상이면 뷰에서 유효성 검사 오류가 발생합니다.

차원이 없으면 각 메트릭이 하나의 행이 되며, 쿼리에서 지정한 순서를 따릅니다. 중앙값과 75번째 백분위수 병합 시간처럼 하나의 측정값에 대한 백분위수나 개수를 비교할 때 사용합니다. 각 행의 값은 해당 메트릭의 단위로 서식이 지정되므로, 기간은 밀리초 단위의 숫자가 아니라 9h 24m으로 표시됩니다. 이 행들은 순서를 유지하고, Other 행으로 합쳐지지 않으며, 이전 기간 대비 변화를 표시하지 않습니다. 머지 리퀘스트가 없는 백분위수처럼 응답에 값이 없는 메트릭은 빈 막대와 함께 엠 대시(—)로 렌더링됩니다.

일부 메트릭은 차원을 제거할 수 없습니다. returningUsersCount처럼 한 시간 구간을 이전 구간과 비교하는 메트릭에는 날짜 차원이 필요합니다. 차원이 있는 쿼리에서 메트릭당 한 행을 얻으려면 displayConfig 아래에 metricRows: true를 설정합니다. 값은 응답의 첫 번째 행에서 가져오므로, 원하는 행이 맨 앞에 오도록 쿼리를 정렬합니다. 이러한 메트릭 하나를 단일 숫자로 표시하려면 대신 단일 통계를 사용합니다.

차원이 있으면 displayConfig 아래의 maxRows 옵션이 페이지당 표시할 행 수를 설정합니다. 기본값은 6이며, 행은 값이 큰 순서로 순위가 매겨집니다. 쿼리가 더 많은 행을 반환하면 Previous와 Next 컨트롤이 이미 자동으로 가져온 행을 넘겨 보여 주므로, 페이지를 넘겨도 새로 가져오는 데이터는 없습니다. 가져오기는 1,000행에서 멈추므로 페이지 이동은 처음 1,000행까지만 다룹니다. 페이지 크기를 넘는 행이 하나뿐이면 새 페이지를 시작하지 않고 첫 페이지에 남습니다. 비율은 모든 페이지의 합계를 기준으로 유지됩니다. 0보다 큰 정수가 아닌 maxRows 값은 기본값으로 대체됩니다.

전체에서 차지하는 비중은 메트릭이 개수나 합계일 때만 의미가 있습니다. 평균이나 중앙값 같은 메트릭에서는 비중의 기준이 되는 합계에 의미가 없습니다.

차원이 없는 바 목록은 메트릭마다 막대 하나를 렌더링합니다. 막대를 만들지 않고 설명에만 사용할 메트릭을 선택하려면 displayConfig 아래의 hiddenMetrics에 추가합니다. 플레이스홀더 구문과 hiddenMetrics 규칙은 동적 설명을 참조합니다.

차원 하나#

각 행은 차원의 값 하나입니다.

각 행의 레이블은 막대 끝 뒤에 값을 표시하며, displayConfig 아래의 valueLabels로 제어합니다.

  • valueLabels: shareAndValue가 기본값입니다. 행이 전체에서 차지하는 비율과 간략한 값을 표시합니다(예: 89% · 85.6k).
  • valueLabels: value는 행의 값만 전체 자릿수로 표시합니다(예: 1,071). 비율보다 개수가 더 중요할 때 사용합니다.

막대 색은 displayConfig 아래의 color로 설정합니다.

  • color: orange가 기본값이며 기존 모양과 같습니다.
  • color: blue는 다른 GLQL 차트가 첫 번째 계열에 쓰는 파란색, 즉 차트 팔레트의 기본 색으로 막대를 그립니다.
  • color: gray는 색이 있는 목록 옆에 기준선을 표시할 때 쓰는 중립 회색 막대를 그립니다.

막대 길이는 displayConfig 아래의 scale로 설정하는 척도를 기준으로 측정합니다.

  • scale: total이 기본값입니다. 막대의 길이는 그 행이 전체 행 합계에서 차지하는 비율이므로, 트랙은 전체의 100%를 나타내고 막대 뒤의 빈 공간은 나머지 합계를 나타냅니다.
  • scale: max는 가장 큰 행이 트랙을 가득 채우고 다른 모든 막대는 이에 상대적으로 크기가 정해져, 막대가 행끼리 서로 비교됩니다. 행이 많거나 고르게 분포되어 전체에 대한 비율로는 모든 막대가 짧아질 때 사용합니다.

레이블은 scale의 영향을 받지 않습니다. valueLabels: shareAndValue에서는 scale과 관계없이 전체에서 차지하는 비율을 계속 표시합니다.

valueLabels, color, scale에 다른 값을 지정하면 뷰에서 유효성 검사 오류가 발생합니다.

차원 두 개#

각 행은 첫 번째 차원의 값이며, 막대는 두 번째 차원의 값마다 하나씩 누적 세그먼트로 나뉘고 차트 아래에 범례가 표시됩니다. 행의 레이블은 간략한 합계입니다.

displayConfig 아래의 maxSeries 옵션이 두 번째 차원 값 중 자체 세그먼트를 갖는 값의 개수를 제한하며, 나머지는 Other (N) 세그먼트로 합쳐집니다. 제한을 넘는 세그먼트가 하나뿐이면 그대로 유지됩니다. 기본값은 6입니다.

행은 차원 하나일 때와 같은 maxRows 및 컨트롤로 페이지가 나뉘며, 각 행은 세그먼트를 유지합니다.

범례 항목을 선택하면 해당 세그먼트가 숨겨지고, 남은 막대와 레이블의 크기가 보이는 합계에 맞게 다시 조정됩니다.

valueLabels, color, scale 옵션과 이전 기간 비교는 차원이 하나일 때만 적용됩니다.

예시#

지난 30일간 언어별 Code Suggestions 사용량을 바 목록으로 표시하려면 다음과 같이 작성합니다.

```glql
display: barList
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount
```

기본값인 여섯 개보다 많은 행을 표시하려면 다음과 같이 작성합니다.

```glql
display: barList
displayConfig:
  maxRows: 10
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount
```

지난 30일간 Duo Agent Platform 세션을 플로 유형별로, 각 레이블에는 값만 표시하고 막대는 전체가 아닌 가장 큰 행을 기준으로 크기를 정해 파란색으로 표시하려면 다음과 같이 작성합니다.

```glql
display: barList
displayConfig:
  valueLabels: value
  color: blue
  scale: max
mode: analytics
query: type = AgentPlatformSession and created >= -30d
dimensions: flowType
metrics: usersCount
```

지난 30일간 병합된 머지 리퀘스트의 병합 시간 중앙값과 75번째 백분위수를 백분위수당 한 행으로, 더 긴 막대가 트랙을 가득 채우게 비교하려면 다음과 같이 작성합니다.

```glql
display: barList
displayConfig:
  valueLabels: value
  scale: max
mode: analytics
query: type = MergeRequest and merged >= -30d
metrics: timeToMergeQuantile(0.5) as "Median", timeToMergeQuantile(0.75) as "p75"
```

한 기간에 활동한 사용자를 이전 기간에도 세션이 있었던 사용자와 없었던 사용자로 나누어 각각 한 행으로 표시하려면 다음과 같이 작성합니다. returningUsersCount는 이전 기간 없이는 비교 대상이 없으므로 쿼리는 연속된 30일 기간 두 개를 다루며, metricRows가 나중 구간을 읽도록 가장 최신 버킷을 먼저 정렬합니다. origin은 버킷을 범위의 시작에 고정하여 Unix 에포크부터 세지 않고 범위에 맞게 정렬합니다.

```glql
display: barList
displayConfig:
  metricRows: true
mode: analytics
query: type = DuoWorkflow and created >= 2026-07-16 and created < 2026-09-14
dimensions: created(granularity=30d, origin=2026-07-16)
metrics: joinedUsersCount as "New", returningUsersCount as "Returning"
sort: created desc
```

지난 30일간 사용자별 세션을 플로 유형별로 나누되, 자체 세그먼트를 갖는 플로 유형을 최대 네 개로 제한하려면 다음과 같이 작성합니다.

```glql
display: barList
displayConfig:
  maxSeries: 4
mode: analytics
query: type = AgentPlatformSession and created >= -30d
dimensions: user, flowType
metrics: totalCount
```

라인 차트#

히스토리
  • GitLab 19.1에서 도입되었습니다.

라인 차트는 분석 모드의 집계된 데이터를 하나 이상의 선으로 시각화합니다. 시간 경과처럼 차원에 따라 메트릭이 어떻게 변하는지 보여줄 때 라인 차트를 사용합니다.

라인 차트에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • x축에 사용할 dimension 정확히 하나.
  • 표시할 metric 하나 이상. 각 메트릭은 별도의 선으로 렌더링됩니다.

예시#

지난 30일간 언어별 Code Suggestions 사용량을 라인 차트로 표시하고, 전체 제안 수와 수락된 제안 수를 각각 한 개의 선으로 나타내려면 다음과 같이 작성합니다.

```glql
display: lineChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: language
metrics: totalCount, acceptedCount
```

영역 차트#

히스토리
  • GitLab 19.3에서 도입되었습니다.

영역 차트는 분석 모드의 집계된 데이터를 하나 이상의 채워진 영역으로 시각화합니다. 시간 경과처럼 차원에 따라 메트릭이 어떻게 변하는지 보여주고, 추세 이면의 규모를 강조할 때 영역 차트를 사용합니다.

영역 차트에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 결과를 그룹화할 dimensions 한 개 또는 두 개.
  • 표시할 메트릭 하나 이상(metrics 매개변수 사용).

차원과 메트릭의 개수에 따라 차트가 렌더링되는 방식이 결정됩니다.

  • 차원 하나에 메트릭이 하나 이상이면 메트릭마다 영역을 그립니다. 영역은 반투명하게 채워진 채로 겹칩니다. 대신 영역을 누적해 쌓으려면 displayConfig 아래에 stacked: true를 설정합니다. 메트릭이 하나면 stacked는 눈에 보이는 효과가 없습니다.
  • 차원 둘에 메트릭이 하나면 두 번째 차원으로 그룹화된 누적 영역 차트를 그립니다. 차원이 두 개면 메트릭은 하나만 사용할 수 있고, GitLab은 displayConfig.stacked를 무시합니다.

예시#

지난 30일간 표시된 Code Suggestions와 수락된 Code Suggestions를 겹치는 영역으로 표시하려면 다음과 같이 작성합니다.

```glql
display: areaChart
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: timestamp
metrics: shownCount, acceptedCount
```

대신 메트릭을 누적해 쌓으려면 다음과 같이 작성합니다.

```glql
display: areaChart
displayConfig:
  stacked: true
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: timestamp
metrics: shownCount, acceptedCount
```

히트 맵#

히스토리
  • GitLab 19.4에서 도입되었습니다.
  • GitLab 19.5에서 maxColumns 및 maxRows 표시 옵션이 도입되었습니다.

히트 맵은 분석 모드의 집계된 데이터를 차원 값 쌍마다 셀 하나씩 음영 처리한 격자로 시각화합니다. 두 차원에 걸쳐 메트릭 하나를 한 번에 비교하고, 가장 큰 값이 어디에 있는지 확인할 때 히트 맵을 사용합니다.

히트 맵에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 결과를 그룹화할 dimensions 정확히 두 개. 첫 번째는 칼럼 방향으로, 두 번째는 행 방향으로 배치됩니다.
  • 셀의 음영 기준이 되는 메트릭 정확히 하나(metrics 매개변수 사용).

각 셀에는 값이 표시되며, 값이 커질수록 밝은 색에서 어두운 색으로 음영이 짙어집니다. 음영은 결과의 값에서 도출한 고정 구간을 사용하므로, 셀이 어두우면 항상 값이 더 큽니다. 값이 아예 없는 셀은 가장 밝은 색이 아니라 중립적인 회색으로 표시되므로, 작은 값을 값이 없는 셀로 착각하지 않습니다. 셀에 마우스를 올리면 해당 행, 칼럼, 정확한 값이 표시됩니다.

격자 위쪽 패널에 설명을 넣으려면 displayConfig 아래에 description을 설정합니다.

격자가 그리는 차원 값의 개수를 제한하려면 displayConfig 아래에 maxColumns 또는 maxRows를 설정합니다. maxColumns는 칼럼을 따라 배치되는 첫 번째 차원의 개수를, maxRows는 행을 따라 배치되는 두 번째 차원의 개수를 제한합니다. 유지되는 값은 다른 축에 걸쳐 메트릭을 합산한 값을 기준으로 가장 큰 값이며, 제한이 적용된 축은 큰 값부터 정렬되고 동률은 레이블로 정렬됩니다. 이 정렬은 해당 축에 sort가 지정한 순서를 대체합니다. 다른 축은 계속 쿼리를 따릅니다.

제한을 넘는 값은 제외되며 격자에는 값이 빠졌다는 표시가 없으므로, 패널 제목이나 설명에 제한을 명시합니다. 두 옵션 모두 기본값이 없으며, 0보다 큰 정수가 아닌 값은 무시됩니다.

예시#

지난 30일간 IDE 별, 언어별 Code Suggestion 양을 비교하려면 다음과 같이 작성합니다.

```glql
display: heatMap
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: ideName, language
metrics: totalCount
```

격자 위에 설명을 추가하려면 다음과 같이 작성합니다.

```glql
display: heatMap
displayConfig:
  description: Code Suggestions accepted per language, by IDE.
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: ideName, language
metrics: acceptedCount
```

가장 바쁜 IDE 다섯 개만 표시하려면 다음과 같이 작성합니다.

```glql
display: heatMap
displayConfig:
  description: Code Suggestions accepted per language, for the five busiest IDEs.
  maxColumns: 5
mode: analytics
query: type = CodeSuggestion and timestamp >= -30d
dimensions: ideName, language
metrics: acceptedCount
```

양방향 바 차트#

양방향 바 차트는 분석 모드의 집계된 데이터를 가운데에 놓인 공유 카테고리 칼럼을 기준으로 두 메트릭이 서로 마주 보게 시각화합니다. 첫 번째 메트릭의 막대는 중앙에서 왼쪽으로, 두 번째 메트릭의 막대는 오른쪽으로 자랍니다. 한 메트릭이 절대값에서 다른 메트릭을 압도할 수 있을 때, 카테고리 간에 두 메트릭을 비교하려면 양방향 바 차트를 사용합니다.

차트의 각 절반은 그 절반의 가장 큰 막대에 맞춰 독립적으로 조정됩니다. 따라서 어떤 카테고리가 한 메트릭에서는 작은 비중이고 다른 메트릭에서는 대부분을 차지하더라도, 두 막대 모두 차트의 자기 쪽을 가득 채웁니다. 두 절반이 서로 다른 축척을 쓰기 때문에 막대 길이는 같은 절반 안에서만 비교할 수 있고, 중앙을 넘어서는 비교할 수 없습니다.

양방향 바 차트에는 다음이 필요합니다.

  • mode: analytics로 설정하는 분석 모드.
  • 결과를 그룹화할 dimensions 값 정확히 하나.
  • 표시할 메트릭 정확히 두 개(metrics 매개변수 사용).

차원이 정확히 하나, 메트릭이 정확히 두 개가 아니면 뷰에서 검증 오류가 발생합니다.

행은 쿼리가 반환한 순서대로 렌더링됩니다. 양방향 바 차트는 자체적으로 행을 정렬하지 않으므로 이 순서는 sort로 제어합니다. 각 메트릭의 값은 해당 메트릭의 고유 단위로 서식이 지정되므로, 개수와 비율을 함께 묶을 수 있습니다.

카테고리 칼럼은 차트 너비의 일부를 차지하므로, 들어가지 않는 카테고리 레이블은 잘립니다. 패널이 좁으면 카테고리 이름을 짧게 유지합니다.

이 표시 유형에는 displayConfig 옵션이 없습니다.

예시#

지난 30일간 GitLab Duo Agent Platform의 고유 사용자 수와 전체 세션 수를 플로 유형별로 그룹화해 비교하려면 다음과 같이 작성합니다.

```glql
display: divergingBarChart
mode: analytics
query: type = AgentPlatformSession and created >= -30d
dimensions: flowType
metrics: usersCount, totalCount
sort: totalCount desc
```

동적 설명#

히스토리
  • GitLab 19.5에서 단일 통계의 동적 설명이 도입되었습니다.
  • GitLab 19.5에서 바 목록과 테이블의 동적 설명이 도입되었습니다.
  • GitLab 19.5에서 바 목록과 테이블의 hiddenMetrics가 도입되었습니다.

stat, barList, table 표시 유형은 분석 모드에서 동적 설명을 지원합니다. 설명을 사용해 시각화와 함께 결과를 한 문장으로 요약합니다.

결과를 설명하려면 displayConfig 아래에 description을 설정합니다. 설명에는 %{metricName} 플레이스홀더를 포함할 수 있으며, metricName은 metrics의 메트릭을 식별합니다. GitLab은 각 플레이스홀더를 해당 메트릭의 값으로 바꾸며, 값은 그 메트릭 고유의 단위로 서식이 지정됩니다. 쿼리가 선택하지 않은 메트릭을 지정한 플레이스홀더는 유효성 검사 오류를 표시합니다. 응답에 메트릭의 값이 없으면 해당 플레이스홀더는 엠 대시(—)로 렌더링됩니다.

메트릭은 항상 키 이름으로 식별하며, 매개변수가 있는 메트릭이 중복된 경우에만 별칭을 사용해 식별해야 합니다. 예를 들어 metrics: totalCount as "count"는 별칭이 레이블만 설정하므로 여전히 %{totalCount}로 참조합니다. 같은 메트릭이 서로 다른 매개변수로 두 번 나타나는 경우, 예를 들어 metrics: durationQuantile(0.5) as "Median", durationQuantile(0.95) as "p95 duration"에서는 각 별칭이 키가 되므로 %{Median}과 %{p95 duration}로 참조합니다.

바 목록과 테이블에서는 쿼리에 dimensions가 있으면 설명에 플레이스홀더를 사용할 수 없습니다. 사용하면 뷰에서 Description placeholders cannot be used with dimensions. 유효성 검사 오류가 발생합니다. 플레이스홀더는 단일 행을 읽으므로, 차원이 있으면 한 그룹의 값이 모든 그룹을 대표하는 것처럼 표시됩니다. 플레이스홀더가 없는 설명은 차원이 있어도 계속 동작합니다.

바 목록과 테이블에서는 displayConfig 아래의 hiddenMetrics를 막대나 칼럼에서 제외할 메트릭 목록으로 설정합니다. 플레이스홀더와 같은 방식으로 이름을 지정합니다. durationQuantile처럼 중복된 메트릭을 기본 이름으로 지정하면 그 메트릭의 모든 사본이 숨겨집니다. GitLab은 이러한 메트릭을 계속 실행하므로 설명에서 인용할 수 있습니다. 목록이 아닌 hiddenMetrics 값이나 쿼리의 메트릭이 아닌 이름은 뷰에서 유효성 검사 오류를 일으킵니다. 바 목록에는 hiddenMetrics에서 제외되지 않은 메트릭이 하나 이상 필요합니다.

설명은 시각화 위에 렌더링됩니다. 쿼리를 불러오는 동안 플레이스홀더가 포함된 설명은 숨겨지므로, 아직 없는 값 때문에 엠 대시가 깜박이는 일은 없습니다.

예시#

GitLab Duo가 생성한 머지 리퀘스트의 병합 시간 중앙값과 75번째 백분위수를 그리고, 세 번째 막대를 그리지 않으면서 병합된 건수를 인용하려면 다음과 같이 작성합니다.

```glql
display: barList
mode: analytics
query: type = MergeRequest and createdByDuo = true and merged >= -30d
metrics: timeToMergeQuantile(0.5) as "Median", timeToMergeQuantile(0.75) as "p75", throughputCount
displayConfig:
  description: "%{throughputCount} merged merge requests"
  hiddenMetrics: [throughputCount]
```

페이지네이션 지원#

히스토리
  • GitLab 19.5에서 분석 모드 시각화의 자동 페이지네이션이 도입되었습니다.
  • GitLab 19.6에서 분석 모드 테이블의 Previous 및 Next 페이지 이동이 도입되었습니다.
  • GitLab 19.6에서 columnWidths가 도입되었습니다.
  • GitLab 19.6에서 limit가 있는 분석 모드 차트의 Previous 및 Next 컨트롤이 도입되었습니다.

모든 모드에서 사용할 수 있는 표시 유형은 결과의 첫 페이지를 표시하고 추가 페이지를 가져오는 Load more 액션을 제공합니다. 자세한 내용은 페이지네이션을 참고합니다.

분석 모드의 테이블은 limit개 행(기본값 20)으로 이루어진 한 페이지를 Previous 및 Next 컨트롤과 함께 표시합니다. Next는 다음 페이지를 가져오고, Previous는 이미 가져온 페이지로 돌아갑니다. 칼럼을 기준으로 정렬하면 현재 페이지의 행이 정렬됩니다.

차트와 통계 같은 분석 모드 집계 시각화는 Load more 작업을 제공하지 않습니다. 집계 결과의 모든 페이지를 최대 1,000행까지 자동으로 가져옵니다.

쿼리가 1,000행을 넘는 집계 행을 반환하면 시각화는 처음 1,000행을 표시합니다. 모든 데이터를 보려면 쿼리에 필터를 추가하거나 더 적은 차원으로 그룹화합니다.

차트 페이지 이동#

칼럼, 라인, 바, 영역, 양방향 바 차트에 limit를 설정하면 첫 번째 차원의 값을 그 개수만큼씩 표시합니다. Previous 및 Next 컨트롤로 나머지를 넘겨 봅니다. 각 페이지는 해당 값의 모든 행을 표시하므로, 차원이 둘이면 막대에 항상 전체 세부 구성이 표시됩니다. 차원이 둘이면 범례는 모든 페이지에서 모든 계열을 나열하므로 각 계열이 같은 색을 유지합니다. 컨트롤은 이미 가져온 행을 넘겨 보므로 페이지를 넘겨도 새로 가져오는 데이터는 없으며, 페이지 이동은 처음 1,000행까지만 다룹니다. 모든 값이 한 페이지에 들어가면 컨트롤이 표시되지 않습니다.

stat, barList, heatMap에서는 limit가 대신 그 개수의 행으로 이루어진 한 페이지를 가져오며, 최대 100행까지 가능합니다.