Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

7 Funções de previsão

Todas as funções listadas aqui são suportadas em:

Algumas notas gerais sobre parâmetros de função:

  • Os parâmetros da função são separados por uma vírgula
  • Parâmetros de função opcionais (ou partes de parâmetros) são indicados por < >
  • Os parâmetros específicos da função são descritos com cada função
  • Os parâmetros /host/key e (sec|#num)<:time shift> nunca devem ser citado
Parâmetros comuns
  • /host/key é um primeiro parâmetro obrigatório comum para as funções referenciando o histórico de itens do host
  • (sec|#num)<:time shift> é um segundo parâmetro comum para o funções que fazem referência ao histórico do item do host, onde:
    • sec - máximo avaliação period em segundos (tempo sufixos podem ser usados), ou
    • #num - máximo avaliação range na última valores coletados (se precedidos por uma marca de hash)
    • time shift (opcional) permite mover o ponto de avaliação volta no tempo. Ver mais detalhes](/manual/config/triggers/expression#time_shift) em especificando a mudança de horário.

Funções de previsão

FUNÇÃO
Descrição Parâmetros específicos da função Comentários
previsão (/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>)
Valor futuro, max, min, delta ou avg do item. Consulte parâmetros comuns.

tempo - horizonte de previsão em segundos (os sufixos de tempo podem ser usado); valores negativos são suportados

fit (opcional; deve estar entre aspas duplas) - função usada para ajustar dados históricos

compatível com fits:
linear - linear função
polinômioN - polinômio de grau N (1 <= N <= 6)
exponencial - função exponencial
logarítmico - função logarítmica
potência - função de potência
>
Observe que:
linear é o padrão, polinomial1 é equivalente a linear

modo (opcional; deve estar entre aspas duplas) - saída exigida<br >
Modos compatíveis:
valor - valor (padrão)
max - máximo
min - mínimo
delta - max-min
avg - média

Observe que:
value estima o valor do item no momento now + time
max, min, delta e avg investigam a estimativa de valor do item no intervalo entre now e now + time
Tipos de valor suportados: float, int

Se o valor a ser retornado for maior que 1,7976931348623157E+308 ou menos que -1,7976931348623157E+308, o valor de retorno é cortado para 1,79769313486231 57E+308 ou -1,7976931348623157E+308 correspondentemente.

Torna-se incompatível apenas se usado incorretamente na expressão (tipo de item errado, parâmetros inválidos), caso contrário retorna -1 em caso de erros.

Exemplos:
=> previsão(/host/key,#10,1h) → valor do item previsto em uma hora com base nos últimos 10 valores
=> ** previsão(/host/key,1h,30m) → valor do item previsto em 30 minutos com base nos dados da última hora
=>
previsão(/host/key, 1h:agora-1d,12h) → valor do item previsto em 12 horas com base em uma hora do dia anterior
=>
previsão(/host/key,1h* *,10m,"exponencial") → valor do item de previsão em 10 minutos com base nos dados da última hora e função exponencial
=> previsão(/host/key,1h, 2h,"polinomial3","max") → preveja o valor máximo que o item pode atingir nas próximas duas horas com base nos dados da última hora e no polinômio cúbico (terceiro grau)
=> previsão (/host/key,#2,-20m) → estime o valor do item 20 minutos atrás com base nos dois últimos valores (t isso pode ser mais preciso do que usar last(), especialmente se o item for atualizado raramente, digamos, uma vez por hora)

Veja também informações adicionais sobre funções de gatilho preditivas .
timeleft (/host/key,(sec|#num)<:time shift>,threshold,<fit>)
Tempo em segundos necessário para um item atingir um limite especificado. Consulte parâmetros comuns.

limiar - valor a ser alcançado (sufixos de unidade podem ser usados)

fit (opcional; deve ser entre aspas duplas) - veja forecast()
Tipos de valor suportados: float, int

Se o valor a ser retornado for maior que 1,7976931348623157E+308, o valor de retorno será recortado para 1,7976931348623157E+308.

Retorna 1,7976931348623157E+308 se o limite não puder ser alcançado.

Torna-se incompatível somente se usado incorretamente. na expressão (tipo de item errado, parâmetros inválidos), caso contrário retorna -1 em caso de erros.

Exemplos:
=> timeleft(/host/key,#10 ,0) → tempo até que o valor do item chegue a zero com base nos últimos 10 valores
=> timeleft(/host/key,1h,100 ) → tempo até que o valor do item atinja 100 com base nos dados da última hora
=> timeleft(/host/key,1h:now-1d,100) → tempo até o valor do item atinge 100 com base em uma hora um dia atrás
=> timeleft(/host/key,1h,200,"polynomial2") → tempo até que o valor do item atinja 200 com base nos dados da última hora e supondo que o item se comporta como polinômio quadrático (segundo grau)
Veja também informações adicionais sobre funções de gatilho preditivas.