Documentation
1 Funciones de agregación
Excepto que se indique lo contrario, todas las funciones enumeradas aquí son compatibles en:
Las funciones de agregación 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)
Las funciones se enumeran sin información adicional. Haga clic en la función para ver los detalles completos.
| Función | Descripción |
|---|---|
| avg | El valor promedio de una métrica dentro del período de evaluación definido. |
| bucket_percentile | Calcula el percentil a partir de los cubos de un histograma. |
| count | El recuento de valores en una matriz devuelta por una función foreach. |
| histogram_quantile | Calcula el φ-cuantil a partir de los cubos de un histograma. |
| item_count | El recuento de métricas existentes en la configuración que coinciden con los criterios del filtro. |
| kurtosis | La "cola" de la distribución de probabilidad en los valores recopilados dentro del período de evaluación definido. |
| mad | La desviación absoluta mediana en los valores recopilados dentro del período de evaluación definido. |
| max | El valor más alto de una métrica dentro del período de evaluación definido. |
| min | El valor más bajo de una métrica dentro del período de evaluación definido. |
| asimetría | La asimetría de la distribución de probabilidad en los valores recopilados dentro del período de evaluación definido. |
| stddevpop | La desviación estándar de la población en los valores recopilados dentro del período de evaluación definido. |
| stddevsamp | La desviación estándar de la muestra en los valores recopilados dentro del período de evaluación definido. |
| sum | La suma de los valores recopilados dentro del período de evaluación definido. |
| sumofsquares | La suma de cuadrados en los valores recopilados dentro del período de evaluación definido. |
| varpop | La varianza de la población de los valores recopilados dentro del período de evaluación definido. |
| varsamp | La varianza de la muestra de los valores recopilados dentro del período de evaluación definido. |
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.
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 la 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 encerrados entre comillas
avg(/host/key,(sec|#num)<:time shift>)
El valor promedio de una métrica dentro del período de evaluación definido.
Tipos de valores admitidos: Flotante, Entero.
[Funciones foreach] admitidas (/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
Parámetros: consulte parámetros comunes.
El desplazamiento del tiempo es útil cuando es necesario comparar el valor promedio actual con el valor promedio de hace algún tiempo.
Ejemplos:
avg(/host/key,1h) #el valor promedio de la última hora hasta ahora
avg(/host/key,1h:now-1d) #el valor promedio de una hora desde hace 25 horas hasta hace 24 horas a partir de ahora
avg(/host/key,#5) #el valor promedio de los cinco últimos valores
avg(/host/key,#5:now-1d) #el valor promedio de los cinco últimos valores excluyendo los valores recibidos en las últimas 24 horasbucket_percentile(item filter,time period,percentage)
Calcula el percentil a partir de los cubos de un histograma.
Parámetros:
- filtro de métricas - consulte filtro de métricas;
- período de tiempo - consulte período de tiempo;
- porcentaje - porcentaje (0-100).
Comentarios:
- Compatible únicamente con métricas calculadas;
- Esta función es un alias para
histogram_quantile(percentage/100, bucket_rate_foreach(filtro de métricas, período de tiempo, 1)).
count(func_foreach(item filter,<time period>))
El recuento de valores en una matriz devuelta por una función foreach.
Tipo de valor admitido: Entero.
[Funciones foreach] admitidas (/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
Parámetros:
- 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.
- filtro de métricas - consulte filtro de métricas;
- período de tiempo - consulte período de tiempo.
El uso de 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á tales consecuencias.
Ejemplos:
count(max_foreach(/*/net.if.in[*],1h)) #el número de elementos net.if.in que recibieron datos en la última hora hasta ahorahistogram_quantile(quantile,bucket1,value1,bucket2,value2,...)
Calcula el cuantil φ a partir de los cubos de un histograma.
[Función foreach] admitida (/manual/appendix/functions/aggregate/foreach): bucket_rate_foreach.
Parámetros:
- cuantil - 0 ≤ φ ≤ 1;
- bucketN, valueN - pares ingresados manualmente (>=2) de parámetros o la respuesta de bucket_rate_foreach.
Comentarios:
- Compatible únicamente con métricas calculadas;
- Funcionalmente corresponde a 'histogram_quantile' de PromQL;
- Devuelve -1 si los valores del último depósito 'Infinito' ("+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(//item_key,30s))item_count(item filter)
El recuento de métricas existentes en la configuración que coinciden con los criterios del filtro.
Tipo de valor admitido: Entero.
Parámetro:
- 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.
Comentarios:
- Compatible únicamente con métricas calculadas;
- Funciona como alias para la función count(exists_foreach(item_filter)).
Ejemplos:
item_count(/*/agent.ping?[group="Grupo de hosts 1"]) #el número de equipos con la métricas *agent.ping* en el "grupo de equipos 1"kurtosis(/host/key,(sec|#num)<:time shift>)
La "cola" de la distribución de probabilidad en los valores recopilados dentro del período de evaluación definido. Ver también: Kurtosis.
Tipos de valores admitidos: Flotante, Entero.
[Función foreach] admitida (/manual/appendix/functions/aggregate/foreach): last_foreach.
Parámetros: consulte parámetros comunes.
Ejemplo:
mad(/host/key,(sec|#num)<:time shift>)
La desviación absoluta mediana en los valores recopilados dentro del período de evaluación definido. Ver también: Desviación absoluta de la mediana.
Tipos de valores admitidos: Flotante, Entero.
[Función foreach] admitida (/manual/appendix/functions/aggregate/foreach): last_foreach.
Parámetros: consulte parámetros comunes.
Ejemplo:
max(/host/key,(sec|#num)<:time shift>)
El valor más alto de una métrica dentro del período de evaluación definido.
Tipos de valores admitidos: Flotante, Entero.
[Funciones foreach] admitidas (/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
Parámetros: consulte parámetros comunes.
Ejemplo:
max(/host/key,1h) - min(/host/key,1h) #calcula la diferencia entre los valores máximo y mínimo desde la última hora hasta ahora (el delta de valores)min(/host/key,(sec|#num)<:time shift>)
El valor más bajo de una métrica dentro del período de evaluación definido.
Tipos de valores admitidos: Flotante, Entero.
[Funciones foreach] admitidas (/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
Parámetros: consulte parámetros comunes.
Ejemplo:
max(/host/key,1h) - min(/host/key,1h) #calcula la diferencia entre los valores máximo y mínimo desde la última hora hasta ahora (el delta de valores)skewness(/host/key,(sec|#num)<:time shift>)
La asimetría de la distribución de probabilidad en los valores recolectados dentro del período de evaluación definido. Ver también: Asimetría.
Tipos de valores admitidos: Flotante, Entero.
[Función foreach] admitida (/manual/appendix/functions/aggregate/foreach): last_foreach.
Parámetros: consulte parámetros comunes.
Ejemplo:
stddevpop(/host/key,(sec|#num)<:time shift>)
La desviación estándar de la población en los valores recopilados dentro del período de evaluación definido. Ver también: Desviación estándar.
Tipos de valores admitidos: Flotante, Entero.
[Función foreach] admitida (/manual/appendix/functions/aggregate/foreach): last_foreach.
Parámetros: consulte parámetros comunes.
Ejemplo:
stddevsamp(/host/key,(sec|#num)<:time shift>)
La desviación estándar de la muestra en los valores recopilados dentro del período de evaluación definido. Ver también: Desviación estándar.
Tipos de valores admitidos: Flotante, Entero.
[Función foreach] admitida (/manual/appendix/functions/aggregate/foreach): last_foreach.
Parámetros: consulte parámetros comunes.
Se requieren al menos dos valores de datos para que esta función funcione.
Ejemplo:
sum(/host/key,(sec|#num)<:time shift>)
La suma de los valores recopilados dentro del período de evaluación definido.
Tipos de valores admitidos: Flotante, Entero.
[Funciones foreach] admitidas (/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
Parámetros: consulte parámetros comunes.
Ejemplo:
sumofsquares(/host/key,(sec|#num)<:time shift>)
La suma de cuadrados de los valores recopilados dentro del período de evaluación definido.
Tipos de valores admitidos: Flotante, Entero.
[Función foreach] admitida (/manual/appendix/functions/aggregate/foreach): last_foreach.
Parámetros: consulte parámetros comunes.
Ejemplo:
varpop(/host/key,(sec|#num)<:time shift>)
La varianza de la población de los valores recopilados dentro del período de evaluación definido. Ver también: Varianza.
Tipos de valores admitidos: Flotante, Entero.
[Función foreach] admitida (/manual/appendix/functions/aggregate/foreach): last_foreach.
Parámetros: consulte parámetros comunes.
Ejemplo:
varsamp(/host/key,(sec|#num)<:time shift>)
La varianza de la muestra de los valores recopilados dentro del período de evaluación definido. Ver también: Varianza.
Tipos de valores admitidos: Flotante, Entero.
[Función foreach] admitida (/manual/appendix/functions/aggregate/foreach): last_foreach.
Parámetros: consulte parámetros comunes.
Se requieren al menos dos valores de datos para que esta función funcione.
Ejemplo:
Consulte todas las funciones admitidas.