Avalia uma consulta do Prometheus usando dados de uma tabela TimeSeries em um intervalo de momentos de avaliação.
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 - O nome do banco de dados em que uma tabela TimeSeries está localizada.
time_series_table - O nome de uma tabela TimeSeries.
promql_query - Uma consulta escrita em sintaxe PromQL.
start_time - O horário de início do intervalo de avaliação.
end_time - O horário de término do intervalo de avaliação.
step - O passo usado para percorrer o tempo de avaliação de start_time até end_time (inclusive).
A função pode retornar colunas diferentes, dependendo do tipo de resultado da consulta passada no parâmetro promql_query:
| Tipo de resultado | Colunas retornadas | Exemplo |
|---|
| 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”‘) |
SELECT * FROM prometheusQueryRange(mytable, 'rate(http_requests{job="prometheus"}[10m])[1h:10m]', now() - INTERVAL 10 MINUTES, now(), INTERVAL 1 MINUTE)
Última modificação em 10 de junho de 2026