히스토리

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

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

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

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

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

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

테이블#

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

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

예시#

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에서 도입되었습니다.

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

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

• mode: analytics로 설정하는 분석 모드.
• metrics 매개변수로 설정하는 메트릭 하나.
• dimensions 없음.

값은 메트릭에 따라 자동으로 서식이 지정됩니다. 예를 들어 개수는 천 단위 구분 기호를 사용하고 비율은 백분율로 표시됩니다.

예시#

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

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

칼럼 차트#

히스토리

• GitLab 19.1에서 도입되었습니다.

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

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

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

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

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

예시#

지난 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에서 도입되었습니다.

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

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

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

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

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

예시#

지난 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
```

바 목록#

히스토리

• GitLab 19.4에서 도입되었습니다.

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

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

• mode: analytics로 설정하는 분석 모드.
• dimensions 값 정확히 하나.
• metrics 매개변수로 설정하는 메트릭 정확히 하나.

차원이 하나보다 많으면 뷰에서 검증 오류가 발생합니다. 메트릭을 하나보다 많이 지정한 쿼리는 첫 번째 메트릭을 렌더링하고 나머지는 무시합니다.

행은 값의 내림차순으로 정렬됩니다. 각 행의 레이블에는 백분율과 값이 함께 표시됩니다.

기본적으로 바 목록은 여섯 개 행과 Other (N) 롤업 행을 표시하므로, 여덟 개 이상의 행을 반환하는 쿼리에는 항상 Other 행이 있습니다. 일곱 개 이하의 행을 반환하는 쿼리는 모든 행을 표시합니다. 행 하나를 접어도 목록이 짧아지지 않고 그 행의 이름만 가려지기 때문입니다. 다른 개수의 행을 표시하려면 displayConfig 아래의 maxRows를 0보다 큰 정수로 설정합니다. GitLab은 값이 큰 행을 그 개수만큼 남기고 나머지는 Other (N)이라는 행 하나로 접습니다. 여기서 N은 접힌 행의 개수이고 값은 그 행들의 합계입니다. 0보다 큰 정수가 아닌 값은 여섯 개로 되돌아갑니다.

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

예시#

지난 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
```

라인 차트#

히스토리

• 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에서 도입되었습니다.

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

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

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

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

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

예시#

지난 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
```

양방향 바 차트#

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

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

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

• 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
```

페이지네이션 지원#

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

분석 모드 시각화는 페이지네이션을 지원하지 않습니다. 집계된 모든 결과를 한 번에 렌더링합니다.