PromQL 쿼리¶

차트에 PromQL 쿼리를 적용하면 Prometheus 데이터 소스에서 시계열 데이터를 추출하고 분석하여 결과를 차트에 직관적으로 시각화할 수 있습니다.

쿼리 시작¶

1. PromQL 쿼리 추가를 클릭합니다.
2. 쿼리 방식을 선택합니다.
3. 쿼리를 시작합니다.

쿼리 방식¶

자세한 내용은 DQL과 다른 쿼리 언어 비교를 참조하거나 PromQL을 직접 방문하세요.

범위 쿼리¶

일정 시간 범위 내의 모니터링 데이터를 쿼리하여 범위 벡터(Range Vector)를 반환합니다. 즉, 지정된 시간 범위 내 각 시계열의 여러 샘플 값을 반환합니다. 구문에 시간 범위를 추가해야 합니다.

예시:

[5m]）：http_requests_total{job="api-server"}[5m]

이는 지난 5분 동안 각 시점의 총 요청 수를 반환함을 의미합니다.

즉시 쿼리¶

특정 시점의 모니터링 데이터를 쿼리하여 즉시 벡터(Instant Vector)를 반환합니다. 즉, 해당 시점 각 시계열의 최신 샘플 값을 반환합니다.

예시:

http_requests_total{job="api-server"}

이는 현재 시점에서 레이블 조건을 만족하는 모든 요청의 총 수를 반환함을 의미합니다.

쿼리 예시¶

예를 들어, 특정 영역의 동시성 제한기가 트리거되었는지 모니터링하여 잠재적인 성능 문제나 리소스 병목 현상을 신속하게 감지하려는 경우를 가정해 보겠습니다.

dataplatform:system_concurrent_limiter_current{region="#{region}"} > 0

위 쿼리문을 입력하면 system_concurrent_limiter_current 메트릭 값이 0보다 큰 모든 데이터 포인트를 필터링하며, 이러한 데이터 포인트의 region 레이블 값이 #{region}입니다.

region 값이 us-west-1이라고 가정하면 실제 쿼리문은 다음과 같이 변환됩니다.

dataplatform:system_concurrent_limiter_current{region="us-west-1"} > 0

이 쿼리는 region이 us-west-1이고 system_concurrent_limiter_current 메트릭 값이 0보다 큰 모든 시계열 데이터를 반환합니다.

필터 조건¶

PromQL 모드에서 필터 조건은 레이블 문자열 매칭만 지원하며, 시스템은 자동으로 조건에 맞는 필터를 PromQL 레이블 매처로 변환합니다.

지원되는 변환 규칙¶

지원되지 않는 필터¶

다음 필터 조건은 현재 지원되지 않습니다.

• 서로 다른 레이블 간의 OR

• 숫자 비교(>、<、>=、<=)

• 함수형 필터

사용 사례¶

PromQL 쿼리 인터페이스 정의에는 쿼리 데이터 처리 동작을 제어하는 3개의 매개변수 interval, timerange, align_time이 있으며, 그 의미는 다음과 같습니다.