Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

prometheusQueryRange

View as MarkdownEdit this pageReport an issueSet up docs MCP

평가 시간 범위 전반에 걸쳐 TimeSeries 테이블의 데이터를 사용해 Prometheus 쿼리를 평가합니다.

구문

prometheusQueryRange('db_name', 'time_series_table', 'promql_query', start_time, end_time, step)
prometheusQueryRange(db_name.time_series_table, 'promql_query', start_time, end_time, step)
prometheusQueryRange('time_series_table', 'promql_query', start_time, end_time, step)

인수

  • db_name - TimeSeries 테이블이 있는 데이터베이스 이름입니다.
  • time_series_table - TimeSeries 테이블 이름입니다.
  • promql_query - PromQL 구문으로 작성한 쿼리입니다.
  • start_time - 평가 범위의 시작 시간입니다.
  • end_time - 평가 범위의 종료 시간입니다.
  • step - start_time부터 end_time까지(양 끝 포함) 평가 시간을 순회할 때 사용하는 간격입니다.

반환 값

이 함수는 매개변수 promql_query에 전달된 쿼리의 결과 유형에 따라 서로 다른 컬럼을 반환할 수 있습니다.

결과 유형 결과 컬럼 예시
vector tags Array(Tuple(String, String)), timestamp TimestampType, value ValueType prometheusQuery(mytable, 'up')
matrix tags Array(Tuple(String, String)), time_series Array(Tuple(TimestampType, ValueType)) prometheusQuery(mytable, 'up[1m]')
scalar scalar ValueType prometheusQuery(mytable, '1h30m')
string string String prometheusQuery(mytable, '"abc"')

지원되는 PromQL 기능

셀렉터

인스턴트 셀렉터, 범위 셀렉터, 레이블 매처(=, !=, =~, !~), offset 수정자, @ 타임스탬프 수정자, 그리고 서브쿼리.

함수

범주 함수
범위 rate, irate, delta, idelta, increase, last_over_time, deriv, changes, resets
수학 abs, sgn, floor, ceil, sqrt, exp, ln, log2, log10, rad, deg, round, clamp, clamp_min, clamp_max
삼각함수 sin, cos, tan, asin, acos, atan, sinh, cosh, tanh, asinh, acosh, atanh
DateTime day_of_week, day_of_month, days_in_month, day_of_year, minute, hour, month, year
레이블 label_replace, label_join
유형 scalar, vector
히스토그램 histogram_quantile
기타 time, pi

참고: histogram_quantile은 기존 히스토그램 버킷(le 레이블로 식별됨)에 선형 보간을 사용합니다. 네이티브 히스토그램은 지원되지 않습니다. phi(분위수 수준) 인수는 상수 스칼라여야 합니다. histogram_quantile(time() / 1000, ...)처럼 간격마다 값이 달라지는 표현식은 NOT_IMPLEMENTED 예외와 함께 거부됩니다.

연산자

on()/ignoring() 및 group_left()/group_right() 수정자와 함께 사용하는 모든 산술(+, -, *, /, %, ^, atan2), 비교(==, !=, <, >, <=, >=, 선택적 bool 포함) 이항 연산자

on()/ignoring() 수정자와 함께 사용하는 논리 집합 연산자 and, or, unless

단항 연산자 + 및 -.

집계 연산자

sum, avg, min, max, count, stddev, stdvar, group, quantile, topk, bottomk, limitk — 선택적으로 by() 또는 without() 수정자와 함께 사용할 수 있습니다.

아직 지원되지 않는 기능

  • 집계 연산자 count_values
  • 범위 함수 predict_linear, avg_over_time, min_over_time, max_over_time, sum_over_time, count_over_time, quantile_over_time, stddev_over_time, stdvar_over_time, present_over_time, absent_over_time, mad_over_time, first_over_time, ts_of_min_over_time, ts_of_max_over_time, ts_of_last_over_time, ts_of_first_over_time
  • 함수 absent

예시

SELECT * FROM prometheusQueryRange(mytable, 'rate(http_requests{job="prometheus"}[10m])[1h:10m]', now() - INTERVAL 10 MINUTES, now(), INTERVAL 1 MINUTE)
Navigation