허용 모드#

• 표준 모드(기본값): 파이프라인 레코드를 쿼리합니다.
• 분석 모드: 집계된 파이프라인 지표를 쿼리합니다. 자세한 내용은 파이프라인 분석을 참고합니다.

허용 범위#

자세한 내용은 범위를 참고합니다.

쿼리 필드#

query 파라미터에 다음 필드를 사용해 결과를 필터링합니다.

작성자(Author) {#pipeline-author}#

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

허용되는 값 유형:

• String
• User(예: @username)

참조(Ref) {#pipeline-ref}#

설명: 파이프라인이 실행된 Git ref(브랜치 또는 태그 이름)로 파이프라인을 필터링합니다.

허용되는 값 유형: String

범위(Scope) {#pipeline-scope}#

설명: 범위로 파이프라인을 필터링합니다.

허용되는 값 유형:

• Enum, branches, tags, finished, pending, running 중 하나

SHA {#pipeline-sha}#

설명: 커밋 SHA로 파이프라인을 필터링합니다.

허용되는 값 유형: String

소스(Source) {#pipeline-source}#

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

허용되는 값 유형: String

상태(Status) {#pipeline-status}#

설명: CI/CD 상태로 파이프라인을 필터링합니다.

허용되는 값 유형:

• Enum, canceled, canceling, created, failed, manual, pending, preparing, running, scheduled, skipped, success, waiting_for_callback, waiting_for_resource 중 하나

업데이트 시각(Updated at) {#pipeline-updated-at}#

설명: 마지막으로 업데이트된 시점으로 파이프라인을 필터링합니다.

허용되는 값 유형:

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

참고 사항:

• = 연산자의 경우 시간 범위는 사용자 시간대 기준으로 00:00부터 23:59 까지로 간주됩니다.

표시 필드#

알려진 문제#

• 날짜 범위가 큰 쿼리는 타임아웃을 유발할 수 있습니다.

예시#

• gitlab-org/gitlab 프로젝트에서 오늘 실패한 파이프라인을 모두 나열합니다.

  ```glql
  title: "Failed pipelines today"
  display: table
  fields: id, ref, status, startedAt
  query: type = Pipeline and project = "gitlab-org/gitlab" and status = failed and updated = today()
  ```
  

• gitlab-org/gitlab 프로젝트의 Duo 에이전트 파이프라인을 모두 나열합니다.

  ```glql
  title: "GitLab Duo agent pipelines"
  display: table
  fields: id, ref, status, source, startedAt
  query: type = Pipeline and project = "gitlab-org/gitlab" and source = "duo_workflow"
  ```