8 Funciones de predicción

Todas las funciones enumeradas aquí son compatibles con:

• Expresiones de iniciador
• Métricas calculadas

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 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.

Detalles de la función

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/key y (sec|#num)<:time shift> nunca deben ser entrecomillados

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

El valor futuro, máximo, mínimo, delta o promedio de la métrica.
Tipos de valores admitidos: Flotante, Entero.

Parámetros:

• Ver parámetros comunes;
  
• hora: el horizonte de pronóstico en segundos (se pueden usar sufijos de tiempo); se admiten valores negativos;
  
• fit (opcional; debe estar entre comillas dobles): la función utilizada para ajustar los datos históricos. Ajustes admitidos:
  lineal - función lineal (predeterminada)
  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 polinomio1 es equivalente a lineal;
• modo (opcional; debe estar entre comillas dobles): la salida solicitada. Modos admitidos:
  valor - valor (predeterminado)
  max - máximo
  min - mínimo
  delta - max-min
  avg - promedio
  Tenga en cuenta que valor estima el valor del artículo en el momento ahora + tiempo; max, min, delta y avg investigan la estimación del valor del artículo en el intervalo entre "ahora" y "ahora" + "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;
• Deja de ser compatible solo 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 iniciador predictivas.

Ejemplos:

forecast(/host/key,#10,1h) #pronostica el valor de la métrica en una hora según los últimos 10 valores
       forecast(/host/key,1h,30m) #pronostica el valor de la métrica en 30 minutos según los datos de la última hora
       forecast(/host/key,1h:now-1d,12h) #pronostica el valor del artículo en 12 horas basándose en una hora hace un día
       forecast(/host/key,1h,10m,"exponential") #pronostica el 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") #pronostica el 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 polinomio cúbico (tercer grado)
       forecast(/host/key,#2,-20m) #estima el valor de la métrica hace 20 minutos basándose en los dos últimos valores (esto puede ser más preciso que usar last(), especialmente si la métrica se actualiza rara vez, digamos, una vez una hora)

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

El tiempo en segundos necesario para que una métrica alcance el umbral especificado.
Tipos de valores admitidos: Flotante, Entero.

Parámetros:

• Ver parámetros comunes;
  
• umbral: el valor a alcanzar (se pueden utilizar sufijos de unidad);
• fit (opcional; debe estar entre comillas dobles) - consulte 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;
• Deja de ser compatible solo 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 iniciador predictivas.

Ejemplos:

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

Consulte todas las funciones admitidas.