Documentation
Table of Contents
4 Funciones de predicción
Todas las funciones enumeradas aquí son compatibles con:
Algunas notas generales sobre los parámetros de función:
- Los parámetros de la 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
/host/keyy(sec|#num)<:time shift>nunca deben ser entrecomillados
Parámetros comunes
/host/keyes un primer parámetro obligatorio común para las funciones haciendo referencia al historial de la métrica del equipo(sec|#num)<:time shift>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 máximo de evaluación en segundos (se pueden utilizar sufijos) de tiempo , o
- #num - máximo rango de evaluación en la última versión de valores recopilados (si están precedidos por una almohadilla)
- time shift (opcional) permite mover el punto de evaluación atrás en el tiempo. Ver más detalles sobre como especificar el desplazamiento de hora.
Funciones de predicción
| FUNCIÓN | ||
|---|---|---|
| Descripción | Parámetros específicos de la función | Comentarios |
| forecast (/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>) | ||
| Valor futuro, máximo, mínimo, delta o promedio de la métrica. | Ver parámetros comunes. tiempo: horizonte de pronóstico en segundos (se pueden usar sufijos de tiempo) ); se admiten valores negativos ajuste (opcional; debe estar entre comillas dobles): función utilizada para ajustar datos históricos ajustes admitidos:lineal - lineal función polinomioN - polinomio de grado N (1 <= N <= 6) exponencial - función exponencial logarítmica - función logarítmica potencia - función de potencia Tenga en cuenta que: lineal es el valor predeterminado, polinomio1 es equivalente a lineal modo (opcional; debe estar entre comillas dobles): salida demandada<br > Modos admitidos:valor - valor (predeterminado) max - máximo min - mínimo delta - max-min avg - promedio Tenga en cuenta que: value estima el valor de la métrica en este momento ahora + timemax, min, delta y avg investiga la estimación del valor de la métrica en el intervalo entre now y now + time |
Tipos de valores admitidos: float, int Si el valor a devolver es mayor que 1.7976931348623157E+308 o menos que -1.7976931348623157E+308, el valor de retorno se recorta a 1.7976931348623157E+308 o -1.7976931348623157E+308 correspondientemente. Deja de ser compatible solo si se usa incorrectamente en la expresión (tipo de métrica incorrecta, parámetros no válidos); de lo contrario, devuelve -1 en caso de errores. Ejemplos: => forecast(/host/key,#10,1h) → pronóstico del valor de la métrica en una hora basado en los últimos 10 valores => forecast(/host/key,1h,30m) → pronóstico del valor de la métrica en 30 minutos basado en los datos de la última hora => forecast(/host/key,1h:now-1d,12h) → pronóstico del valor de la métrica en 12 horas basado en una hora hace un día => ** forecast(/host/key,1h,10m,"exponential") → pronóstico del valor de la métrica en 10 minutos según los datos de la última hora y la función exponencial => forecast* *(/host/key,1h,2h,"polynomial3","max") → pronostico del valor máximo que la métrica puede alcanzar en las próximas dos horas según los datos de la última hora y el valor cúbico (tercer grado) polinomio => forecast(/host/key,#2,-20m) → estima el valor de la métrica hace 20 minutos según los dos últimos valores (este puede ser más preciso que usar last(), especialmente si la métrica se actualiza rara vez, digamos, una vez por hora) Consulte también información adicional sobre funciones de activación predictivas. |
| timeleft (/host/key,(sec|#num)<:time shift>,threshold,<fit>) | ||
| Tiempo en segundos necesarios para que una métrica alcance un umbral específico. | Consulte parámetros comunes. umbral - valor a alcanzar (sufijos de unidad se puede usar) fit (opcional; debe estar entre comillas dobles) - ver pronóstico() |
Tipos de valores admitidos: flotante, int Si es valor a devolver es mayor que 1.7976931348623157E+308, el valor devuelto se recorta a 1.7976931348623157E+308. Devuelve 1.7976931348623157E+308 si no se puede alcanzar el umbral. Deja de ser compatible solo si se usa incorrectamente en el expresión (tipo de métrica incorrecto, parámetros no válidos); de lo contrario, devuelve -1 en caso de errores. Ejemplos: => timeleft(/host/key,#10 ,0) → tiempo hasta que el valor de la métrica llegue a cero según los últimos 10 valores => timeleft(/host/key,1h,100) → tiempo hasta que el valor de la métrica llegue a 100 según los datos de la última hora => timeleft(/host/key,1h:now-1d,100) → tiempo hasta que la métrica el valor llega a 100 basado en hace una hora un día => timeleft(/host/key,1h,200,"polynomial2") → tiempo hasta que el valor de la métrica llegue a 200 basado en los datos de la última hora y en la suposición de que la métrica se comporta como un polinomio cuadrático (segundo grado) Consulte también información adicional sobre funciones de activación predictivas. |