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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô 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.
Funciones agregadas
| FUNCI?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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô 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 (³¦³Ü²¹²Ô³Ù¾±±ô,»å±ð±è¨®²õ¾±³Ù´Ç1,±¹²¹±ô´Ç°ù1,»å±ð±è¨®²õ¾±³Ù´Ç2,±¹²¹±ô´Ç°ù2,...) | ||
| 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 '' 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: |
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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: |
Ver ±è²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ-³¦´Ç³¾³Ü²Ô±ð²õ. | 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô 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>) | ||
| ´¡²õ¾±³¾±ð³Ù°ù¨ª²¹ de la distribuci¨®n de probabilidad en los valores recopilados dentro del per¨ªodo de ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: |
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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: |
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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: |
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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô 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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: |
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 ±ð±¹²¹±ô³Ü²¹³¦¾±¨®²Ô definido. Ver tambi¨¦n: |
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 |