기여
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
기여(Contributions)는 프로젝트나 그룹 전체의 기여 활동(예: 커밋, 이슈, 머지 리퀘스트)에 대한 집계 지표를 제공하는 데이터 소스입니다. 여러 그룹이나 프로젝트에 걸쳐 기여를 집계하려면 in 연산자와 함께 목록을 사용합니다.
히스토리
기여(Contributions)는 프로젝트나 그룹 전체의 기여 활동(예: 커밋, 이슈, 머지 리퀘스트)에 대한 집계 지표를 제공하는 데이터 소스입니다.
허용 모드#
허용 범위#
| 범위 | 설명 |
|---|---|
project |
특정 프로젝트의 기여를 쿼리합니다. |
group |
하위 그룹을 포함해 그룹의 모든 프로젝트에 걸쳐 기여를 쿼리합니다. |
여러 그룹이나 프로젝트에 걸쳐 기여를 집계하려면 in 연산자와 함께 목록을 사용합니다.
자세한 내용은 여러 그룹과 프로젝트를 참고합니다.
쿼리 필터#
query 파라미터에 다음 필드를 사용해 결과를 필터링합니다.
| 필드 | 이름 | 연산자 |
|---|---|---|
| Created at | created |
=, >, <, >=, <= |
| User | user |
=, !=, in, not in |
생성일(Created at) {#created-at}#
설명: 기여가 생성된 날짜로 기여를 필터링합니다.
허용되는 값 유형:
AbsoluteDate(YYYY-MM-DD형식)RelativeDate(<sign><digit><unit>형식이며, sign은+,-또는 생략, digit은 정수,unit은d(일),w(주),m(월),y(년) 중 하나)
참고:
=연산자의 경우 GLQL은 사용자의 시간대 기준으로 00:00부터 23:59까지의 시간 범위를 고려합니다.
사용자(User) {#user}#
설명: 기여를 한 사용자로 필터링합니다.
허용되는 값 유형:
Number(사용자 ID)List(여러 사용자 ID에는in또는not in연산자 사용)
사용자 이름 필터링 지원은 GLQL 이슈 143에서 추적 중입니다.
차원#
| 차원 | 이름 | 설명 |
|---|---|---|
| Created at | created |
기여 생성일로 그룹화합니다. daily, weekly, monthly 또는 30d와 같은 일수의 granularity 파라미터(기본값: monthly)와 선택적 origin을 받습니다. 예: created(weekly) 또는 created(granularity=30d, origin=2026-07-16). |
지표#
| 지표 | 이름 | 설명 |
|---|---|---|
| Total count | totalCount |
기여의 총 수입니다. |
| Users count | usersCount |
고유 기여자 수입니다. |
정렬 필드#
선택한 차원이나 지표에 포함된 모든 필드로 정렬할 수 있습니다. 자세한 내용은 분석 모드 정렬을 참고합니다.
예시#
-
프로젝트의 월별 기여 추세:
```glql title: "Monthly contributions" display: table mode: analytics query: type = Contribution and project = "gitlab-org/gitlab" dimensions: created as "Month" metrics: totalCount as "Total", usersCount as "Contributors" sort: created desc ``` -
특정 사용자 집합의 기여 추세:
```glql title: "Contributions from a set of users" display: table mode: analytics query: type = Contribution and project = "gitlab-org/gitlab" and user in (1234567, 2345678) and created >= -90d dimensions: created as "Month" metrics: totalCount as "Total" sort: created desc ``` -
특정 사용자의 지난 1년 기여를 월별로 보기:
```glql title: "User contribution history" display: table mode: analytics query: type = Contribution and group = "gitlab-org" and user = 1234567 and created >= -365d dimensions: created as "Month" metrics: totalCount as "Total" sort: created asc ``` -
그룹화 없이 그룹 전체의 기여 지표:
```glql title: "Overall contribution metrics" display: table mode: analytics query: type = Contribution and group = "gitlab-org" and created >= -90d metrics: totalCount as "Total", usersCount as "Contributors" ```