timeSeriesSelector

timeSeriesSelector

선택자(selector)로 필터링되고 지정된 시간 구간의 타임스탬프를 가진 TimeSeries 테이블에서 시계열을 읽는 테이블 함수예요. 이 함수는 범위 선택자(range selectors)와 비슷하지만 순간 선택자(instant selectors)를 구현하는 데도 사용돼요.

출처: 문서

본문

구문(Syntax)

timeSeriesSelector('db_name', 'time_series_table', 'instant_query', min_time, max_time)
timeSeriesSelector(db_name.time_series_table, 'instant_query', min_time, max_time)
timeSeriesSelector('time_series_table', 'instant_query', min_time, max_time)

인자(Arguments)

  • db_name — TimeSeries 테이블이 위치한 데이터베이스의 이름.
  • time_series_table — TimeSeries 테이블의 이름.
  • instant_query — @나 offset 수정자 없이 PromQL 구문으로 작성한 순간 선택자.
  • min_time — 시작 타임스탬프, 포함.
  • max_time — 종료 타임스탬프, 포함.

반환 값(Returned value)

이 함수는 세 개의 컬럼을 반환해요:

  • id — 지정된 선택자와 일치하는 시계열의 식별자.
  • timestamp — 타임스탬프.
  • value — 값.

반환 데이터에는 특별한 순서가 없어요.

예시(Example)

SELECT * FROM timeSeriesSelector(mytable, 'http_requests{job="prometheus"}', now() - INTERVAL 10 MINUTES, now())

더 알아보기 (Learn more)