8 Funciones predictivas

Todas las funciones enumeradas aquí son compatibles con:

• Expresiones de trigger
• Items calculados
• Macros de expresión

Las funciones se enumeran sin información adicional. Haga clic en la función para ver los detalles completos.

Parámetros comunes

• /host/key es un primer parámetro obligatorio común para las funciones que hacen referencia al historial del item del host
• (sec|#num)<:time shift> es un segundo parámetro común para las funciones que hacen referencia al historial del item del host, donde:
  • sec - período máximo de evaluación en segundos (se pueden usar sufijos de tiempo), o
  • #num - rango de evaluación máximo en los últimos valores recopilados (si va precedido por una almohadilla)
  • time shift (opcional) permite mover el punto de evaluación hacia atrás en el tiempo. Consulte más detalles sobre la especificación de time shift.

Detalles de la función

Algunas notas generales sobre los parámetros de la función:

• Los parámetros de la función están separados por una coma
• Los parámetros opcionales de la función (o partes del parámetro) se indican mediante < >
• Los parámetros específicos de la función se describen con cada función
• Los parámetros /host/key y (sec|#num)<:desplazamiento de tiempo> nunca deben ir entre comillas

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

El valor futuro, máximo, mínimo, delta o promedio del item.
Tipos de valores compatibles: Float, Integer.

Parámetros:

• Consulte los parámetros comunes;
  
• time - el horizonte de predicción en segundos (por ejemplo, 1, 60) (se pueden utilizar sufijos de tiempo (por ejemplo, 30s, 1m)); se admiten valores negativos;
  
• fit (opcional; debe estar entre comillas dobles) - la función utilizada para ajustar los datos históricos. Ajustes compatibles:
  linear - función lineal (predeterminada)
  polynomialN - polinomio de grado N (1 <= N <= 6)
  exponential - función exponencial
  logarithmic - función logarítmica
  power - función potencial
  Tenga en cuenta que polynomial1 equivale a linear;
• mode (opcional; debe estar entre comillas dobles) - el resultado solicitado. Modos compatibles:
  value - valor (predeterminado)
  max - máximo
  min - mínimo
  delta - max-min
  avg - promedio
  Tenga en cuenta que value estima el valor del item en el momento now + time; max, min, delta y avg calculan la estimación del valor del item en el intervalo entre now y now + time.

Comentarios:

• Si el valor que se debe devolver es mayor que 1.7976931348623158E+308 o menor que -1.7976931348623158E+308, el valor devuelto se limita a 1.7976931348623158E+308 o -1.7976931348623158E+308, respectivamente;
• Solo deja de ser compatible si se utiliza incorrectamente en la expresión (tipo de item incorrecto, parámetros no válidos); de lo contrario, devuelve -1 en caso de errores;
• Consulte también información adicional sobre las funciones de trigger predictivas.

Ejemplos:

forecast(/host/key,#10,1h) #predice el valor del item dentro de una hora basándose en los últimos 10 valores
forecast(/host/key,1h,30m) #predice el valor del item dentro de 30 minutos basándose en los datos de la última hora
forecast(/host/key,1h:now-1d,12h) #predice el valor del item dentro de 12 horas basándose en los datos de una hora de hace un día
forecast(/host/key,1h,10m,"exponential") #predice el valor del item dentro de 10 minutos basándose en los datos de la última hora y en una función exponencial
forecast(/host/key,1h,2h,"polynomial3","max") #predice el valor máximo que puede alcanzar el item en las próximas dos horas basándose en los datos de la última hora y en un polinomio cúbico (de tercer grado)
forecast(/host/key,#2,-20m) #estima el valor del item de hace 20 minutos basándose en los dos últimos valores (esto puede ser más preciso que utilizar last(), especialmente si el item se actualiza con poca frecuencia, por ejemplo, una vez por hora)

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

El tiempo en segundos necesario para que un item alcance el umbral especificado.
Tipos de valores soportados: Float, Integer.

Parámetros:

• Ver parámetros comunes;
  
• threshold - el valor a alcanzar (se pueden usar sufijos de unidad);
• fit (opcional; debe ir entre comillas dobles) - ver forecast().

Comentarios:

• Si el valor a devolver es mayor que 1.7976931348623158E+308, el valor devuelto se recorta a 1.7976931348623158E+308;
• Devuelve 1.7976931348623158E+308 si no se puede alcanzar el umbral;
• Se vuelve no soportado solo si se usa incorrectamente en la expresión (tipo de item incorrecto, parámetros no válidos), de lo contrario devuelve -1 en caso de errores;
• Consulte también información adicional sobre funciones de trigger predictivas.

Ejemplos:

timeleft(/host/key,#10,0) #el tiempo hasta que el valor del item alcance cero basado en los últimos 10 valores
timeleft(/host/key,1h,100) #el tiempo hasta que el valor del item alcance 100 basado en los datos de la última hora
timeleft(/host/key,1h:now-1d,100) #el tiempo hasta que el valor del item alcance 100 basado en una hora hace un día
timeleft(/host/key,1h,200,"polynomial2") #el tiempo hasta que el valor del item alcance 200 basado en los datos de la última hora y suponiendo que el item se comporta como un polinomio cuadrático (de segundo grado)

Vea todas las funciones compatibles.