Docs

Components

Metrics

• 카운터 (Counter): 단일 증가하는 카운터를 나타내는 누적 메트릭으로, 값이 증가하거나 재시작 시 0으로 재설정될 수 있습니다.
• 게이지 (Gauge): 값이 임의로 올라가거나 내려갈 수 있는 단일 숫자 값을 나타내는 메트릭입니다.
• 히스토그램 (Histogram): 관찰을 샘플링하고 구성 가능한 버킷에 해당하는 관찰 수를 셉니다. 주로 요청 지속 시간이나 응답 크기 같은 것을 측정합니다.
• 서머리 (Summary): 히스토그램과 유사하지만, 관찰된 값의 총 합계와 개수, 구성 가능한 분위수(quantile)도 제공합니다.

메트릭 레지스트리

메트릭 레지스트리는 모든 메트릭이 등록되는 중앙 장소입니다. 이는 메트릭 객체에 대한 참조를 저장하는 Registry 클래스의 인스턴스입니다.

메트릭 레지스트리의 기능:

1. 수집: 레지스트리는 다양한 소스로부터 메트릭 데이터를 수집합니다. 이러한 메트릭은 일반적으로 Prometheus 클라이언트 라이브러리를 사용하여 애플리케이션 코드 내에서 계측됩니다.
2. 저장: 레지스트리는 등록된 모든 메트릭과 현재 값을 저장합니다.
3. 스크래핑: 레지스트리는 Prometheus 서버가 일정 간격으로 데이터를 스크래핑할 수 있도록 합니다.
4. 노출: 레지스트리는 메트릭을 Prometheus가 이해할 수 있는 형식으로 (보통 HTTP를 통한 평문 형식) 노출합니다.

Prometheus 클라이언트 라이브러리와의 상호작용

Prometheus 클라이언트 라이브러리는 애플리케이션을 계측하고 메트릭을 생성하는 데 필요한 도구를 제공합니다. 이러한 라이브러리는 일반적으로 다음을 포함합니다:

• 메트릭 생성 (카운터, 게이지, 히스토그램, 서머리)
• 레지스트리에 메트릭 등록
• HTTP 엔드포인트를 통해 메트릭 노출