분산 추적
Status: Beta
이 기능의 사용 가능성은 기능 플래그에 의해 제어됩니다.
자세한 정보는 역사 기록을 참조하세요.
이 기능은 테스트용으로 제공되지만 생산 환경에서는 사용할 준비가 되어 있지 않습니다.
분산 추적을 사용하면 애플리케이션 성능 문제를 해결하기 위해 요청이 다양한 서비스와 시스템을 통과하는 방식을 검사하고, 각 작업의 타이밍 및 발생하는 모든 오류 또는 로그를 검사할 수 있습니다.
추적은 여러 독립적인 서비스가 사용자 요청을 수행하기 위해 협력하는 마이크로서비스 애플리케이션의 맥락에서 특히 유용합니다.
이 기능은 베타입니다.
자세한 정보는 그룹 방향 페이지를 참조하세요.
추적 버그 또는 기능에 대한 피드백을 남기려면 피드백 문제에 댓글을 달거나 새 문제를 열어주세요.
추적 수집 한계
추적은 분당 102,400 바이트의 최대 수집량을 가집니다.
한계를 초과하면 429 Too Many Requests 응답이 반환됩니다.
1,048,576 바이트로 한도 증가를 요청하려면 GitLab 지원에 문의하세요.
데이터 보존
GitLab은 모든 추적을 30일 동안 보존합니다.
프로젝트에 대한 분산 추적 구성
프로젝트에 대해 분산 추적을 활성화하도록 구성합니다.
사전 요구 사항:
- 프로젝트에 대해 최소한 Maintainer 역할이 있어야 합니다.
- 액세스 토큰을 생성합니다:
- 왼쪽 사이드바에서 검색하거나 이동을 선택하고 프로젝트를 찾습니다.
- 설정 > 액세스 토큰을 선택합니다.
-
api범위와 Developer 역할 이상을 가진 액세스 토큰을 생성합니다.
나중에 사용할 수 있도록 액세스 토큰 값을 저장합니다.
-
GitLab 추적을 전송하도록 애플리케이션을 구성하려면 다음 환경 변수를 설정합니다:
OTEL_EXPORTER = "otlphttp" OTEL_EXPORTER_OTLP_ENDPOINT = "https://gitlab.example.com/api/v4/projects/<gitlab-project-id>/observability/" OTEL_EXPORTER_OTLP_HEADERS = "PRIVATE-TOKEN=<gitlab-access-token>"다음 값을 사용하세요:
-
gitlab.example.com- 자체 관리 인스턴스의 호스트 이름 또는gitlab.com -
gitlab-project-id- 프로젝트 ID입니다. -
gitlab-access-token- 생성한 액세스 토큰
-
애플리케이션 구성이 완료되면 실행하고, OpenTelemetry 내보내기는 GitLab에 추적을 전송하려고 시도합니다.
추적 보기
추적이 성공적으로 내보내진 경우, 프로젝트에서 이를 볼 수 있습니다.
추적 목록을 보려면:
-
왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
모니터 > 추적을 선택합니다.
-
선택 사항. 추적의 세부 정보를 보려면 목록에서 선택합니다.
추적 세부 정보 페이지와 스팬 목록이 표시됩니다.
-
선택 사항. 단일 스팬의 속성을 보려면 목록에서 선택합니다.
추적을 위한 이슈 생성
추적을 해결하거나 조사하기 위해 수행된 모든 작업을 추적하기 위해 이슈를 생성할 수 있습니다. 추적을 위한 이슈를 생성하려면:
-
왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
모니터 > 추적을 선택합니다.
-
추적 목록에서 추적을 선택합니다.
-
이슈 생성을 선택합니다.
이슈는 선택한 프로젝트에 생성되며, 추적의 정보로 미리 채워집니다.
이슈 제목과 설명을 편집할 수 있습니다.
추적과 관련된 이슈 보기
-
왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
-
모니터 > 추적을 선택합니다.
-
추적 목록에서 추적을 선택합니다.
-
관련 이슈로 스크롤합니다.
-
선택 사항. 이슈 세부 정보를 보려면 이슈를 선택합니다.
도움말