Documentation
Table of Contents
1 Funciones agregadas
Excepto que se indique lo contrario, todas las funciones enumeradas aquí son compatibles en:
Las funciones agregadas pueden funcionar con:
- historial de métricas, por ejemplo,
min(/host/key,1h) - funciones foreach como el único parámetro, por ejemplo,
min(last_foreach(/*/key))(solo en métricas calculadas; no se puede usar en iniciadores)
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 agregadas
| FUNCIÓN | ||
|---|---|---|
| Descripción | Parámetros específicos de la función | Comentarios |
| avg (/host/key,(sec|#num)<:timeshift>) | ||
| Valor promedio de una métrica dentro del período de evaluación definido. | Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach admitidas: avg_foreach, count_foreach, exist_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Ejemplos: => avg(/host/key,1h) → valor promedio de la última hora hasta ahora => avg(/host/key,1h:now-1d) → valor promedio durante una hora desde hace 25 horas hasta hace 24 horas desde ahora => avg(/host/key,#5) → valor promedio de los cinco últimos valores => avg(/host/key,#5:now-1d) → valor promedio de los cinco últimos valores excluyendo los valores recibidos en el último 24 horas El cambio de hora es útil cuando es necesario comparar el valor promedio actual con el valor promedio de hace algún tiempo. |
| bucket_percentile (filtro de métricas, período de tiempo, porcentaje) | ||
| Calcula el percentil a partir de los grupos de un histograma. | filtro de métricas - consulte filtro de métricas período de tiempo - consulte período de tiempo percentage - porcentaje (0-100) |
Solo se admite en métricas calculadas. Esta función es un alias para histogram_quantile(porcentaje/100, bucket_rate_foreach(filtro de métricas, período de tiempo, 1)) |
| count (func_foreach(filtro de métricas,<período de tiempo>)) | ||
| Recuento de valores en una matriz devuelta por una función foreach. | func_foreach - función foreach para la cual se debe contar el número de valores devueltos (con argumentos admitidos). Consulte funciones foreach para obtener más detalles. | Tipo de valor admitido: int funciones foreach admitidas: avg_foreach, count_foreach, exist_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Ejemplo: => count(max_foreach(/*/net.if.in[* ],1h)) → número de métricas net.if.in que recibieron datos en la última hora hasta ahora Tenga en cuenta que usar count()* * con una función foreach relacionada con el historial (max_foreach, avg_foreach, etc.) puede tener implicaciones en el rendimiento, mientras que el uso de exists_foreach()**, que funciona solo con datos de configuración, no tendrá tal efecto . |
| histogram_quantile (cuantil,depósito1,valor1,depósito2,valor2,...) | ||
| Calcula el φ-cuantil a partir de los grupos de un histograma. | cuantil - 0 ≤ φ ≤ 1 bucketN, valueN - pares ingresados manualmente (>=2) de parámetros o respuesta de bucket_rate_foreach |
Compatible solo con métricas calculadas. [funciones foreach] admitidas(/manual/appendix/functions/aggregate/foreach): bucket_rate_foreach Funcionalmente corresponde a 'histogram_quantile' de PromQL. Devuelve -1 si los valores del último depósito 'Infinity' ("+inf") son iguales a 0. Ejemplos: => histogram_quantile(0.75,1.0,last(/ host/rate_bucket[1.0]),"+Inf",last(/host/rate_bucket[Inf]) => histogram_quantile(0.5,bucket_rate _foreach(//elemento_key,30s)) |
| item_count (filtro de métricas) | ||
| Recuento de métricas existentes en la configuración que coinciden con los criterios de filtro. | filtro de métricas: criterios para la selección de métricas, permite hacer referencia por grupo de equipos, equipo, clave de métrica y etiquetas. Se admiten comodines. Consulte filtro de métricas para obtener más detalles. | Solo se admite en métricas calculadas. Tipo de valor admitido: int Funciona como un alias para la función count(exists_foreach(item_filter)). Ejemplo: => item_count(/*/agent.ping?[group ="Grupo de equipos 1"]) → número de equipos con el elemento agent.ping en el "Grupo de equipos 1" |
| kurtosis (/host/key,(sec|#num)<:timeshift>) | ||
| "Tailidad" de la distribución de probabilidad en los valores recopilados dentro del período de evaluación definido. Ver también: Kurtosis |
Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach: last_foreach Ejemplo:<br >=> kurtosis(/host/key,1h) → curtosis durante la última hora hasta ahora |
| mad (/host/key,(sec|#num)<:timeshift>) | ||
| Desviación absoluta de la mediana en los valores recopilados dentro del período de evaluación definido. Ver también: Desviación absoluta de la mediana |
Ver parámetros-comunes. | Tipos de valores admitidos: |
| float, int funciones foreach admitidas: last_foreach Ejemplo: => mad(/host/ key,1h) → desviación absoluta media durante la última hora hasta ahora |
||
| max (/host/key,(sec|#num)<:timeshift>) | ||
| Valor más alto de una métrica dentro del período de evaluación definido. | Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach admitidas: avg_foreach, count_foreach, exist_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Ejemplo: => max(/host/key,1h) - min(/host/key,1h) → calcular la diferencia entre los valores máximo y mínimo dentro de la última hora hasta ahora (delta de valores ) |
| min (/host/key,(sec|#num)<:cambio de hora>) | ||
| Valor más bajo de una métrica dentro del período de evaluación definido. | Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach admitidas: avg_foreach, count_foreach, exist_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Ejemplo: => max(/host/key,1h) - min(/host/key,1h) → calcular la diferencia entre los valores máximo y mínimo dentro de la última hora hasta ahora (delta de valores ) |
| skewness (/host/key,(sec|#num)<:timeshift>) | ||
| Asimetría de la distribución de probabilidad en los valores recopilados dentro del período de evaluación definido. Ver también: Asimetría |
Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach: last_foreach Ejemplo: = > skewness(/host/key,1h) → asimetría durante la última hora hasta ahora |
| stddevpop (/host/key,(sec|#num)<:timeshift>) | ||
| Desviación estándar de la población en valores recopilados dentro del período de evaluación definido. Ver también: Desviación estándar |
Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach: last_foreach Ejemplo: => stddevpop(/host/key,1h) → desviación estándar de la población durante la última hora hasta ahora |
| stddevsamp (/host/key,(sec|#num)<:time shift>) | ||
| Desviación estándar de la muestra en valores recopilados dentro del período de evaluación definido. Ver también: Desviación estándar |
Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach: last_foreach Se requieren al menos dos valores de datos para que esta función funcione. Ejemplo: => stddevsamp(/host/key,1h) → desviación estándar de muestra para la última hora hasta ahora |
| sum (/host/clave,(sec|#num)<:cambio de hora>) | ||
| Suma de los valores recopilados dentro del período de evaluación definido. | Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach admitidas: avg_foreach, count_foreach, exist_foreach, last_foreach, max_foreach, min_foreach, sum_foreach Ejemplo: => sum(/host/key,1h) → suma de valores de la última hora hasta ahora |
| sumofsquares (/host/key,(sec|#num)<:timeshift>) | ||
| La suma de cuadrados en valores recopilados dentro del período de evaluación definido. | Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach admitidas: last_foreach Ejemplo: => sumofsquares(/host/key,1h) → suma de cuadrados de la última hora hasta ahora |
| varpop (/host/key,(sec|#num)<:timeshift>) | ||
| Varianza poblacional de los valores recopilados dentro del período de evaluación definido. Ver también: Varianza |
Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach: last_foreach Ejemplo: => ** varpop(/host/key,1h**) → variación de población durante la última hora hasta ahora |
| varsamp (/host/key,(sec|#num)<:time shift>) | ||
| Varianza de muestra de los valores recopilados dentro del período de evaluación definido. Ver también: Varianza |
Ver parámetros comunes. | Tipos de valores admitidos: float, int funciones foreach admitidas: last_foreach Se requieren al menos dos valores de datos para que esta función funcione. Ejemplo: => varsamp(/host/key,1h) → variación de muestra para la última hora hasta ahora |