• 메트릭 구성
• 메트릭 보기
  • 메트릭 상세 정보

메트릭

• GitLab 16.7에서 observability_metrics라는 플래그로 도입되었습니다. 기본으로 비활성화되어 있습니다. 이 기능은 실험입니다.

메트릭은 모니터링된 시스템의 운영 상태에 대한 통찰력을 제공합니다. 주어진 시간 범위에서 시스템 및 응용 프로그램에 대해 더 많은 정보를 알아내기 위해 메트릭을 사용하세요.

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

• 타임스탬프로 색인화됨
• 추가 데이터가 수집될수록 지속적으로 확장됨
• 일반적으로 집계되고 다운샘플링되며 범위로 쿼리됨
• 쓰기 집중적 요구사항이 있음

메트릭 구성

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

필수 구성 요소:

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

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 익스포터가 메트릭을 GitLab으로 전송합니다.

메트릭 보기

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

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

메트릭 목록이 표시됩니다. 세부 정보를 보려면 메트릭을 선택하세요.

메트릭 상세 정보

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

메트릭 상세 정보 페이지에서 특정 시간 범위에 대한 메트릭도 볼 수 있습니다.