Saltar al contenido principal
Evalúa una consulta de Prometheus con datos de una tabla TimeSeries en un intervalo de tiempos de evaluación.

Sintaxis

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)

Argumentos

  • db_name - El nombre de la base de datos donde se encuentra la tabla TimeSeries.
  • time_series_table - El nombre de una tabla TimeSeries.
  • promql_query - Una consulta escrita en sintaxis PromQL.
  • start_time - La hora de inicio del intervalo de evaluación.
  • end_time - La hora de finalización del intervalo de evaluación.
  • step - El paso utilizado para iterar el tiempo de evaluación desde start_time hasta end_time (ambos inclusive).

Valor devuelto

La función puede devolver distintas columnas según el tipo de resultado de la consulta proporcionada en el parámetro promql_query:
Tipo de resultadoColumnas de resultadoEjemplo
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”‘)

Ejemplo

SELECT * FROM prometheusQueryRange(mytable, 'rate(http_requests{job="prometheus"}[10m])[1h:10m]', now() - INTERVAL 10 MINUTES, now(), INTERVAL 1 MINUTE)
Última modificación el 10 de junio de 2026