Skip to main content

timeSeriesChangesToGrid

Introduzido em: v25.6.0 Função de agregação que recebe dados de séries temporais como pares de timestamps e valores e calcula alterações no estilo do PromQL com base nesses dados em uma grade temporal regular definida por timestamp inicial, timestamp final e passo. Para cada ponto da grade, as amostras usadas no cálculo de changes são consideradas dentro da janela de tempo especificada.
Esta função é experimental; habilite-a definindo allow_experimental_time_series_aggregate_functions=true.
Sintaxe
Parâmetros
  • start_timestamp — Especifica o início da grade. Quando o argumento de timestamp é do tipo DateTime64, também pode ser um número fracionário ou uma string contendo um número ou texto de data e hora. UInt32 ou DateTime ou DateTime64 ou Float* ou Decimal* ou String
  • end_timestamp — Especifica o fim da grade. Quando o argumento de timestamp é do tipo DateTime64, também pode ser um número fracionário ou uma string contendo um número ou texto de data e hora. UInt32 ou DateTime ou DateTime64 ou Float* ou Decimal* ou String
  • grid_step — Especifica o passo da grade em segundos. Quando o argumento de timestamp é do tipo DateTime64, também pode ser um número fracionário ou uma string contendo um número ou uma duração como ’15s’ ou ‘1m’. UInt32 ou Float* ou Decimal* ou String
  • staleness — Especifica a “staleness” máxima, em segundos, das amostras consideradas. Quando o argumento de timestamp é do tipo DateTime64, também pode ser um número fracionário ou uma string contendo um número ou uma duração como ’15s’ ou ‘1m’. UInt32 ou Float* ou Decimal* ou String
Argumentos
  • timestamp — Timestamp da amostra. Pode ser um valor individual ou arrays. - value — Valor da série temporal correspondente ao timestamp. Pode ser um valor individual ou arrays.
Valor retornado Valores de changes na grade especificada como um Array(Nullable(Float64)). O array retornado contém um valor para cada ponto da grade de tempo. O valor é NULL se não houver amostras dentro da janela para calcular o valor de changes de um determinado ponto da grade. Exemplos Calcular valores de changes na grade [90, 105, 120, 135, 150, 165, 180, 195, 210, 225]
Query
Response
A mesma consulta com argumentos de Array
Query
Response
Última modificação em 18 de agosto de 2026