GitLab Observability에 텔레메트리 데이터 전송

GitLab Observability를 구성한 후 애플리케이션 계측, 테스트 데이터 전송, 대시보드 템플릿 활용 방법을 설명합니다.

GitLab Observability에 텔레메트리 데이터 전송 # - Tier: Free, Premium, Ultimate - Offering: GitLab.com, GitLab Self-Managed # Status: Experiment Observability를 구성한 후 GitLab에 데이터 전송을 시작할 수 있습니다. 시작하려면 CI/CD 파이프라인 데이터 를 확인하거나, 테스트 데이터를 전송 하거나, 템플릿을 사용 하세요. Observability 데이터 보기 # GitLab Observability를 구성한 후: 상단 바에서 검색 또는 이동 을 선택하고 그룹을 찾으세요. 왼쪽 사이드바에서 Observability > Services 를 선택하세요. 세부 정보를 볼 서비스를 선택하세요. [ ](/19.1/operations/img/gitLab_o11y_gitlab_com_dashboard_v18_1.png) 애플리케이션 계측 # 애플리케이션에 OpenTelemetry 계측을 추가하려면: 사용하는 언어의 OpenTelemetry SDK를 추가하세요. OTLP 익스포터가 GitLab Observability 인스턴스를 가리키도록 구성하세요. 권장 리소스 속성을 구성하세요. 작업과 메타데이터를 추적하는 span 및 속성을 추가하세요. 언어별 지침은 OpenTelemetry 문서 를 참조하세요. 권장 리소스 속성 # 이 리소스 속성으로 OpenTelemetry SDK를 구성하면 텔레메트리 데이터를 GitLab 프로젝트 및 코드와 연결할 수 있습니다. 이를 통해 트레이스를 커밋에 연관 짓거나 예외 발생 시 이슈를 자동으로 생성하는 기능을 활성화할 수 있습니다. 리소스 속성 GitLab CI/CD 변수 설명 gitlab.project.id CI_PROJECT_ID 텔레메트리를 GitLab 프로젝트에 연결합니다. GitLab Duo 연동에 필요합니다. gitlab.project.name CI_PROJECT_NAME 대시보드에 표시되는 사람이 읽을 수 있는 프로젝트 이름입니다. service.version CI_COMMIT_SHA 실행 중인 코드의 커밋 SHA입니다. 트레이스와 오류를 정확히 배포된 버전과 연관 지을 수 있습니다. deployment.environment.name CI_ENVIRONMENT_NAME 코드가 실행 중인 환경입니다(예: production 또는 staging). service.version 과 deployment.environment.name 은 OpenTelemetry 시맨틱 컨벤션 입니다. gitlab.* 속성은 GitLab 특정 컨텍스트를 위한 벤더 네임스페이스를 사용합니다. 네 가지 변수 모두 GitLab CI/CD에 사전 정의 되어 있으며, 애플리케이션이 파이프라인에서 실행될 때 추가 구성이 필요하지 않습니다. 로컬 개발 환경에서는 이 환경 변수를 수동으로 설정하거나 빈 기본값을 그대로 사용하세요. 다음 Ruby 예시는 이러한 속성을 구성하는 방법을 보여줍니다: OpenTelemetry::SDK.confi