8 Funciones predictivas

Todas las funciones listadas aquí son compatibles en:

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

Función	Descripción
forecast	El valor futuro, máximo, mínimo, delta o promedio del item.
timeleft	El tiempo en segundos necesario para que un item alcance el umbral especificado.

Parámetros comunes

/host/key es un primer parámetro obligatorio común para las funciones que hacen referencia al historial de items del host
(sec|#num)<:desplazamiento de tiempo> es un segundo parámetro común para las funciones que hacen referencia al historial de items del host, donde:
- sec - periodo de evaluación máximo en segundos (se pueden usar sufijos de tiempo), o
- #num - rango de evaluación máximo en los últimos valores recogidos (si va precedido de una almohadilla)
- desplazamiento de tiempo (opcional) permite mover el punto de evaluación hacia atrás en el tiempo. Consulte más detalles sobre cómo especificar el desplazamiento de tiempo.

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 soportados: Float, Integer.

Parámetros:

Ver parámetros comunes;
time - el horizonte de predicción en segundos (se pueden usar sufijos de tiempo); se admiten valores negativos;
fit (opcional; debe ir entre comillas dobles) - la función utilizada para ajustar los datos históricos. Ajustes soportados:
linear - función lineal (por defecto)
polynomialN - polinomial de grado N (1 <= N <= 6)
exponential - función exponencial
logarithmic - función logarítmica
power - función de potencia
Tenga en cuenta que polynomial1 es equivalente a linear;
mode (opcional; debe ir entre comillas dobles) - el resultado solicitado. Modos soportados:
value - valor (por defecto)
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 investigan la estimación del valor del item en el intervalo entre now y now + time.

Comentarios:

Si el valor a devolver es mayor que 1.7976931348623158E+308 o menor que -1.7976931348623158E+308, el valor devuelto se recorta a 1.7976931348623158E+308 o -1.7976931348623158E+308 respectivamente;
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:

forecast(/host/key,#10,1h) #predecir el valor del item en una hora basado en los últimos 10 valores
       forecast(/host/key,1h,30m) #predecir el valor del item en 30 minutos basado en los datos de la última hora
       forecast(/host/key,1h:now-1d,12h) #predecir el valor del item en 12 horas basado en una hora de datos de hace un día
       forecast(/host/key,1h,10m,"exponential") #predecir el valor del item en 10 minutos basado en los datos de la última hora y la función exponencial
       forecast(/host/key,1h,2h,"polynomial3","max") #predecir el valor máximo que el item puede alcanzar en las próximas dos horas basado en los datos de la última hora y un polinomio cúbico (de tercer grado)
       forecast(/host/key,#2,-20m) #estimar el valor del item hace 20 minutos basado en los dos últimos valores (esto puede ser más preciso que usar last(), especialmente si el item se actualiza raramente, 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.