메트릭
- GitLab 16.7에서
observability_metrics
라는 플래그로 도입되었습니다. 기본적으로 비활성화되어 있습니다. 이 기능은 Experiment입니다.
플래그: 이 기능은 GitLab.com에서만 사용할 수 있습니다. Self-Managed형 GitLab 및 GitLab Dedicated의 경우, 기본적으로 이 기능을 사용할 수 없습니다. 이 기능은 프로덕션 환경에서 사용할 준비가 되지 않았습니다.
메트릭은 모니터링된 시스템의 운영 상태에 대한 통찰을 제공합니다. 지정된 시간 범위 내에서 시스템 및 애플리케이션에 대해 더 알아보기 위해 메트릭을 사용하세요.
메트릭은 시계열 데이터로 구성되며 다음과 같습니다.
- 타임스탬프로 색인화됨
- 추가 데이터가 수집됨에 따라 지속적으로 확장됨
- 일반적으로 집계되고, 다운샘플링되며, 범위별로 조회됨
- 쓰기 집중적인 요구사항을 가짐
메트릭 구성
프로젝트에 메트릭을 활성화하려면 메트릭을 구성하세요.
전제 조건:
프로젝트에 대해 적어도 Maintainer 역할이 있어야 합니다.
- 액세스 토큰을 생성하고 메트릭을 활성화합니다:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 설정 > 액세스 토큰을 선택합니다.
- 다음 스코프를 가진 액세스 토큰을 생성합니다:
read_api
,read_observability
,write_observability
. 나중을 위해 액세스 토큰 값을 저장하세요. - 모니터 > 메트릭을 선택한 다음 활성화를 선택합니다.
-
애플리케이션을 구성하여 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에 보냅니다.
메트릭 보기
특정 프로젝트의 메트릭을 볼 수 있습니다:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 모니터 > 메트릭을 선택합니다.
메트릭 디렉터리이 표시됩니다. 세부 정보를 보려면 메트릭을 선택합니다.
각 메트릭에는 하나 이상의 속성이 포함되어 있습니다. 검색 막대를 사용하여 속성별로 메트릭을 필터링할 수 있습니다.
메트릭 세부 정보
메트릭은 합계, 게이지 또는 히스토그램으로 표시됩니다. 메트릭 세부 정보 페이지에서는 메트릭 유형에 따라 차트가 표시됩니다.
메트릭 세부 정보 페이지에서 특정 시간 범위에 대한 메트릭도 볼 수 있으며, 속성별로 메트릭을 집계할 수 있습니다:
데이터 조회를 빠르게 하기 위해 검색한 시간 기간에 따라, GitLab은 적절한 집계를 자동으로 선택합니다. 예를 들어, 7일 이상의 데이터를 검색하면 API는 일일 집계만 반환합니다.
검색 기간별 집계
다음 표는 각 검색 기간에 사용되는 집계 유형을 보여줍니다:
기간 | 사용되는 집계 |
---|---|
30분 미만 | 수신된 원시 데이터 |
30분 이상 1시간 미만 | 분 단위로 |
1시간 이상 72시간 미만 | 시간별로 |
72시간 이상 | 일일로 |
데이터 보유
GitLab은 수신된 모든 메트릭에 대해 30일의 보유 기간 한도를 가지고 있습니다.