히스토리

• GitLab 19.5에서 실험 기능으로 도입되었습니다.
• model 차원이 GitLab 19.5에서 도입되었습니다.
• status 필터와 차원, 그리고 flowTypesCount, returningUsersCount, joinedUsersCount, churnedUsersCount, previousPeriodUsersCount, createdMrCount, mergedMrCount, closedMrCount 지표가 GitLab 19.5에서 도입되었습니다.
• userTier 차원과 flowTypesUsed, activeDays 필터가 GitLab 19.5에서 도입되었습니다.
• totalCount의 status 매개변수가 GitLab 19.5에서 도입되었습니다.
• group 차원이 GitLab 19.5에서 도입되었습니다.
• openMrCount 지표가 GitLab 19.5에서 도입되었습니다.
• creditsPerMergedMrRatio 지표가 GitLab 19.5에서 도입되었습니다.
• flowType, status, user 필터의 != 및 not in 연산자가 GitLab 19.5에서 도입되었습니다.
• model 차원이 GitLab 19.5에서 모델 카탈로그 이름을 표시하도록 변경되었습니다.

이 데이터 소스는 프로젝트 또는 그룹 전체에서 실행된 GitLab Duo Agent Platform 플로 (Duo 워크플로라고도 함)에 대한 집계 지표를 제공하며, 플로가 사용한 크레딧 수도 포함합니다.

허용되는 모드#

• analytics

허용되는 범위#

여러 그룹 또는 프로젝트에 걸쳐 GitLab Duo 워크플로를 집계하려면 in 연산자와 목록을 사용합니다. 자세한 내용은 여러 그룹 및 프로젝트를 참고합니다.

쿼리 필터#

결과를 필터링하려면 query 매개변수에서 다음 필드를 사용합니다.

활성 일수#

설명: 선택한 기간 동안 사용자가 플로를 생성한 고유한 날짜의 수를 기준으로 플로를 필터링합니다. activeDays = 1은 정확히 하루만 활동한 사용자와 일치합니다.

허용되는 값 유형: Number

참고:

• 이 수는 선택한 전체 기간을 대상으로 사용자별로 계산합니다.
• 두 개의 범위 연산자를 조합해 구간을 지정할 수 있습니다. 예를 들어 activeDays >= 2 and activeDays <= 5입니다. 단, 같은 필드에서 =를 다른 비교와 함께 쓸 수는 없습니다.

생성일#

설명: 플로가 생성된 날짜를 기준으로 플로를 필터링합니다. 특정 기간을 지정하려면 created 조건을 여러 개 사용합니다.

허용되는 값 유형:

• AbsoluteDate (YYYY-MM-DD 형식)
• RelativeDate (<sign><digit><unit> 형식이며, sign은 +, - 또는 생략, digit은 정수, unit은 d(일), w(주), m(월), y(년) 중 하나)

참고:

• = 연산자의 경우 GLQL은 사용자의 시간대를 기준으로 00:00부터 23:59까지의 시간 범위를 사용합니다.

플로 유형#

설명: 유형을 기준으로 플로를 필터링합니다. 예: software_development 또는 code_review/v1.

허용되는 값 유형:

• String
• List (여러 값에는 in 또는 not in 연산자 사용)

사용한 플로 유형 수#

설명: 선택한 기간 동안 사용자가 실행한 고유한 플로 유형의 수를 기준으로 플로를 필터링합니다. flowTypesUsed >= 2는 플로 유형을 두 개 이상 사용한 사용자와 일치합니다.

허용되는 값 유형: Number

참고:

• 이 수는 선택한 전체 기간을 대상으로 사용자별로 계산합니다.
• 같은 조합 규칙이 적용됩니다. 구간에는 두 개의 범위 연산자를 사용하며, 같은 필드에서 =를 다른 비교와 함께 쓸 수는 없습니다.

상태#

설명: 수명 주기 상태를 기준으로 플로를 필터링합니다.

허용되는 값 유형:

• Enum, 값은 created, running, paused, finished, failed, stopped, input_required, plan_approval_required, tool_call_approval_required 중 하나
• List (여러 값에는 in 또는 not in 연산자 사용)

참고:

• *_required로 끝나는 세 가지 상태는 사용자를 기다리는 플로이며, paused와는 구분됩니다.
• 상태는 대소문자를 구분하지 않고 일치시킵니다. completed, aborted 같은 다른 표기는 허용되지 않습니다.

사용자#

설명: 플로를 실행한 사용자를 기준으로 필터링합니다.

