8 Funções preditivas

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

• Expressões de trigger
• Itens calculados
• Macros de expressão

As funções são listadas sem informações adicionais. Clique na função para ver os detalhes completos.

Parâmetros comuns

• /host/key é um parâmetro obrigatório comum para as funções que referenciam o histórico do item do host
• (sec|#num)<:deslocamento de tempo> é um parâmetro comum para as funções que referenciam o histórico do item do host, onde:
  • sec - período de avaliação máximo em segundos (sufixos de tempo podem ser usados), ou
  • #num - intervalo de avaliação máximo nos últimos valores coletados (se precedido por uma cerquilha)
  • deslocamento de tempo (opcional) permite mover o ponto de avaliação para trás no tempo. Veja mais detalhes sobre como especificar o deslocamento de tempo.

Detalhes da função

Algumas observações gerais sobre os parâmetros da função:

• Os parâmetros da função são separados por vírgula
• Parâmetros opcionais da função (ou partes do parâmetro) são indicados por < >
• 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 colocados entre aspas

forecast(/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>)

The future value, max, min, delta or avg of the item.
Supported value types: Float, Integer.

Parameters:

• See common parameters;
  
• time - the forecasting horizon in seconds (time suffixes can be used); negative values are supported;
  
• fit (optional; must be double-quoted) - the function used to fit historical data. Supported fits:
  linear - linear function (default)
  polynomialN - polynomial of degree N (1 <= N <= 6)
  exponential - exponential function
  logarithmic - logarithmic function
  power - power function
  Note that polynomial1 is equivalent to linear;
• mode (optional; must be double-quoted) - the demanded output. Supported modes:
  value - value (default)
  max - maximum
  min - minimum
  delta - max-min
  avg - average
  Note that value estimates the item value at the moment now + time; max, min, delta and avg investigate the item value estimate on the interval between now and now + time.

Comments:

• If the value to return is larger than 1.7976931348623158E+308 or less than -1.7976931348623158E+308, the return value is cropped to 1.7976931348623158E+308 or -1.7976931348623158E+308 correspondingly;
• Becomes unsupported only if misused in the expression (wrong item type, invalid parameters), otherwise returns -1 in case of errors;
• See also additional information on predictive trigger functions.

Examples:

forecast(/host/key,#10,1h) #forecast the item value in one hour based on the last 10 values
       forecast(/host/key,1h,30m) #forecast the item value in 30 minutes based on the last hour data
       forecast(/host/key,1h:now-1d,12h) #forecast the item value in 12 hours based on one hour one day ago
       forecast(/host/key,1h,10m,"exponential") #forecast the item value in 10 minutes based on the last hour data and exponential function
       forecast(/host/key,1h,2h,"polynomial3","max") #forecast the maximum value the item can reach in the next two hours based on last hour data and cubic (third degree) polynomial
       forecast(/host/key,#2,-20m) #estimate the item value 20 minutes ago based on the last two values (this can be more precise than using last(), especially if the item is updated rarely, say, once an hour)

timeleft(/host/key,(sec|#num)<:time shift>,threshold,<fit>)

O tempo em segundos necessário para que um item atinja o limite especificado.
Tipos de valores suportados: Float, Integer.

Parâmetros:

• Veja parâmetros comuns;
  
• threshold - o valor a ser atingido (sufixos de unidade podem ser usados);
• fit (opcional; deve ser colocado entre aspas duplas) - veja forecast().

Comentários:

• Se o valor a ser retornado for maior que 1.7976931348623158E+308, o valor de retorno é limitado a 1.7976931348623158E+308;
• Retorna 1.7976931348623158E+308 se o limite não puder ser atingido;
• Torna-se não suportado apenas se for usado incorretamente na expressão (tipo de item errado, parâmetros inválidos), caso contrário retorna -1 em caso de erros;
• Veja também informações adicionais sobre funções de trigger preditivas.

Exemplos:

timeleft(/host/key,#10,0) #o tempo até que o valor do item atinja zero com base nos últimos 10 valores
       timeleft(/host/key,1h,100) #o tempo até que o valor do item atinja 100 com base nos dados da última hora
       timeleft(/host/key,1h:now-1d,100) #o tempo até que o valor do item atinja 100 com base em uma hora de um dia atrás
       timeleft(/host/key,1h,200,"polynomial2") #o tempo até que o valor do item atinja 200 com base nos dados da última hora e assumindo que o item se comporta como um polinômio quadrático (de segundo grau)

Veja todas as funções suportadas.