Observability를 위한 CI/CD 파이프라인 텔레메트리 표시

GitLab Observability를 통해 CI/CD 파이프라인의 성능과 실행 흐름을 자동으로 계측하고 텔레메트리 데이터를 확인하는 방법을 설명합니다.

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 트러블슈팅