허용되는 값 유형:

• Number (사용자 ID)
• List (여러 사용자 ID에는 in 또는 not in 연산자 사용)

차원#

지표#

참고:

• returningUsersCount, joinedUsersCount, churnedUsersCount, previousPeriodUsersCount 지표는 각 created 버킷을 직전 버킷과 비교하므로, created 차원도 함께 선택한 경우에만 유효합니다. created 필터만으로는 충분하지 않습니다.
• mergedMrCount, closedMrCount, openMrCount 지표는 플로가 생성한 머지 리퀘스트 중 이후 머지되었거나, 머지되지 않고 닫혔거나, 아직 열려 있는 것의 수를 계산합니다. 이 지표는 해당 머지 리퀘스트의 현재 상태보다 늦게 반영될 수 있으므로, 최근에 머지된 머지 리퀘스트가 여전히 열린 것으로 계산될 수 있습니다.

정렬 필드#

선택한 차원 또는 지표에 포함된 모든 필드로 정렬할 수 있습니다. 자세한 내용은 analytics 모드 정렬을 참고합니다.

예시#

• 30일간 플로 유형별 플로:

  ```glql
  title: "Duo workflows by flow type (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: flowType as "Flow"
  metrics: totalCount as "Flows", usersCount as "Users", creditsUsedSum as "Credits"
  sort: totalCount desc
  ```
  

• 월별 크레딧 사용량 추이:

  ```glql
  title: "Monthly Duo workflow credit usage trend"
  display: columnChart
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -90d
  dimensions: created(monthly) as "Month"
  metrics: creditsUsedSum as "Credits used"
  sort: created asc
  ```
  

• 채팅 플로를 제외한 월별 크레딧 사용량:

  ```glql
  title: "Monthly Duo workflow credits, excluding chat"
  display: columnChart
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -90d and flowType not in ("chat", "agentic_chat/v1")
  dimensions: created(monthly) as "Month", flowType as "Flow"
  metrics: creditsUsedSum as "Credits used"
  sort: created asc
  ```
  

• 30일간 모델별 크레딧:

  ```glql
  title: "Duo workflow credits by model (last 30 days)"
  display: barChart
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: model as "Model"
  metrics: creditsUsedSum as "Credits used"
  sort: creditsUsedSum desc
  ```
  

• 30일간 크레딧 상위 사용자:

  ```glql
  title: "Top users by Duo workflow credits (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: user as "User"
  metrics: totalCount as "Flows", creditsUsedSum as "Credits", creditsUsedMean as "Avg credits per flow"
  sort: creditsUsedSum desc
  limit: 10
  ```
  

• 30일간 상태별 플로:

  ```glql
  title: "Duo workflows by status (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: status as "Status"
  metrics: totalCount as "Flows", createdMrCountSum as "MRs created", mergedMrCountSum as "MRs merged", openMrCountSum as "MRs open"
  sort: status asc
  ```
  

• 주별 사용자 유지율:

  ```glql
  title: "Weekly Duo workflow user retention"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -90d
  dimensions: created(weekly) as "Week"
  metrics: usersCount as "Users", returningUsersCount as "Returning", joinedUsersCount as "Joined", churnedUsersCount as "Churned"
  sort: created desc
  ```
  

• 30일간 활동 구간 및 플로 유형별 사용자:

  ```glql
  title: "Duo workflow users by activity tier (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: userTier(thresholds=[4, 25, 100]) as "Tier", flowType as "Flow"
  metrics: totalCount as "Flows", usersCount as "Users"
  sort: userTier asc
  ```
  

• 30일간 상태별 플로 수 나란히 비교:

  ```glql
  title: "Duo workflows by outcome (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  metrics: totalCount as "All", totalCount(status="finished") as "Completed", totalCount(status=["paused", "input_required"]) as "Waiting", totalCount(status="failed") as "Failed"
  ```
  

• 30일간 그룹 비교:

  ```glql
  title: "Duo workflow usage by subgroup (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  dimensions: group(depth=2) as "Group"
  metrics: usersCount as "Users", creditsUsedSum as "Credits"
  sort: usersCount desc
  ```
  

• 그룹화 없는 전체 사용량:

  ```glql
  title: "Duo workflow usage overview (last 30 days)"
  display: table
  mode: analytics
  query: type = DuoWorkflow and group = "gitlab-org" and created > -30d
  metrics: totalCount as "Flows", usersCount as "Users", projectsCount as "Projects", creditsUsedQuantile(0.5) as "Median credits"
  ```