InfoGrab DocsInfoGrab Docs

파이프라인 분석

요약

분석 모드는 진행 중인 파이프라인을 포함해 모든 상태의 파이프라인에 대한 집계 메트릭을 반환하며, 데이터는 보통 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(브랜치 또는 태그 이름)로 파이프라인을 필터링합니다.

허용되는 값 유형:

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

참고:

  • !=와 not in은 ref가 있는 파이프라인만 반환합니다. ref가 없는 파이프라인은 제외되므로, ref != "main"은 main에서 실행된 파이프라인을 뺀 모든 파이프라인과 같지 않습니다.

소스 {#source}#

설명: 트리거 이벤트로 파이프라인을 필터링합니다.

허용되는 값 유형:

  • String
  • List(여러 값에는 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
    ```
    

파이프라인 분석

GitLab v19.6
Tier: Premium, Ultimate
Offering: 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(브랜치 또는 태그 이름)로 파이프라인을 필터링합니다.

허용되는 값 유형:

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

참고:

  • !=와 not in은 ref가 있는 파이프라인만 반환합니다. ref가 없는 파이프라인은 제외되므로, ref != "main"은 main에서 실행된 파이프라인을 뺀 모든 파이프라인과 같지 않습니다.

소스 {#source}#

설명: 트리거 이벤트로 파이프라인을 필터링합니다.

허용되는 값 유형:

  • String
  • List(여러 값에는 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
    ```