1 Funciones de agregación
Salvo que se indique lo contrario, todas las funciones listadas aquí son compatibles con:
Las funciones de agregación pueden trabajar con:
- el historial de elementos, por ejemplo,
min(/host/key,1h) - funciones foreach como único parámetro, por ejemplo,
min(last_foreach(/*/key))(solo en elementos calculados; no se puede usar en disparadores)
Las funciones se listan sin información adicional. Haga clic en la función para ver los detalles completos.
| Función | Descripción |
|---|---|
| avg | El valor promedio de un elemento dentro del período de evaluación definido. |
| bucket_percentile | Calcula el percentil a partir de los buckets de un histograma. |
| count | El número de valores en un array devuelto por una función foreach. |
| histogram_quantile | Calcula el φ-cuantil a partir de los buckets de un histograma. |
| item_count | El número de elementos existentes en la configuración que coinciden con los criterios de filtro. |
| kurtosis | La "apuntamiento" 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 un elemento dentro del período de evaluación definido. |
| min | El valor más bajo de un elemento dentro del período de evaluación definido. |
| skewness | 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 poblacional en los valores recopilados dentro del período de evaluación definido. |
| stddevsamp | La desviación estándar muestral 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 los cuadrados en los valores recopilados dentro del período de evaluación definido. |
| varpop | La varianza poblacional de los valores recopilados dentro del período de evaluación definido. |
| varsamp | La varianza muestral de los valores recopilados dentro del período de evaluación definido. |
Parámetros comunes
/equipo/métricaes un primer parámetro obligatorio común para las funciones que hacen referencia al historial de métricas del equipo(seg|#num)<:desplazamiento de tiempo>es un segundo parámetro común para las funciones que hacen referencia al historial de métricas 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 recogidos (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 la función:
- Los parámetros de la función están separados por una coma
- Los parámetros opcionales de la función (o partes del parámetro) se indican con
<> - 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
avg(/equipo/clave,(seg|#num)<:desplazamiento de tiempo>)
El valor promedio de una métrica dentro del período de evaluación definido.
Tipos de valor soportados: Float, Integer.
Funciones foreach soportadas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
Parámetros: ver parámetros comunes.
El desplazamiento de tiempo es útil cuando se necesita comparar el valor promedio actual con el valor promedio de algún tiempo atrás.
Ejemplos:
avg(/equipo/clave,1h) #el valor promedio de la última hora hasta ahora
avg(/equipo/clave,1h:now-1d) #el valor promedio de una hora desde hace 25 horas hasta hace 24 horas desde ahora
avg(/equipo/clave,#5) #el valor promedio de los cinco valores más recientes
avg(/equipo/clave,#5:now-1d) #el valor promedio de los cinco valores más recientes excluyendo los valores recibidos en las últimas 24 horasbucket_percentile(filtro de métricas,periodo de tiempo,porcentaje)
Calcula el percentil a partir de los buckets de un histograma.
Parámetros:
- filtro de métricas - ver filtro de métricas;
- periodo de tiempo - ver periodo de tiempo;
- porcentaje - porcentaje (0-100).
Comentarios:
- Solo se admite en métricas calculadas;
- Esta función es un alias de
histogram_quantile(porcentaje/100, bucket_rate_foreach(filtro de métricas, periodo de tiempo, 1)).
count(func_foreach(filtro de métrica,<periodo de tiempo>),<operador>,<patrón>)
El número de valores en un array devuelto por una función foreach.
Funciones foreach soportadas: 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. Consulte funciones foreach para más detalles. Tenga en cuenta que count_foreach y bucket_rate_foreach admiten parámetros adicionales.
- filtro de métrica - consulte filtro de métrica;
- periodo de tiempo - consulte periodo de tiempo;
- operador (debe ir entre comillas dobles).
operadoressoportados:
eq - igual
ne - no igual
gt - mayor
ge - mayor o igual
lt - menor
le - menor o igual
like - coincide si contiene el patrón (sensible a mayúsculas/minúsculas)
bitand - AND a nivel de bits
regexp - coincidencia sensible a mayúsculas/minúsculas de la expresión regular dada enpatrón
iregexp - coincidencia insensible a mayúsculas/minúsculas de la expresión regular dada enpatrón - patrón - el patrón requerido (los argumentos de cadena deben ir entre comillas dobles); soportado si operador se especifica en el tercer parámetro.
Comentarios:
- Usar count() con una función foreach relacionada con el histórico (max_foreach, avg_foreach, etc.) puede tener implicaciones en el rendimiento, mientras que usar exists_foreach(), que solo trabaja con datos de configuración, no tendrá tal efecto.
- Los parámetros opcionales operador o patrón no pueden dejarse vacíos después de una coma, solo pueden omitirse completamente.
- Con bitand como tercer parámetro, el cuarto parámetro
patrónpuede especificarse como dos números, separados por '/': número_a_comparar/mascara. count() calcula el "AND a nivel de bits" entre el valor y la mascara y compara el resultado con número_a_comparar. Si el resultado del "AND a nivel de bits" es igual a número_a_comparar, el valor se cuenta.
Si número_a_comparar y mascara son iguales, solo es necesario especificar la mascara (sin '/'). - Con regexp o iregexp como tercer parámetro, el cuarto parámetro
patrónpuede ser una expresión regular ordinaria o global (comenzando con '@'). En el caso de expresiones regulares globales, la sensibilidad a mayúsculas/minúsculas se hereda de la configuración de la expresión regular global. Para el propósito de la coincidencia regexp, los valores flotantes siempre se representarán con 4 dígitos decimales después del '.'. Tenga en cuenta también que para números grandes, la diferencia en la representación decimal (almacenada en la base de datos) y binaria (utilizada por el servidor Zabbix) puede afectar al cuarto dígito decimal.
Ejemplos:
count(max_foreach(/*/net.if.in[*],1h)) #el número de métricas net.if.in que recibieron datos en la última hora hasta ahora
count(last_foreach(/*/vfs.fs.dependent.size[*,pused]),"gt",95) #el número de sistemas de archivos con más del 95% de espacio en disco usadohistogram_quantile(quantile,bucket1,value1,bucket2,value2,...)
Calcula el φ-cuantil a partir de los buckets de un histograma.
Función foreach soportada: bucket_rate_foreach.
Parámetros:
- quantile - 0 ≤ φ ≤ 1;
- bucketN, valueN - pares de parámetros introducidos manualmente (>=2) o la respuesta de bucket_rate_foreach.
Comentarios:
- Solo se admite en métricas calculadas;
- Corresponde funcionalmente a 'histogram_quantile' de PromQL;
- Devuelve -1 si los valores del último bucket 'Infinity' ("+inf") son iguales a 0.
Ejemplos:
histogram_quantile(0.75,1.0,last(/equipo/rate_bucket[1.0]),"+Inf",last(/equipo/rate_bucket[Inf]))
histogram_quantile(0.5,bucket_rate_foreach(//clave_métrica,30s))item_count(filtro de métricas)
El número de métricas existentes en la configuración que coinciden con los criterios del filtro.
Tipo de valor soportado: Integer.
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 más detalles.
Comentarios:
- Solo se admite en métricas calculadas;
- Funciona como un alias para la función count(exists_foreach(item_filter)).
Ejemplos:
item_count(/*/agent.ping?[group="Host group 1"]) #el número de equipos con la métrica *agent.ping* en el "Host group 1"kurtosis(/equipo/clave,(seg|#num)<:desplazamiento de tiempo>)
La "apuntamiento" de la distribución de probabilidad en los valores recopilados dentro del período de evaluación definido. Véase también: Curtosis.
Tipos de valores soportados: Float, Integer.
Función foreach soportada: last_foreach.
Parámetros: ver parámetros comunes.
Ejemplo:
mad(/equipo/métrica,(sec|#num)<:desplazamiento de tiempo>)
La desviación absoluta de la mediana en los valores recogidos dentro del periodo de evaluación definido. Véase también: Desviación absoluta de la mediana.
Tipos de valor soportados: Float, Integer.
Función foreach soportada: last_foreach.
Parámetros: ver parámetros comunes.
Ejemplo:
max(/equipo/clave,(seg|#num)<:desplazamiento de tiempo>)
El valor más alto de una métrica dentro del período de evaluación definido.
Tipos de valor soportados: Float, Integer.
Funciones foreach soportadas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
Parámetros: ver parámetros comunes.
Ejemplo:
max(/equipo/clave,1h) - min(/equipo/clave,1h) #calcula la diferencia entre los valores máximo y mínimo dentro de la última hora hasta ahora (el delta de valores)min(/equipo/clave,(seg|#num)<:desplazamiento de tiempo>)
El valor más bajo de una métrica dentro del período de evaluación definido.
Tipos de valores soportados: Float, Integer.
Funciones foreach soportadas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
Parámetros: ver parámetros comunes.
Ejemplo:
max(/equipo/clave,1h) - min(/equipo/clave,1h) #calcula la diferencia entre los valores máximo y mínimo dentro de la última hora hasta ahora (el delta de valores)skewness(/equipo/clave,(seg|#num)<:desplazamiento de tiempo>)
La asimetría de la distribución de probabilidad en los valores recopilados dentro del período de evaluación definido. Véase también: Asimetría.
Tipos de valores soportados: Float, Integer.
Función foreach soportada: last_foreach.
Parámetros: ver parámetros comunes.
Ejemplo:
stddevpop(/equipo/métrica,(seg|#num)<:desplazamiento de tiempo>)
La desviación estándar de la población en los valores recogidos dentro del periodo de evaluación definido. Véase también: Desviación estándar.
Tipos de valores soportados: Float, Integer.
Función foreach soportada: last_foreach.
Parámetros: ver parámetros comunes.
Ejemplo:
stddevpop(/equipo/métrica,1h) #la desviación estándar de la población para la última hora hasta ahorastddevsamp(/equipo/clave,(seg|#num)<:desplazamiento de tiempo>)
La desviación estándar muestral en los valores recopilados dentro del período de evaluación definido. Véase también: Desviación estándar.
Tipos de valores soportados: Float, Integer.
Función foreach soportada: last_foreach.
Parámetros: ver parámetros comunes.
Se requieren al menos dos valores de datos para que esta función funcione.
Ejemplo:
sum(/equipo/clave,(seg|#num)<:desplazamiento de tiempo>)
La suma de los valores recogidos dentro del periodo de evaluación definido.
Tipos de valor soportados: Float, Integer.
Funciones foreach soportadas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
Parámetros: ver parámetros comunes.
Ejemplo:
sumofsquares(/equipo/métrica,(sec|#num)<:desplazamiento de tiempo>)
La suma de los cuadrados en los valores recopilados dentro del período de evaluación definido.
Tipos de valores soportados: Float, Integer.
Función foreach soportada: last_foreach.
Parámetros: ver parámetros comunes.
Ejemplo:
varpop(/equipo/métrica,(sec|#num)<:desplazamiento de tiempo>)
La varianza poblacional de los valores recogidos dentro del periodo de evaluación definido. Véase también: Varianza.
Tipos de valores soportados: Float, Integer.
Función foreach soportada: last_foreach.
Parámetros: ver parámetros comunes.
Ejemplo:
varsamp(/equipo/clave,(seg|#num)<:desplazamiento de tiempo>)
La varianza muestral de los valores recopilados dentro del período de evaluación definido. Véase también: Varianza.
Tipos de valores soportados: Float, Integer.
Función foreach soportada: last_foreach.
Parámetros: ver parámetros comunes.
Se requieren al menos dos valores de datos para que esta función funcione.
Ejemplo:
Consulte todas las funciones compatibles.