• Status: Experiment

GitLab Observability를 활성화하면 CI/CD 파이프라인이 자동으로 계측되어, 코드 변경 없이도 파이프라인 성능, job 실행 시간, 실행 흐름에 대한 가시성을 제공합니다.

• 어떤 job이 파이프라인을 느리게 만드는지 확인할 수 있습니다.

• 파이프라인 성능이 시간에 따라 어떻게 변화하는지 파악할 수 있습니다.

• 배포 프로세스의 병목 지점을 파악할 수 있습니다.

파이프라인 계측 활성화#

자동 파이프라인 계측을 활성화하려면 프로젝트 또는 그룹에 GITLAB_OBSERVABILITY_EXPORT CI/CD 변수를 추가하세요:

• 상단 바에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.

• 왼쪽 사이드바에서 Settings > CI/CD를 선택합니다.

• Variables를 펼칩니다.

• Add variable를 선택합니다.

• 변수를 구성합니다:

Key: GITLAB_OBSERVABILITY_EXPORT

• Value: traces, metrics, logs 중 하나 이상 (여러 값은 쉼표로 구분)

• Type: Variable

• Environment scope: All (또는 특정 환경)

• Add variable를 선택합니다.

계측 유형#

GITLAB_OBSERVABILITY_EXPORT 변수는 다음 값을 허용합니다:

• traces: 파이프라인 실행 흐름, job 의존성, 타이밍을 보여주는 분산 트레이스를 내보냅니다.

• metrics: 파이프라인 실행 시간, job 성공률, 리소스 사용량에 대한 메트릭을 내보냅니다.

• logs: 파이프라인 실행의 구조화된 로그를 내보냅니다.

여러 유형을 활성화하려면 쉼표로 구분하여 입력하세요:

traces,metrics,logs

작동 방식#

변수를 설정하면 GitLab이 자동으로:

• 각 파이프라인이 완료된 후 파이프라인 실행 데이터를 수집합니다.

• 구성에 따라 데이터를 OpenTelemetry 형식으로 변환합니다.

• 텔레메트리 데이터를 GitLab Observability 인스턴스로 내보냅니다.

• 데이터를 Observability 대시보드에서 확인할 수 있도록 합니다.

.gitlab-ci.yml 파일을 변경할 필요가 없습니다. 계측은 백그라운드에서 자동으로 진행됩니다.

파이프라인 텔레메트리 확인#

계측이 활성화된 상태에서 파이프라인을 실행한 후:

• 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.

• 왼쪽 사이드바에서 Observability > Services를 선택합니다.

• gitlab-ci 서비스를 선택하여 파이프라인 실행의 트레이스, 메트릭, 로그를 확인합니다.

GitLab Observability Templates의 CI/CD 대시보드 템플릿은 파이프라인 성능 분석을 위한 사전 빌드된 시각화를 제공합니다.

관련 항목#

• Observability 트러블슈팅