• 메트릭 구성
• 메트릭 보기
  • 메트릭 세부정보
  • 검색 기간에 따른 집계
  • 메트릭 수집 한도
  • 데이터 보존
  • 메트릭에 대한 이슈 생성
  • 메트릭과 관련된 이슈 보기

메트릭

• 소개됨 GitLab 16.7에서 observability_metrics라는 이름의 플래그와 함께 활성화됨. 기본적으로 비활성화되어 있습니다. 이 기능은 실험입니다.
• 기능 플래그 변경됨 GitLab 17.3에서 observability_features 기능 플래그로, 기본적으로 비활성화되어 있습니다. 이전 기능 플래그(observability_metrics)는 제거되었습니다.
• 소개됨 GitLab 17.3에서 Self-managed에 대해.

메트릭은 모니터링된 시스템의 운영 상태에 대한 통찰력을 제공합니다.
주어진 시간 범위 내에서 시스템과 애플리케이션에 대한 자세한 내용을 알아보려면 메트릭을 사용하세요.

메트릭은 시계열 데이터로 구조화되어 있으며:

• 타임스탬프별로 인덱싱됨
• 추가 데이터가 수집됨에 따라 지속적으로 확장됨
• 일반적으로 집계되어 다운샘플링되고 범위에 따라 쿼리됨
• 쓰기 집약적인 요구 사항이 있음

메트릭 구성

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

사전 요구 사항:

프로젝트에 대해 최소한 유지 관리자인 역할이 있어야 합니다.

1. 액세스 토큰을 생성합니다:
   1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
   2. 설정 > 엑세스 토큰을 선택합니다.
   3. api 범위 및 개발자 역할 이상의 액세스 토큰을 생성합니다.
      나중에 사용할 수 있도록 액세스 토큰 값을 저장합니다.

2. 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에 메트릭을 보냅니다.

메트릭 보기

주어진 프로젝트에 대한 메트릭을 볼 수 있습니다:

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

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

각 메트릭에는 하나 이상의 속성이 포함됩니다.
검색창으로 속성으로 메트릭을 필터링할 수 있습니다.

메트릭 세부정보

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

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

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

검색 기간에 따른 집계

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

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

메트릭 수집 한도

메트릭은 최대 102,400 바이트를 분당 수집합니다.

한도를 초과하면 429 Too Many Requests 응답이 반환됩니다.

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

데이터 보존

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

메트릭에 대한 이슈 생성

메트릭을 해결하거나 조사하기 위해 취한 조치를 추적하기 위해 이슈를 생성할 수 있습니다. 메트릭에 대한 이슈를 생성하려면:

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

이슈는 선택한 프로젝트에 생성되며 메트릭의 정보로 미리 채워집니다.

이슈 제목과 설명을 편집할 수 있습니다.

메트릭과 관련된 이슈 보기

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 모니터 > 메트릭을 선택합니다.
3. 메트릭 목록에서 메트릭을 선택합니다.
4. 관련 이슈로 스크롤합니다.
5. 선택 사항. 이슈 세부정보를 보려면 이슈를 선택합니다.