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 de la métrica. |
| timeleft | El tiempo en segundos necesario para que una métrica alcance el umbral especificado. |
Parámetros comunes
/equipo/métricaes un primer parámetro obligatorio común para las funciones que hacen referencia al historial de la métrica del equipo(seg|#num)<:desplazamiento de tiempo>es un segundo parámetro común para las funciones que hacen referencia al historial de la métrica del equipo, donde:- seg - período 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 recolectados (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 función:
- Los parámetros de función están separados por una coma
- Los parámetros de función opcionales (o partes de parámetros) se indican mediante
<> - Los parámetros específicos de la función se describen con cada función
- Los parámetros
/equipo/métricay(seg|#num)<:desplazamiento de tiempo>nunca deben ir entre comillas
forecast(/equipo/métrica,(sec|#num)<:desplazamiento de tiempo>,tiempo,<ajuste>,<modo>)
El valor futuro, máximo, mínimo, delta o promedio de la métrica.
Tipos de valores soportados: Float, Integer.
Parámetros:
- Ver parámetros comunes;
- tiempo - el horizonte de predicción en segundos (se pueden usar sufijos de tiempo); se admiten valores negativos;
- ajuste (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; - modo (opcional; debe ir entre comillas dobles) - la salida solicitada. 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 de la métrica en el momentoahora+tiempo; max, min, delta y avg investigan la estimación del valor de la métrica en el intervalo entreahorayahora+tiempo.
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;
- Solo se vuelve no soportado si se usa incorrectamente en la expresión (tipo de métrica incorrecto, parámetros inválidos), de lo contrario devuelve -1 en caso de errores;
- Consulte también información adicional sobre funciones de disparador predictivo.
Ejemplos:
forecast(/equipo/métrica,#10,1h) #predecir el valor de la métrica en una hora basado en los últimos 10 valores
forecast(/equipo/métrica,1h,30m) #predecir el valor de la métrica en 30 minutos basado en los datos de la última hora
forecast(/equipo/métrica,1h:now-1d,12h) #predecir el valor de la métrica en 12 horas basado en una hora de hace un día
forecast(/equipo/métrica,1h,10m,"exponential") #predecir el valor de la métrica en 10 minutos basado en los datos de la última hora y la función exponencial
forecast(/equipo/métrica,1h,2h,"polynomial3","max") #predecir el valor máximo que la métrica 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(/equipo/métrica,#2,-20m) #estimar el valor de la métrica hace 20 minutos basado en los dos últimos valores (esto puede ser más preciso que usar last(), especialmente si la métrica se actualiza raramente, por ejemplo, una vez por hora)timeleft(/equipo/métrica,(seg|#num)<:desplazamiento de tiempo>,umbral,<ajuste>)
El tiempo en segundos necesario para que una métrica alcance el umbral especificado.
Tipos de valor soportados: Float, Integer.
Parámetros:
- Ver parámetros comunes;
- umbral - el valor a alcanzar (se pueden usar sufijos de unidad);
- ajuste (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;
- Solo se vuelve no soportado si se usa incorrectamente en la expresión (tipo de métrica incorrecto, parámetros no válidos), de lo contrario devuelve -1 en caso de errores;
- Consulte también información adicional sobre funciones de disparador predictivo.
Ejemplos:
timeleft(/equipo/métrica,#10,0) #el tiempo hasta que el valor de la métrica alcance cero basado en los últimos 10 valores
timeleft(/equipo/métrica,1h,100) #el tiempo hasta que el valor de la métrica alcance 100 basado en los datos de la última hora
timeleft(/equipo/métrica,1h:now-1d,100) #el tiempo hasta que el valor de la métrica alcance 100 basado en una hora hace un día
timeleft(/equipo/métrica,1h,200,"polynomial2") #el tiempo hasta que el valor de la métrica alcance 200 basado en los datos de la última hora y suponiendo que la métrica se comporta como un polinomio cuadrático (de segundo grado)Consulte todas las funciones soportadas.