InfoGrab DocsInfoGrab Docs

AI 사용 이벤트

요약

AI 사용 이벤트는 프로젝트나 그룹 전체의 GitLab Duo 기능 사용에 대한 집계 지표를 제공하는 데이터 소스입니다. 여러 그룹이나 프로젝트에 걸쳐 AI 사용 이벤트를 집계하려면 in 연산자와 함께 목록을 사용합니다.

히스토리
  • GitLab 19.3에서 도입되었습니다.
  • timestamp 차원 없이 returningUsersCount 또는 previousPeriodUsersCount를 선택하면 GitLab 19.5부터 오류를 반환하도록 변경되었습니다.
  • group 차원이 GitLab 19.5에서 도입되었습니다.
  • event, feature, user 필터의 != 및 not in 연산자가 GitLab 19.5에서 도입되었습니다.
  • totalCount의 event 매개변수가 GitLab 19.5에서 도입되었습니다.

AI 사용 이벤트는 프로젝트나 그룹 전체의 GitLab Duo 기능 사용에 대한 집계 지표를 제공하는 데이터 소스입니다.

허용 모드#

허용 범위#

범위 설명
project 특정 프로젝트의 AI 사용 이벤트를 쿼리합니다.
group 하위 그룹을 포함해 그룹의 모든 프로젝트에 걸친 AI 사용 이벤트를 쿼리합니다.

여러 그룹이나 프로젝트에 걸쳐 AI 사용 이벤트를 집계하려면 in 연산자와 함께 목록을 사용합니다. 자세한 내용은 여러 그룹 및 프로젝트를 참고합니다.

쿼리 필터#

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

필드 이름 연산자
이벤트 event =, !=, in, not in
기능 feature =, !=, in, not in
기능 수 featuresCount >, <, >=, <=
타임스탬프 timestamp =, >, <, >=, <=
사용자 user =, !=, in, not in

