AI 사용 이벤트
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
AI 사용 이벤트는 프로젝트나 그룹 전체의 GitLab Duo 기능 사용에 대한 집계 지표를 제공하는 데이터 소스입니다. 여러 그룹이나 프로젝트에 걸쳐 AI 사용 이벤트를 집계하려면 in 연산자와 함께 목록을 사용합니다.
히스토리
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}#
설명: 이벤트 식별자로 필터링합니다.
허용되는 값 유형:
StringList(여러 값에는in또는not in연산자를 사용합니다)
참고:
- GitLab이 인식하지 못하는 이벤트 식별자를 제외하면 아무것도 제외되지 않습니다. 이벤트 식별자 검증은 이슈 629846에서 제안되었습니다.
기능 {#feature}#
설명: 이벤트를 생성한 GitLab Duo 기능으로 필터링합니다. 예를 들어
code_suggestions 또는 chat입니다.
허용되는 값 유형:
StringList(여러 값에는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연산자를 사용합니다)
사용자 이름 필터링 지원은 이슈 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" ```