분산 추적

Tier: Ultimate Offering: GitLab.com, Self-managed Status: Beta
  • GitLab 16.2에서 observability_tracing이라는 플래그로 도입되었습니다. 기본적으로 비활성화됩니다. 이 기능은 베타 단계에 있습니다.
  • 기능 플래그는 GitLab 17.3에서 observability_features 기능 플래그로 변경되었으며, 기본적으로 비활성화됩니다. 이전 기능 플래그인 observability_tracing이 제거되었습니다.
  • GitLab 17.3에서 자체 호스팅을 위해 도입되었습니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 정보는 이력을 참조하세요. 이 기능은 테스트용으로 제공되지만, 실제 운영에는 준비되어 있지 않습니다.

분산 추적을 통해 요청이 서로 다른 서비스 및 시스템을 통과하는 방식, 각 작업의 타이밍 및 발생하는 오류 또는 로그를 조사하여 응용 프로그램의 성능 문제를 해결할 수 있습니다. 추적은 특히 사용자 요청을 충족하기 위해 여러 독립적인 서비스를 그룹화하는 마이크로서비스 응용프로그램의 맥락에서 특히 유용합니다.

이 기능은 베타 단계에 있습니다. 자세한 정보는 그룹 방향 페이지를 참조하십시오. 추적 버그 또는 기능에 대한 피드백을 제공하려면 피드백 이슈에 댓글을 남기거나 새 이슈를 엽니다.

추적 투입 한도

추적은 분당 102,400바이트까지 투입됩니다. 한도를 초과하면 429 Too Many Requests 응답이 반환됩니다.

분당 1,048,576바이트까지 한도를 늘리려면 GitLab 지원팀에 문의하십시오.

데이터 유지 기간

GitLab은 모든 추적을 30일 동안 보유합니다.

프로젝트용 분산 추적 구성

프로젝트에 분산 추적을 활성화하려면 다음을 수행합니다.

전제 조건:

  • 프로젝트의 유지자 역할 이상이어야 합니다.
  1. 액세스 토큰을 생성합니다:
    1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
    2. 설정 > 액세스 토큰을 선택합니다.
    3. api 범위 및 개발자 또는 해당 이상의 역할로 액세스 토큰을 생성합니다. 생성된 액세스 토큰 값을 나중에 사용하도록 저장합니다.

  2. 응용 프로그램을 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에 전송하려고 시도합니다.

추적 보기

추적이 성공적으로 내보내지면 프로젝트에서 해당 추적을 볼 수 있습니다.

추적 목록을 보려면:

  1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 모니터 > 추적을 선택합니다.
  3. 선택 사항. 추적의 세부 정보를 보려면 목록에서 선택합니다.

추적 목록

추적 상세 페이지 및 스패너 목록이 표시됩니다.

추적 세부 정보

  1. 선택 사항. 단일 스패너의 속성을 보려면 목록에서 선택합니다.

    추적 서랍

추적용 이슈 생성

추적을 해결하거나 조사하기 위해 수행한 모든 작업을 추적하는 이슈를 생성할 수 있습니다. 추적용 이슈를 생성하려면:

  1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 모니터 > 추적을 선택합니다.
  3. 추적 목록에서 추적을 선택합니다.
  4. 이슈 생성을 선택합니다.

선택한 프로젝트에 이슈가 생성되고 추적에서 정보가 미리 채워집니다. 이슈 제목과 설명을 편집할 수 있습니다.

추적과 관련된 이슈 보기

  1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 모니터 > 추적을 선택합니다.
  3. 추적 목록에서 추적을 선택합니다.
  4. 관련 이슈로 스크롤합니다.
  5. 선택 사항. 이슈 세부 정보를 보려면 이슈를 선택합니다.