1 Funciones de agregación

Excepto que se indique lo contrario, todas las funciones enumeradas aquí son compatibles en:

• Expresiones de iniciador
• Métricas calculadas

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.

Parámetros comunes

• /host/key es un primer parámetro obligatorio común para las funciones que hacen referencia al historial de items del host
• (sec|#num)<:desplazamiento de tiempo> es un segundo parámetro común para las funciones que hacen referencia al historial de items del host, donde:
  • sec - periodo 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 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/key y (sec|#num)<:time shift> nunca deben ser encerrados entre comillas

avg(/host/key,(sec|#num)<:time shift>)

El valor promedio de un item dentro del período de evaluación definido.
Tipos de valor compatibles: Float, Integer.
Funciones foreach compatibles: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parámetros: consulte los parámetros comunes.

El desplazamiento temporal es útil cuando es necesario comparar el valor promedio actual con el valor promedio de hace algún tiempo.

Ejemplos:

avg(/host/key,1h) #calcular el valor promedio de la última hora hasta ahora
avg(/host/key,#5) #calcular el valor promedio de los cinco últimos valores
avg(/host/key,1h:now-1d) #calcular el valor promedio durante una hora desde hace 25 horas hasta hace 24 horas a partir de ahora
avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"])) #calcular la carga promedio del procesador para todos los servidores MySQL
avg(/host/proc.num,5m)>300 #trigger si el número promedio de procesos en los últimos 5 minutos ha sido superior a 300

bucket_percentile(item filter,time period,percentage)

Calcula el percentil a partir de los buckets de un histograma.

Parámetros:

• item filter - consulte item filter;
  
• time period - consulte time period;
  
• percentage - porcentaje (0-100).

Comentarios:

• Solo es compatible en items calculados;
• Esta función es un alias de histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1)).

Ejemplos:

bucket_percentile(/*/http_request_duration_seconds_bucket[*],5m,95) #calcula el tiempo de respuesta del percentil 95 durante 5 minutos
bucket_percentile(/*/apiserver_request_duration_seconds_bucket[*],10m,99) #calcula la latencia de la API del percentil 99

count(func_foreach(item filter,<time period>),<operator>,<pattern>)

El recuento de valores en un array devuelto por una función foreach.
Funciones foreach compatibles: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parámetros:

• func_foreach - función foreach para la que se debe contar el número de valores devueltos. Consulte foreach functions para obtener más detalles. Tenga en cuenta que count_foreach y bucket_rate_foreach admiten parámetros adicionales.
• item filter - consulte item filter;
  
• time period - consulte time period;
  
• operator (debe ir entre comillas dobles). operators compatibles:
  eq - igual
  ne - no igual
  gt - mayor
  ge - mayor o igual
  lt - menor
  le - menor o igual
  like - coincide si contiene el patrón (distingue mayúsculas y minúsculas)
  bitand - AND bit a bit
  regexp - coincide con distinción de mayúsculas y minúsculas con la expresión regular dada en pattern
  iregexp - coincide sin distinción de mayúsculas y minúsculas con la expresión regular dada en pattern
  
• pattern - el patrón requerido (los argumentos de tipo string deben ir entre comillas dobles); compatible si operator se especifica en el tercer parámetro.

Comentarios:

• El uso de count() con una función foreach relacionada con el historial (max_foreach, avg_foreach, etc.) puede tener implicaciones de rendimiento, mientras que el uso de exists_foreach(), que solo funciona con datos de configuración, no tendrá ese efecto.
• Los parámetros opcionales operator o pattern no pueden dejarse vacíos después de una coma; solo pueden omitirse por completo.
• Con bitand como tercer parámetro, el cuarto parámetro pattern puede especificarse como dos números, separados por '/': number_to_compare_with/mask. count() calcula el "AND bit a bit" del valor y la mask y compara el resultado con number_to_compare_with. Si el resultado del "AND bit a bit" es igual a number_to_compare_with, el valor se cuenta.
  Si number_to_compare_with y mask son iguales, solo es necesario especificar la mask (sin '/').
• Con regexp o iregexp como tercer parámetro, el cuarto parámetro pattern puede ser una expresión regular normal o global (que comienza con '@'). En el caso de expresiones regulares globales, la distinción entre mayúsculas y minúsculas se hereda de la configuración de la expresión regular global. A efectos de la coincidencia regexp, los valores flotantes siempre se representarán con 4 dígitos decimales después de '.'. Tenga en cuenta también que, para números grandes, la diferencia entre la representación decimal (almacenada en la base de datos) y la binaria (utilizada por el server de Zabbix) puede afectar al cuarto dígito decimal.

Ejemplos:

count(max_foreach(/*/net.if.in[*],1h)) #calcular el número de items net.if.in que recibieron datos en la última hora hasta ahora
count(last_foreach(/*/vfs.fs.size[*,pused]),"gt",95) #calcular el número de sistemas de archivos con más del 95% del espacio en disco utilizado

histogram_quantile(quantile,bucket1,value1,bucket2,value2,...)

Calcula el φ-cuantil a partir de los buckets de un histograma.
Función foreach compatible: bucket_rate_foreach.

Parámetros:

• quantile - 0 ≤ φ ≤ 1;
  
• bucketN, valueN - pares introducidos manualmente (>=2) de parámetros o la respuesta de bucket_rate_foreach.

Comentarios:

• Solo compatible en items calculados;
• Funcionalmente corresponde 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(/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 número de items existentes en la configuración que coinciden con los criterios del filtro.
Tipo de valor compatible: Integer.

Parámetro:

• item filter - criterios para la selección de items, permite hacer referencia por grupo de hosts, host, clave del item y etiquetas. Se admiten comodines. Consulte item filter para obtener más detalles.
  

Comentarios:

• Compatible solo en items calculados;
• Funciona como un alias de la función count(exists_foreach(item_filter)).

Ejemplos:

item_count(/*/agent.ping?[group="Host group 1"]) #calcula el número de hosts con el item agent.ping en "Host group 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. Véase también: Kurtosis.
Tipos de valor admitidos: Float, Integer.
Función foreach admitida: last_foreach.

Parámetros: consulte parámetros comunes.

Ejemplos:

kurtosis(/host/system.cpu.util[,user],5m)>5 #trigger on sharp spikes of CPU utilization over 5 minutes

mad(/host/key,(sec|#num)<:time shift>)

La desviación absoluta mediana de los valores recopilados dentro del período de evaluación definido. Véase también: Desviación absoluta mediana.
Tipos de valor admitidos: Float, Integer.
Función foreach admitida: last_foreach.

Parámetros: consulte parámetros comunes.

Ejemplos:

last(/host/system.cpu.util[,user])>avg(/host/system.cpu.util[,user],1h)+3*mad(/host/system.cpu.util[,user],1h) #trigger if the last CPU utilization value is statistically significant

max(/host/key,(sec|#num)<:time shift>)

El valor más alto de un item dentro del período de evaluación definido.
Tipos de valor compatibles: Float, Integer.
Funciones foreach compatibles: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parámetros: consulte los parámetros comunes.

Ejemplos:

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 (el delta de los valores)
max(last_foreach(/*/vfs.fs.size[*,pused]?[group="Linux servers"])) #devuelve el uso de disco más alto entre todos los servidores Linux

min(/host/key,(sec|#num)<:time shift>)

El valor más bajo de un item dentro del período de evaluación definido.
Tipos de valor compatibles: Float, Integer.
Funciones foreach compatibles: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parámetros: consulte los parámetros comunes.

Ejemplos:

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 (el delta de los valores)
min(last_foreach(/*/vfs.file.contents["/sys/class/net/enp0s3/operstate"]?[group="Linux servers"])) #devuelve el estado operativo mínimo para cualquier interfaz en todos los Linux servers

skewness(/host/key,(sec|#num)<:time shift>)

La asimetría de la distribución de probabilidad en los valores recopilados dentro del período de evaluación definido. Consulte también: Skewness.
Tipos de valor compatibles: Float, Integer.
Función foreach compatible: last_foreach.

Parámetros: consulte parámetros comunes.

Ejemplos:

skewness(/host/vm.memory.size[used],5m)<-20 #trigger on sudden negative drops indicating crashes/restarts

stddevpop(/host/key,(sec|#num)<:time shift>)

La desviación estándar poblacional de los valores recopilados dentro del período de evaluación definido. Véase también: Desviación estándar.
Tipos de valor compatibles: Float, Integer.
Función foreach compatible: last_foreach.

Parámetros: consulte los parámetros comunes.

Ejemplos:

stddevpop(/host/system.cpu.util[,user],10m)>7 #trigger si el uso de CPU fluctúa mucho (la desviación estándar poblacional es superior a 7 durante 10 minutos)

stddevsamp(/host/key,(sec|#num)<:time shift>)

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 valor admitidos: Float, Integer.
Función foreach admitida: last_foreach.

Parámetros: consulte parámetros comunes.

Se requieren al menos dos valores de datos para que esta función funcione.

Ejemplos:

stddevsamp(/host/system.cpu.util[,user],10m)>7 #trigger if CPU usage fluctuates heavily (sample standard deviation is above 7 over 10 minutes)

sum(/host/key,(sec|#num)<:time shift>)

La suma de los valores recopilados dentro del período de evaluación definido.
Tipos de valor compatibles: Float, Integer.
Funciones foreach compatibles: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.

Parámetros: consulte los parámetros comunes.

Ejemplos:

sum(last_foreach(/*/net.if.in[*]?[group="Linux servers"])) #calcular el tráfico total de red entrante para todos los servidores Linux
sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) #calcular el espacio total en disco para todos los servidores MySQL
sum(last_foreach(/*/net.dns[*,*,*])) #calcular el número total de comprobaciones DNS exitosas

sumofsquares(/host/key,(sec|#num)<:time shift>)

La suma de los cuadrados de los valores recopilados dentro del período de evaluación definido.
Tipos de valor compatibles: Float, Integer.
Función foreach compatible: last_foreach.

Parámetros: consulte parámetros comunes.

Ejemplos:

sumofsquares(/host/calculated.net.if.rate,1m) #la suma de los cuadrados para la tasa de tráfico de red (entrante frente a saliente)
sumofsquares(last_foreach(/*/net.if.in[*]?[group="Linux servers"])) #la suma de los cuadrados de los últimos valores de tráfico de red entrante en todos los servidores Linux

varpop(/host/key,(sec|#num)<:time shift>)

La varianza poblacional de los valores recopilados dentro del período de evaluación definido. Consulte también: Varianza.
Tipos de valor admitidos: Float, Integer.
Función foreach admitida: last_foreach.

Parámetros: consulte parámetros comunes.

Ejemplos:

varpop(/host/system.cpu.util[,user],10m)>50 #trigger if CPU usage fluctuates heavily (variance is above 50 over 10 minutes)

varsamp(/host/key,(sec|#num)<:time shift>)

La varianza muestral de los valores recopilados dentro del período de evaluación definido. Consulte también: Variance.
Tipos de valor admitidos: Float, Integer.
Función foreach admitida: last_foreach.

Parámetros: consulte parámetros comunes.

Se requieren al menos dos valores de datos para que esta función funcione.

Ejemplos:

varsamp(/host/system.cpu.util[,user],10m)>50 #trigger si el uso de CPU fluctúa mucho (la varianza muestral es superior a 50 durante 10 minutos)

Consulte todas las funciones admitidas.