본문으로 바로가기
본문으로 바로가기

prometheusQuery 테이블 함수

지정된 평가 시간 구간 동안 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)

Arguments

  • db_name - TimeSeries 테이블이 위치한 데이터베이스 이름입니다.
  • time_series_table - TimeSeries 테이블 이름입니다.
  • promql_query - PromQL 구문으로 작성된 쿼리입니다.
  • start_time - 평가 범위의 시작 시간입니다.
  • end_time - 평가 범위의 종료 시간입니다.
  • step - start_time부터 end_time까지(포함하여) 평가 시간을 반복하는 데 사용되는 간격(스텝)입니다.

반환 값

이 함수는 promql_query 매개변수로 전달된 쿼리의 결과 타입에 따라 서로 다른 컬럼을 반환합니다.

결과 타입결과 컬럼예시
vectortags Array(Tuple(String, String)), timestamp TimestampType, value ValueTypeprometheusQuery(mytable, 'up')
matrixtags Array(Tuple(String, String)), time_series Array(Tuple(TimestampType, ValueType))prometheusQuery(mytable, 'up[1m]')
scalarscalar ValueTypeprometheusQuery(mytable, '1h30m')
stringstring StringprometheusQuery(mytable, '"abc"')

예제

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