파이프라인 분석
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
분석 모드는 진행 중인 파이프라인을 포함해 모든 상태의 파이프라인에 대한 집계 메트릭을 반환하며, 데이터는 보통 10분 이내에 사용할 수 있습니다. 개별 파이프라인 레코드를 쿼리하려면 파이프라인을 사용합니다. 여러 그룹이나 프로젝트에 걸쳐 파이프라인을 집계하려면 in 연산자와 함께 목록을 사용합니다.
히스토리
분석 모드는 진행 중인 파이프라인을 포함해 모든 상태의 파이프라인에 대한 집계 메트릭을 반환하며, 데이터는 보통 10분 이내에 사용할 수 있습니다.
개별 파이프라인 레코드를 쿼리하려면 파이프라인을 사용합니다.
허용되는 스코프#
| 스코프 | 설명 |
|---|---|
project |
특정 프로젝트의 파이프라인을 쿼리합니다. |
group |
하위 그룹을 포함해 그룹의 모든 프로젝트에 걸쳐 파이프라인을 쿼리합니다. |
여러 그룹이나 프로젝트에 걸쳐 파이프라인을 집계하려면 in 연산자와 함께 목록을 사용합니다.
자세한 내용은 여러 그룹과 프로젝트를 참고합니다.
쿼리 필터#
결과를 필터링하려면 query 매개변수에서 다음 필드를 사용합니다.
| 필드 | 이름 | 연산자 |
|---|---|---|
| 완료 시각 | finished |
=, >, <, >=, <= |
| Ref | ref |
=, !=, in, not in |
| 소스 | source |
=, !=, in, not in |
| 시작 시각 | started |
=, >, <, >=, <= |
| 상태 | status |
=, !=, in, not in |
완료 시각 {#finished-at}#
설명: 완료 날짜로 파이프라인을 필터링합니다.
허용되는 값 유형:
AbsoluteDate(YYYY-MM-DD형식)RelativeDate(<sign><digit><unit>형식이며, sign은+,-또는 생략, digit은 정수,unit은d(일),w(주),m(월),y(년) 중 하나)
참고:
=연산자에서는 사용자의 시간대 기준으로 00:00부터 23:59까지를 시간 범위로 간주합니다.
Ref {#ref}#
설명: 파이프라인이 실행된 Git ref(브랜치 또는 태그 이름)로 파이프라인을 필터링합니다.
허용되는 값 유형:
StringList(여러 값에는in또는not in연산자 사용)
참고:
!=와not in은 ref가 있는 파이프라인만 반환합니다. ref가 없는 파이프라인은 제외되므로,ref != "main"은main에서 실행된 파이프라인을 뺀 모든 파이프라인과 같지 않습니다.
소스 {#source}#
설명: 트리거 이벤트로 파이프라인을 필터링합니다.
허용되는 값 유형:
StringList(여러 값에는in또는not in연산자 사용)
참고:
!=와not in은 소스가 있는 파이프라인만 반환합니다. 소스가 없는 파이프라인은 제외됩니다.- GitLab이 인식하지 못하는 소스를 제외해도 아무것도 제외되지 않습니다. 소스 값 검증은 이슈 629846에서 제안되었습니다.
시작 시각 {#started-at}#
설명: 시작 날짜로 파이프라인을 필터링합니다.
허용되는 값 유형:
AbsoluteDate(YYYY-MM-DD형식)RelativeDate(<sign><digit><unit>형식이며, sign은+,-또는 생략, digit은 정수,unit은d(일),w(주),m(월),y(년) 중 하나)
참고:
=연산자에서는 사용자의 시간대 기준으로 00:00부터 23:59까지를 시간 범위로 간주합니다.
상태 {#status}#
설명: CI/CD 상태로 파이프라인을 필터링합니다.
허용되는 값 유형:
Enum:canceled,canceling,created,failed,manual,pending,preparing,running,scheduled,skipped,success,waiting_for_callback,waiting_for_resource중 하나List(여러 값에는in또는not in연산자 사용)
Dimension#
| Dimension | 이름 | 설명 |
|---|---|---|
| Finished at | finished |
완료 날짜별로 그룹화합니다. daily, weekly, monthly 또는 30d와 같은 일수(기본값: weekly)의 granularity 매개변수와 선택적 origin을 받습니다. 예: finished(daily) 또는 finished(granularity=30d, origin=2026-07-16). |
| Project | project |
프로젝트별로 그룹화합니다. |
| Ref | ref |
Git ref(브랜치 또는 태그)별로 그룹화합니다. |
| Source | source |
파이프라인을 트리거한 대상별로 그룹화합니다. |
| Started at | started |
시작 날짜별로 그룹화합니다. daily, weekly, monthly 또는 30d와 같은 일수(기본값: weekly)의 granularity 매개변수와 선택적 origin을 받습니다. 예: started(daily) 또는 started(granularity=30d, origin=2026-07-16). |
| Status | status |
파이프라인 상태별로 그룹화합니다. |
메트릭#
파이프라인은 처리를 마치고 성공, 실패, 취소, 건너뜀 중 하나의 최종 상태에 도달하면 완료된 것으로 간주합니다.
| Metric | 이름 | 설명 |
|---|---|---|
| Canceled rate | canceledRate |
완료된 파이프라인 대비 취소된 파이프라인의 비율입니다. |
| Duration max | durationMax |
가장 긴 파이프라인 소요 시간(초)입니다. |
| Duration mean | durationMean |
파이프라인 평균 소요 시간(초)입니다. |
| Duration min | durationMin |
가장 짧은 파이프라인 소요 시간(초)입니다. |
| Duration quantile | durationQuantile |
파이프라인 소요 시간의 분위수(초)입니다. 0.01에서 0.99 사이의 quantile 매개변수를 받습니다(기본값: 0.95). 예: durationQuantile(0.5). |
| Duration sum | durationSum |
모든 파이프라인의 총 소요 시간(초)입니다. |
| Failure rate | failureRate |
완료된 파이프라인 대비 실패한 파이프라인의 비율입니다. |
| Skipped rate | skippedRate |
완료된 파이프라인 대비 건너뛴 파이프라인의 비율입니다. |
| Success rate | successRate |
완료된 파이프라인 대비 성공한 파이프라인의 비율입니다. |
| Total count | totalCount |
진행 중인 파이프라인을 포함한 전체 파이프라인 수입니다. |
정렬 필드#
선택한 dimension 또는 metric에 포함된 모든 필드로 정렬할 수 있습니다. 자세한 내용은 분석 모드 정렬을 참고합니다.
예시#
-
최근 30일 동안 ref별 파이프라인 성공률과 실패율:
```glql title: "Pipeline success and failure rates by branch (last 30 days)" display: table mode: analytics query: type = Pipeline and project = "gitlab-org/gitlab" and finished >= -30d dimensions: ref as "Ref" metrics: totalCount as "Total", successRate as "Success rate", failureRate as "Failure rate" sort: totalCount desc ``` -
최근 30일 동안 기본 브랜치가 아닌 ref에서
success가 아닌 상태의 파이프라인:```glql title: "Pipelines not successful, off the default branches (last 30 days)" display: table mode: analytics query: type = Pipeline and project = "gitlab-org/gitlab" and finished >= -30d and status != success and ref not in ("main", "master") dimensions: ref as "Ref" metrics: totalCount as "Pipelines", failureRate as "Failure rate" sort: totalCount desc limit: 10 ``` -
특정 ref의 주별 파이프라인 소요 시간 추세:
```glql title: "Weekly pipeline duration trend for master" display: table mode: analytics query: type = Pipeline and project = "gitlab-org/gitlab" and ref = "master" and finished >= -90d dimensions: finished as "Week" metrics: totalCount as "Total", durationQuantile as "p95 duration (s)" sort: finished desc ``` -
주별 파이프라인 소요 시간의 중앙값과 p95:
```glql title: "Median and p95 pipeline duration by week" display: table mode: analytics query: type = Pipeline and project = "gitlab-org/gitlab" and finished >= -90d dimensions: finished(weekly) as "Week", status as "Status" metrics: durationQuantile(0.5) as "Median", durationQuantile(0.95) as "p95", totalCount as "Total" sort: Median desc ``` -
그룹화하지 않은 그룹 전체의 파이프라인 메트릭:
```glql title: "Overall pipeline metrics for gitlab-org" display: table mode: analytics query: type = Pipeline and group = "gitlab-org" and finished >= -7d metrics: totalCount as "Total", successRate as "Success rate", failureRate as "Failure rate", canceledRate as "Canceled rate" ``` -
날짜 범위로 필터링하고 소스와 상태별로 그룹화한 파이프라인:
```glql title: "Pipelines by source and status (Q1 2026)" display: table mode: analytics query: type = Pipeline and project = "gitlab-org/gitlab" and finished >= "2026-01-01" and finished <= "2026-03-31" dimensions: source as "Source", status as "Status" metrics: totalCount as "Total" sort: totalCount desc ``` -
그룹 전체에서 특정 ref와 상태로 필터링:
```glql title: "Default branch pipeline outcomes across gitlab-org" display: table mode: analytics query: type = Pipeline and group = "gitlab-org" and finished >= -14d and ref in ("master", "main") and status in ("success", "failed") dimensions: project as "Project", status as "Status" metrics: totalCount as "Total", successRate as "Success rate" sort: totalCount desc limit: 20 ```