이벤트 {#event}#

설명: 이벤트 식별자로 필터링합니다.

허용되는 값 유형:

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

참고:

  • GitLab이 인식하지 못하는 이벤트 식별자를 제외하면 아무것도 제외되지 않습니다. 이벤트 식별자 검증은 이슈 629846에서 제안되었습니다.

기능 {#feature}#

설명: 이벤트를 생성한 GitLab Duo 기능으로 필터링합니다. 예를 들어 code_suggestions 또는 chat입니다.

허용되는 값 유형:

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

참고:

  • != 및 not in은 기능이 알려진 이벤트만 반환합니다. GitLab이 기능에 매핑하지 못한 이벤트는 제외되므로 feature != "chat"은 채팅을 제외한 모든 이벤트와 같지 않습니다.

기능 수 {#features-count}#

설명: 사용한 고유 기능 수로 필터링합니다. 이 필터는 featuresCount 지표도 함께 선택한 경우에만 유효합니다.

허용되는 값 유형: Number

타임스탬프 {#timestamp}#

설명: 이벤트가 발생한 시점으로 필터링합니다. 범위 연산자를 사용해 시간 구간을 정의합니다.

허용되는 값 유형:

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

참고:

  • = 연산자에서는 사용자 시간대의 00:00부터 23:59까지를 시간 범위로 간주합니다.

사용자 {#user}#

설명: 이벤트를 발생시킨 사용자로 필터링합니다.

허용되는 값 유형:

  • Number (사용자 ID)
  • List (여러 사용자 ID에는 in 또는 not in 연산자를 사용합니다)
Note

사용자 이름 필터링 지원은 이슈 599750에서 추적하고 있습니다.

차원#

차원 이름 설명
Event event 이벤트 식별자별로 그룹화합니다.
Feature feature GitLab Duo 기능별로 그룹화합니다.
Group group 그룹별로 그룹화합니다. 최상위 그룹부터 센 depth 매개변수를 1에서 99까지(기본값: 1) 받으므로, group은 최상위 그룹을 반환하고 group(depth=2)는 그 하위 그룹을 반환합니다. 그 깊이보다 위에 있는 이벤트, 또는 하위 그룹이 아니라 그 깊이의 프로젝트에 있는 이벤트(예: depth=2일 때 최상위 그룹 바로 아래의 프로젝트)에는 그룹이 없으며, 결과에 그룹이 없는 행이 둘 이상 있을 수 있습니다.
Timestamp timestamp 날짜별로 그룹화합니다. daily, weekly, monthly 또는 30d처럼 일 수를 지정하는 granularity 매개변수(기본값: weekly)와 선택적 origin을 받습니다. 예: timestamp(daily) 또는 timestamp(granularity=30d, origin=2026-07-16).
User user 사용자별로 그룹화합니다(아바타, 이름, 사용자 이름을 표시합니다).

지표#

지표 이름 설명
Features count featuresCount 사용한 고유 기능 수입니다.
Previous period users count previousPeriodUsersCount 이전 기간의 고유 사용자 수입니다.
Returning users count returningUsersCount 현재 기간과 이전 기간 모두에서 활동한 사용자 수입니다.
Total count totalCount 이벤트 총수이며 이벤트로 필터링할 수 있습니다. 이벤트 식별자를 하나 이상 지정하는 선택적 event 매개변수(event 필터와 같은 값)를 받으며, 예를 들어 totalCount(event="publish_duo_code_review_comments") 또는 totalCount(event=["request_review_duo_code_review_on_mr_by_author", "request_review_duo_code_review_on_mr_by_non_author"])입니다. 매개변수가 없거나 event=[]이면 모든 이벤트를 계산합니다. GitLab이 인식하지 못하는 이벤트 식별자는 오류를 반환합니다.
Users count usersCount 고유 사용자 수입니다.

참고:

  • returningUsersCount 및 previousPeriodUsersCount 지표는 각 timestamp 버킷을 직전 버킷과 비교하므로 timestamp 차원도 함께 선택해야 합니다. 선택하지 않으면 쿼리가 오류를 반환합니다. timestamp 필터만으로는 충분하지 않습니다.

정렬 필드#

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

예시#

  • 최근 30일 동안의 기능 도입:

    ```glql
    title: "GitLab Duo feature adoption (last 30 days)"
    display: table
    mode: analytics
    query: type = AiUsageEvent and group = "gitlab-org" and timestamp > -30d
    dimensions: feature as "Feature"
    metrics: totalCount as "Total events", usersCount as "Users"
    sort: usersCount desc
    ```
    
  • 재방문 사용자를 포함한 주간 사용 추세:

    ```glql
    title: "Weekly GitLab Duo usage trend"
    display: table
    mode: analytics
    query: type = AiUsageEvent and group = "gitlab-org" and timestamp > -30d
    dimensions: timestamp(weekly) as "Week"
    metrics: usersCount as "Users", returningUsersCount as "Returning users", previousPeriodUsersCount as "Previous period users"
    sort: timestamp desc
    ```
    
  • 이벤트 그룹별 주간 GitLab Duo Code Review 수:

    ```glql
    title: "Weekly GitLab Duo Code Review requests and reviews"
    display: table
    mode: analytics
    query: type = AiUsageEvent and group = "gitlab-org" and timestamp > -30d
    dimensions: timestamp(weekly) as "Week"
    metrics: totalCount(event=["request_review_duo_code_review_on_mr_by_author", "request_review_duo_code_review_on_mr_by_non_author"]) as "Requested", totalCount(event="post_comment_duo_code_review_on_diff") as "With comments", totalCount(event="find_no_issues_duo_code_review_after_review") as "Without comments"
    sort: timestamp desc
    ```
    
  • 특정 프로젝트의 사용자별 이벤트:

    ```glql
    title: "GitLab Duo events by user"
    display: table
    mode: analytics
    query: type = AiUsageEvent and project = "gitlab-org/gitlab" and timestamp > -30d
    dimensions: user as "User"
    metrics: totalCount as "Total events"
    sort: totalCount desc
    limit: 10
    ```
    
  • 그룹화하지 않은 전체 고유 사용자:

    ```glql
    title: "Unique GitLab Duo users (last 30 days)"
    display: table
    mode: analytics
    query: type = AiUsageEvent and group = "gitlab-org" and timestamp > -30d
    metrics: usersCount as "Users"
    ```
    

AI 사용 이벤트

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

요약

AI 사용 이벤트는 프로젝트나 그룹 전체의 GitLab Duo 기능 사용에 대한 집계 지표를 제공하는 데이터 소스입니다. 여러 그룹이나 프로젝트에 걸쳐 AI 사용 이벤트를 집계하려면 in 연산자와 함께 목록을 사용합니다.

히스토리
  • GitLab 19.3에서 도입되었습니다.
  • timestamp 차원 없이 returningUsersCount 또는 previousPeriodUsersCount를 선택하면 GitLab 19.5부터 오류를 반환하도록 변경되었습니다.
  • group 차원이 GitLab 19.5에서 도입되었습니다.
  • event, feature, user 필터의 != 및 not in 연산자가 GitLab 19.5에서 도입되었습니다.
  • totalCount의 event 매개변수가 GitLab 19.5에서 도입되었습니다.

AI 사용 이벤트는 프로젝트나 그룹 전체의 GitLab Duo 기능 사용에 대한 집계 지표를 제공하는 데이터 소스입니다.

허용 모드#

허용 범위#

범위 설명
project 특정 프로젝트의 AI 사용 이벤트를 쿼리합니다.
group 하위 그룹을 포함해 그룹의 모든 프로젝트에 걸친 AI 사용 이벤트를 쿼리합니다.

여러 그룹이나 프로젝트에 걸쳐 AI 사용 이벤트를 집계하려면 in 연산자와 함께 목록을 사용합니다. 자세한 내용은 여러 그룹 및 프로젝트를 참고합니다.

쿼리 필터#

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

필드 이름 연산자
이벤트 event =, !=, in, not in
기능 feature =, !=, in, not in
기능 수 featuresCount >, <, >=, <=
타임스탬프 timestamp =, >, <, >=, <=
사용자 user =, !=, in, not in

이벤트 {#event}#

설명: 이벤트 식별자로 필터링합니다.

허용되는 값 유형:

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

참고:

  • GitLab이 인식하지 못하는 이벤트 식별자를 제외하면 아무것도 제외되지 않습니다. 이벤트 식별자 검증은 이슈 629846에서 제안되었습니다.

기능 {#feature}#

설명: 이벤트를 생성한 GitLab Duo 기능으로 필터링합니다. 예를 들어 code_suggestions 또는 chat입니다.

허용되는 값 유형:

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

참고:

  • != 및 not in은 기능이 알려진 이벤트만 반환합니다. GitLab이 기능에 매핑하지 못한 이벤트는 제외되므로 feature != "chat"은 채팅을 제외한 모든 이벤트와 같지 않습니다.

기능 수 {#features-count}#

설명: 사용한 고유 기능 수로 필터링합니다. 이 필터는 featuresCount 지표도 함께 선택한 경우에만 유효합니다.

허용되는 값 유형: Number

타임스탬프 {#timestamp}#

설명: 이벤트가 발생한 시점으로 필터링합니다. 범위 연산자를 사용해 시간 구간을 정의합니다.

허용되는 값 유형:

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

참고:

  • = 연산자에서는 사용자 시간대의 00:00부터 23:59까지를 시간 범위로 간주합니다.

사용자 {#user}#

설명: 이벤트를 발생시킨 사용자로 필터링합니다.

허용되는 값 유형:

  • Number (사용자 ID)
  • List (여러 사용자 ID에는 in 또는 not in 연산자를 사용합니다)
Note

사용자 이름 필터링 지원은 이슈 599750에서 추적하고 있습니다.

차원#

차원 이름 설명
Event event 이벤트 식별자별로 그룹화합니다.
Feature feature GitLab Duo 기능별로 그룹화합니다.
Group group 그룹별로 그룹화합니다. 최상위 그룹부터 센 depth 매개변수를 1에서 99까지(기본값: 1) 받으므로, group은 최상위 그룹을 반환하고 group(depth=2)는 그 하위 그룹을 반환합니다. 그 깊이보다 위에 있는 이벤트, 또는 하위 그룹이 아니라 그 깊이의 프로젝트에 있는 이벤트(예: depth=2일 때 최상위 그룹 바로 아래의 프로젝트)에는 그룹이 없으며, 결과에 그룹이 없는 행이 둘 이상 있을 수 있습니다.
Timestamp timestamp 날짜별로 그룹화합니다. daily, weekly, monthly 또는 30d처럼 일 수를 지정하는 granularity 매개변수(기본값: weekly)와 선택적 origin을 받습니다. 예: timestamp(daily) 또는 timestamp(granularity=30d, origin=2026-07-16).
User user 사용자별로 그룹화합니다(아바타, 이름, 사용자 이름을 표시합니다).

지표#

지표 이름 설명
Features count featuresCount 사용한 고유 기능 수입니다.
Previous period users count previousPeriodUsersCount 이전 기간의 고유 사용자 수입니다.
Returning users count returningUsersCount 현재 기간과 이전 기간 모두에서 활동한 사용자 수입니다.
Total count totalCount 이벤트 총수이며 이벤트로 필터링할 수 있습니다. 이벤트 식별자를 하나 이상 지정하는 선택적 event 매개변수(event 필터와 같은 값)를 받으며, 예를 들어 totalCount(event="publish_duo_code_review_comments") 또는 totalCount(event=["request_review_duo_code_review_on_mr_by_author", "request_review_duo_code_review_on_mr_by_non_author"])입니다. 매개변수가 없거나 event=[]이면 모든 이벤트를 계산합니다. GitLab이 인식하지 못하는 이벤트 식별자는 오류를 반환합니다.
Users count usersCount 고유 사용자 수입니다.

참고:

  • returningUsersCount 및 previousPeriodUsersCount 지표는 각 timestamp 버킷을 직전 버킷과 비교하므로 timestamp 차원도 함께 선택해야 합니다. 선택하지 않으면 쿼리가 오류를 반환합니다. timestamp 필터만으로는 충분하지 않습니다.

정렬 필드#

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

예시#

  • 최근 30일 동안의 기능 도입:

    ```glql
    title: "GitLab Duo feature adoption (last 30 days)"
    display: table
    mode: analytics
    query: type = AiUsageEvent and group = "gitlab-org" and timestamp > -30d
    dimensions: feature as "Feature"
    metrics: totalCount as "Total events", usersCount as "Users"
    sort: usersCount desc
    ```
    
  • 재방문 사용자를 포함한 주간 사용 추세:

    ```glql
    title: "Weekly GitLab Duo usage trend"
    display: table
    mode: analytics
    query: type = AiUsageEvent and group = "gitlab-org" and timestamp > -30d
    dimensions: timestamp(weekly) as "Week"
    metrics: usersCount as "Users", returningUsersCount as "Returning users", previousPeriodUsersCount as "Previous period users"
    sort: timestamp desc
    ```
    
  • 이벤트 그룹별 주간 GitLab Duo Code Review 수:

    ```glql
    title: "Weekly GitLab Duo Code Review requests and reviews"
    display: table
    mode: analytics
    query: type = AiUsageEvent and group = "gitlab-org" and timestamp > -30d
    dimensions: timestamp(weekly) as "Week"
    metrics: totalCount(event=["request_review_duo_code_review_on_mr_by_author", "request_review_duo_code_review_on_mr_by_non_author"]) as "Requested", totalCount(event="post_comment_duo_code_review_on_diff") as "With comments", totalCount(event="find_no_issues_duo_code_review_after_review") as "Without comments"
    sort: timestamp desc
    ```
    
  • 특정 프로젝트의 사용자별 이벤트:

    ```glql
    title: "GitLab Duo events by user"
    display: table
    mode: analytics
    query: type = AiUsageEvent and project = "gitlab-org/gitlab" and timestamp > -30d
    dimensions: user as "User"
    metrics: totalCount as "Total events"
    sort: totalCount desc
    limit: 10
    ```
    
  • 그룹화하지 않은 전체 고유 사용자:

    ```glql
    title: "Unique GitLab Duo users (last 30 days)"
    display: table
    mode: analytics
    query: type = AiUsageEvent and group = "gitlab-org" and timestamp > -30d
    metrics: usersCount as "Users"
    ```