메트릭

Tier: Ultimate Offering: GitLab.com, Self-managed Status: Beta

History

Introduced in GitLab 16.7 with a flag named observability_metrics. Disabled by default. This feature is an experiment.
Feature flag changed in GitLab 17.3 to the observability_features feature flag, disabled by default. The previous feature flag (observability_metrics) was removed.
Introduced for self-managed in GitLab 17.3.

이 기능의 사용 가능 여부는 피쳐 플래그(feature flag)로 제어됩니다. 자세한 정보는 이력을 참조하세요. 이 기능은 테스트용으로 제공되지만 프로덕션 사용 준비가 되지는 않았습니다.

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

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

메트릭 구성

프로젝트에서 메트릭을 사용하도록 구성하세요.

필수 조건:

프로젝트에 대한 최소한 Maintainer 역할이 있어야 합니다.

액세스 토큰 만들기:
1. 왼쪽 사이드바에서 검색 또는 이동하여를 선택하고 프로젝트를 찾습니다.
2. 설정 > 액세스 토큰을 선택합니다.
3. api 범위 및 Developer 역할 이상을 가진 액세스 토큰을 만듭니다. 나중에 사용할 수 있도록 액세스 토큰 값을 저장하세요.
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 - Self-managed 인스턴스의 호스트명 또는 gitlab.com
- gitlab-project-id - 프로젝트 ID
- gitlab-access-token - 생성한 액세스 토큰

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

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

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

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

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

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

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

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

메트릭은 분당 최대 102,400바이트를 수집합니다. 한도를 초과하면 429 Too Many Requests 응답이 반환됩니다.

분당 1,048,576바이트로 한도를 요청하려면 GitLab 지원팀에 문의하세요.

GitLab은 수집된 모든 메트릭에 대해 30일 보존 제한이 있습니다.

메트릭을 추적하기 위해 어떠한 작업을 수행하거나 조사하는 것을 추적하는 문제를 생성할 수 있습니다. 메트릭에 대한 문제를 생성하려면:

선택한 프로젝트에 문제가 생성되며 메트릭 정보로 사전 작성됩니다. 이슈 제목과 설명을 편집할 수 있습니다.