Prometheus: Up & Running, 2nd Edition

5장. 레이블

이 작품은 AI를 사용하여 번역되었습니다. 여러분의 피드백과 의견을 환영합니다: [e-mail]

레이블은 Prometheus의 핵심 부분이며, 강력한 기능 중 하나입니다. 이 장에서는 레이블의 정의, 레이블의 출처 및 자체 지표에 레이블을 추가하는 방법에 대해 알아봅니다.

라벨이란 무엇인가요?

레이블은 시계열과 관련된 키-값 쌍으로, 메트릭 이름과 함께 고유하게 식별합니다. 말이 좀 많으니 예를 들어 보겠습니다.

HTTP 요청에 대한 메트릭이 경로별로 세분화되어 있는 경우 Graphite에서 일반적으로 사용되는 것처럼 메트릭 이름에 경로를 넣어 볼 수 있습니다:¹

http_requests_login_total
http_requests_logout_total
http_requests_adduser_total
http_requests_comment_total
http_requests_view_total

이러한 메트릭은 PromQL에서 작업하기 어려울 수 있습니다. 총 요청을 계산하려면 가능한 모든 HTTP 경로를 알고 있거나 모든 메트릭 이름에 대해 잠재적으로 비용이 많이 드는 매칭을 수행해야 합니다. 따라서 이 패턴은 피해야 하는 안티패턴입니다. 대신, 이러한 일반적인 사용 사례를 처리하기 위해 Prometheus에는 레이블이 있습니다. 앞의 경우path 레이블을 사용할 수 있습니다:

http_requests_total{path="/login"}
http_requests_total{path="/logout"}
http_requests_total{path="/adduser"}
http_requests_total{path="/comment"}
http_requests_total{path="/view"}

그런 다음 모든 path 레이블을 하나로 묶어 http_requests_total 메트릭으로 작업할 수 있습니다. PromQL을 사용하면 전체 집계된 요청 비율, 경로 중 하나의 비율 또는 각 요청이 전체에서 차지하는 비율을 얻을 수 있습니다.

레이블이 두 개 이상인 메트릭을 가질 수도 있습니다. 레이블에는 순서가 없으므로 다른 레이블을 무시하고 특정 레이블을 기준으로 집계하거나 여러 레이블을 한꺼번에 집계할 수도 있습니다.

계측 및 대상 레이블

레이블은 계측 레이블과 대상 레이블의 두 가지 소스에서 제공됩니다.PromQL에서 작업할 때는 둘 사이에 차이가 없지만, 레이블을 최대한 활용하려면 이 둘을 구별하는 것이 중요합니다.

계측 레이블은 이름에서 알 수 있듯이 계측에서 비롯되며, 애플리케이션 또는 라이브러리에서 수신하는 HTTP 요청 유형, 데이터베이스와 통신하는 데이터베이스 및 기타 내부 세부 사항 등 애플리케이션 또는 라이브러리 내부에서 알려진 사항에 관한 것입니다.

대상 레이블은 특정 모니터링 대상, 즉 Prometheus가 스크랩하는 대상을 식별합니다. 대상 레이블은 아키텍처와 더 관련이 있으며, 어떤 애플리케이션인지, 어떤 데이터센터에 있는지, 개발 또는 프로덕션 환경에 있는지, ...