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 인스턴스의 OTLP 엔드포인트가 bearer 토큰 인증을 요구하는 경우, GITLAB_OBSERVABILITY_TOKEN CI/CD 변수로 토큰을 제공하세요. 이 변수를 설정하면 GitLab은 내보내는 텔레메트리와 함께 토큰을 Authorization: Bearer <token> 헤더로 전송합니다. 변수를 설정하지 않으면 GitLab은 이전과 동일하게 Authorization 헤더 없이 데이터를 내보냅니다. 상단 바에서 Search or go to 를 선택하고 프로젝트 또는 그룹을 찾습니다. 왼쪽 사이드바에서 Settings > CI/CD 를 선택합니다. Variables 를 펼칩니다. Add variable 를 선택합니다. 변수를 구성합니다: Key : GITLAB_OBSERVABILITY_TOKEN Value : GitLab Observability 인스턴스에서 생성한 토큰. Type : Variable Flags : job 로그에 토큰이 노출되지 않도록 Mask variable 을 선택합니다. Add variable 를 선택합니다. 계측 유형 # GITLAB_OBSERVABILITY_EXPORT 변수는 다음 값을 허용합니다: traces : 파이프라인 실행 흐름, job 의존성, 타이밍을 보여주는 분산 트레이스를 내보냅니다. metrics : 파이프라인 실행 시간, job 성공률, 리소스 사용량에 대한 메트릭을 내보냅니다. logs : 파이프라인 실행의 구조화된 로그를 내보냅니다. 여러 유형을 활성화하려면 쉼표로 구분하여 입력하세요: traces,metrics,logs 내보낸 데이터 # GitLab은 각 시그널 유형을 OpenTelemetry 프로토콜(OTLP) 데이터로