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.
| ¹ó³Ü²Ô³¦¾±¨®²Ô | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|
| avg | El valor promedio de una m¨¦trica dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| bucket_percentile | Calcula el percentil a partir de las agrupaciones de datos 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 las agrupaciones de datos 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| mad | La desviaci¨®n absoluta mediana en los valores recopilados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| max | El valor m¨¢s alto de una m¨¦trica dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| min | El valor m¨¢s bajo de una m¨¦trica dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| ²¹²õ¾±³¾±ð³Ù°ù¨ª²¹ | La ²¹²õ¾±³¾±ð³Ù°ù¨ª²¹ de la distribuci¨®n de probabilidad en los valores recopilados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| stddevpop | La desviaci¨®n est¨¢ndar de la poblaci¨®n en los valores recopilados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| stddevsamp | La desviaci¨®n est¨¢ndar de la muestra en los valores recopilados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| sum | La suma de los valores recopilados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| sumofsquares | La suma de cuadrados en los valores recopilados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| varpop | La varianza de la poblaci¨®n de los valores recopilados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. |
| varsamp | La varianza de la muestra de los valores recopilados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô en segundos (se pueden utilizar sufijos) de tiempo , o
- #num - m¨¢ximo rango de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô en la ¨²ltima versi¨®n de valores recopilados (si est¨¢n precedidos por una almohadilla)
- time shift (opcional) permite mover el punto de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido.
Tipos de valores admitidos: Flotante, Entero.
Funciones foreach admitidas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: 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 las agrupaciones de datos de un histograma.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ:
- 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(filtro de m¨¦trica,<per¨ªodo de tiempo>),<operador>,<±è²¹³Ù°ù¨®²Ô>)
El recuento de valores en una matriz devuelta por una funci¨®n foreach.
Funciones foreach admitidas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_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.
- filtro de m¨¦tricas - consulte filtro de elementos;
- per¨ªodo de tiempo - consulte per¨ªodo de tiempo;
- operador (debe estar entre comillas dobles).
Operadoresadmitidos:
eq - igual
ne - no igual
gt - mayor
ge - mayor o igual
lt - menos<br >le - menor o igual
like - coincide si contiene ±è²¹³Ù°ù¨®²Ô (distingue entre may¨²sculas y min¨²sculas)
bitand - AND bit a bit
regexp - coincide entre may¨²sculas y min¨²sculas de la expresi¨®n regular dada enpattern
iregexp - coincidencia que no distingue entre may¨²sculas y min¨²sculas de la expresi¨®n regular dada enpattern - ±è²¹³Ù°ù¨®²Ô: el ±è²¹³Ù°ù¨®²Ô requerido (los argumentos de cadena deben estar entre comillas dobles); compatible si se especifica operador 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 en el rendimiento, mientras que el uso de exists_foreach(), que funciona solo con datos de configuraci¨®n, no tendr¨¢ tal efecto.
- Los par¨¢metros opcionales operador o ±è²¹³Ù°ù¨®²Ô no se pueden dejar vac¨ªos despu¨¦s de una coma, solo se pueden omitir por completo.
- Con bitand como tercer par¨¢metro, el cuarto par¨¢metro
±è²¹³Ù°ù¨®²Ôse puede especificar como dos n¨²meros, separados por '/': ²Ô¨²³¾±ð°ù´Ç³å±è²¹°ù²¹³å³¦´Ç³¾±è²¹°ù²¹°ù³å³¦´Ç²Ô/³¾¨¢²õ³¦²¹°ù²¹. count() calcula "Y bit a bit" a partir del valor y la ³¾¨¢²õ³¦²¹°ù²¹ y compara el resultado con ²Ô¨²³¾±ð°ù´Ç³å²¹³å³¦´Ç³¾±è²¹°ù²¹°ù³å³¦´Ç²Ô. Si el resultado de "Y 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
patternpuede ser una expresi¨®n regular ordinaria o global (comenzando con '@'). En el caso de expresiones regulares globales, la distinci¨®n entre may¨²sculas y min¨²sculas se hereda de la configuraci¨®n de expresiones regulares globales. A los efectos de la coincidencia de expresiones regulares, los valores flotantes siempre se representar¨¢n con 4 d¨ªgitos decimales despu¨¦s de '.'. Tambi¨¦n tenga en cuenta que, para n¨²meros grandes, la diferencia en la representaci¨®n decimal (almacenada en la base de datos) y binaria (utilizada por el servidor Áú»¢¶Ä²©) puede afectar el cuarto d¨ªgito decimal.
Ejemplos:
count(max_foreach(/*/net.if.in[*],1h)) #el n¨²mero de elementos net.if.in que recibieron datos en la ¨²ltima hora hasta ahora
count(last_foreach(/*/vfs.fs.dependent.size[*,pused]),"gt",95) #la cantidad de sistemas de archivos con m¨¢s del 95% del espacio en disco utilizadohistogram_quantile(quantile,bucket1,value1,bucket2,value2,...)
Calcula el cuantil ¦Õ a partir de las agrupaciones de datos de un histograma.
¹ó³Ü²Ô³¦¾±¨®²Ô foreach admitida: bucket_rate_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ:
- 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 '' de PromQL;
- Devuelve -1 si los valores de la ¨²ltima agrupaci¨®n de datos '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.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:
- 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: .
Tipos de valores admitidos: Flotante, Entero.
¹ó³Ü²Ô³¦¾±¨®²Ô foreach admitida: last_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: .
Tipos de valores admitidos: Flotante, Entero.
¹ó³Ü²Ô³¦¾±¨®²Ô foreach admitida: last_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido.
Tipos de valores admitidos: Flotante, Entero.
Funciones foreach admitidas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido.
Tipos de valores admitidos: Flotante, Entero.
Funciones foreach admitidas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: 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 ²¹²õ¾±³¾±ð³Ù°ù¨ª²¹ de la distribuci¨®n de probabilidad en los valores recolectados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: .
Tipos de valores admitidos: Flotante, Entero.
¹ó³Ü²Ô³¦¾±¨®²Ô foreach admitida: last_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: .
Tipos de valores admitidos: Flotante, Entero.
¹ó³Ü²Ô³¦¾±¨®²Ô foreach admitida: last_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: consulte par¨¢metros comunes.
Ejemplo:
stddevpop(/host/key,1h) #la desviaci¨®n est¨¢ndar de la poblaci¨®n durante la ¨²ltima hora hasta ahorastddevsamp(/host/key,(sec|#num)<:time shift>)
La desviaci¨®n est¨¢ndar de la muestra en los valores recopilados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: .
Tipos de valores admitidos: Flotante, Entero.
¹ó³Ü²Ô³¦¾±¨®²Ô foreach admitida: last_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido.
Tipos de valores admitidos: Flotante, Entero.
Funciones foreach admitidas: avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido.
Tipos de valores admitidos: Flotante, Entero.
¹ó³Ü²Ô³¦¾±¨®²Ô foreach admitida: last_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: .
Tipos de valores admitidos: Flotante, Entero.
¹ó³Ü²Ô³¦¾±¨®²Ô foreach admitida: last_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: .
Tipos de valores admitidos: Flotante, Entero.
¹ó³Ü²Ô³¦¾±¨®²Ô foreach admitida: last_foreach.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ: consulte par¨¢metros comunes.
Se requieren al menos dos valores de datos para que esta funci¨®n funcione.
Ejemplo:
Consulte todas las funciones admitidas.