메트릭

Tier: Ultimate Offering: GitLab.com Status: Beta

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

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

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

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

메트릭 구성

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

전제 조건:

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

액세스 토큰을 생성하고 메트릭을 활성화합니다:
1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 설정 > 액세스 토큰을 선택합니다.
3. 다음 스코프를 가진 액세스 토큰을 생성합니다: read_api, read_observability, write_observability. 나중을 위해 액세스 토큰 값을 저장하세요.
4. 모니터 > 메트릭을 선택한 다음 활성화를 선택합니다.
애플리케이션을 구성하여 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는 일일 집계만 반환합니다.

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

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