메트릭

Tier: Ultimate Offering: GitLab.com Status: Beta
  • GitLab 16.7에서 observability_metrics라는 플래그로 도입되었습니다. 기본적으로 비활성화되어 있습니다. 이 기능은 Experiment입니다.

플래그: 이 기능은 GitLab.com에서만 사용할 수 있습니다. Self-Managed형 GitLab 및 GitLab Dedicated의 경우, 기본적으로 이 기능을 사용할 수 없습니다. 이 기능은 프로덕션 환경에서 사용할 준비가 되지 않았습니다.

메트릭은 모니터링된 시스템의 운영 상태에 대한 통찰을 제공합니다. 지정된 시간 범위 내에서 시스템 및 애플리케이션에 대해 더 알아보기 위해 메트릭을 사용하세요.

메트릭은 시계열 데이터로 구성되며 다음과 같습니다.

  • 타임스탬프로 색인화됨
  • 추가 데이터가 수집됨에 따라 지속적으로 확장됨
  • 일반적으로 집계되고, 다운샘플링되며, 범위별로 조회됨
  • 쓰기 집중적인 요구사항을 가짐

메트릭 구성

프로젝트에 메트릭을 활성화하려면 메트릭을 구성하세요.

전제 조건:

프로젝트에 대해 적어도 Maintainer 역할이 있어야 합니다.

  1. 액세스 토큰을 생성하고 메트릭을 활성화합니다:
    1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
    2. 설정 > 액세스 토큰을 선택합니다.
    3. 다음 스코프를 가진 액세스 토큰을 생성합니다: read_api, read_observability, write_observability. 나중을 위해 액세스 토큰 값을 저장하세요.
    4. 모니터 > 메트릭을 선택한 다음 활성화를 선택합니다.
  2. 애플리케이션을 구성하여 GitLab 메트릭을 보내려면 다음 환경 변수를 설정하세요:

    OTEL_EXPORTER = "otlphttp"
    OTEL_EXPORTER_OTLP_METRICS_ENDPOINT = "https://observe.gitlab.com/v3/<namespace-id>/<gitlab-project-id>/ingest/metrics"
    OTEL_EXPORTER_OTLP_METRICS_HEADERS = "PRIVATE-TOKEN=<gitlab-access-token>"
    

    다음 값을 사용합니다:

    • namespace-id - 프로젝트를 포함하는 최상위 그룹 ID
    • gitlab-project-id - 프로젝트 ID
    • gitlab-access-token - 생성한 액세스 토큰

프로젝트에 대해 메트릭이 구성됩니다. 애플리케이션을 실행하면 OpenTelemetry exporter가 메트릭을 GitLab에 보냅니다.

메트릭 보기

특정 프로젝트의 메트릭을 볼 수 있습니다:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 모니터 > 메트릭을 선택합니다.

메트릭 디렉터리이 표시됩니다. 세부 정보를 보려면 메트릭을 선택합니다.

메트릭 디렉터리

각 메트릭에는 하나 이상의 속성이 포함되어 있습니다. 검색 막대를 사용하여 속성별로 메트릭을 필터링할 수 있습니다.

메트릭 세부 정보

메트릭은 합계, 게이지 또는 히스토그램으로 표시됩니다. 메트릭 세부 정보 페이지에서는 메트릭 유형에 따라 차트가 표시됩니다.

메트릭 세부 정보 페이지에서 특정 시간 범위에 대한 메트릭도 볼 수 있으며, 속성별로 메트릭을 집계할 수 있습니다:

메트릭 세부 정보

데이터 조회를 빠르게 하기 위해 검색한 시간 기간에 따라, GitLab은 적절한 집계를 자동으로 선택합니다. 예를 들어, 7일 이상의 데이터를 검색하면 API는 일일 집계만 반환합니다.

검색 기간별 집계

다음 표는 각 검색 기간에 사용되는 집계 유형을 보여줍니다:

기간 사용되는 집계
30분 미만 수신된 원시 데이터
30분 이상 1시간 미만 분 단위로
1시간 이상 72시간 미만 시간별로
72시간 이상 일일로

데이터 보유

GitLab은 수신된 모든 메트릭에 대해 30일의 보유 기간 한도를 가지고 있습니다.