Documentation
Table of Contents
1 Fonctions d'agrégation
Sauf indication contraire, toutes les fonctions répertoriées ici sont prises en charge dans :
Les fonctions d'agrégation peuvent fonctionner avec :
- l'historique des éléments, par exemple,
min(/host/key,1h) - les fonctions foreach comme seul paramètre, par exemple,
min(last_foreach(/*/key))
Quelques notes générales sur les paramètres de fonction :
- Les paramètres de fonction sont séparés par une virgule
- Les paramètres de fonction optionnels (ou parties de paramètres) sont indiqués par
<> - Les paramètres spécifiques à la fonction sont décrits pour chaque fonction
- Les paramètres
/host/keyet(sec|#num)<:time shift>ne doivent jamais être entre guillemets
Paramètres communs
/host/keyest un premier paramètre commun obligatoire pour les fonctions se référant à l'historique de l'élément d'hôte(sec|#num)<:time shift>est un deuxième paramètre courant pour les fonctions faisant référence à l'historique de l'élément d'hôte, où :- sec - période d'évaluation maximum en secondes (les suffixes peuvent être utilisés), ou
- #num - période d'évaluation maximum en nombre de valeurs collectées (si précédées d'un signe dièse)
- décalage horaire (facultatif) permet de déplacer le point d'évaluation dans le temps. Voir plus de détails sur la spécification du décalage horaire.
Fonctions d'agrégation
| FONCTION | ||
|---|---|---|
| Description | Paramètres spécifiques à la fonction | Commentaires |
| avg (/host/key,(sec|#num)<:time shift>) | ||
| Valeur moyenne d'un élément au cours de la période d'évaluation définie. | Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemples : => avg(/host/key,1h) → valeur moyenne pour la dernière heure jusqu'à maintenant => avg(/host/key,1h:now-1d) → valeur moyenne pour une heure d'il y a 25 heures à il y a 24 heures à partir de maintenant => avg(/host/key,#5) → valeur moyenne des cinq dernières valeurs => avg(/host/key,#5:now-1d) → valeur moyenne des cinq dernières valeurs excluant les valeurs reçues au cours des dernières 24 heures Le décalage temporel est utile lorsqu'il est nécessaire de comparer la valeur moyenne actuelle avec la valeur moyenne il y a quelque temps. |
| bucket_percentile (item filter,time period,percentage) | ||
| Calcule le centile à partir des compartiments d'un histogramme. | item filter - voir filtre délément time period - voir période percentage - pourcentage (0-100) |
Pris en charge uniquement dans les éléments calculés. Cette fonction est un alias pour histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1)) |
| count (func_foreach(item filter,<time period>)) | ||
| Nombre de valeurs dans un tableau renvoyé par une fonction foreach. | func_foreach - fonction foreach pour laquelle le nombre de valeurs renvoyées doit être compté (avec des arguments pris en charge). Voir fonctions foreach pour plus de détails. | Type de valeur pris en charge : entier Exemple : => count(max_foreach(/*/net.if.in[*],1h)) → nombre d'éléments net.if.in ayant reçu des données au cours de la dernière heure jusqu'à maintenant Notez que l'utilisation de count() avec une fonction foreach liée à l'historique (max_foreach, avg_foreach, etc.) peut avoir des conséquences sur les performances, alors que l'utilisation de exists_foreach(), qui ne fonctionne qu'avec les données de configuration, n'aura pas cet effet. |
| histogram_quantile (quantile,bucket1,value1,bucket2,value2,...) | ||
| Calcule le φ-quantile à partir des compartiments d'un histogramme. | quantile - 0 ≤ φ ≤ 1 bucketN, valueN - paires saisies manuellement (>=2) de paramètres ou réponse de bucket_rate_foreach |
Compatible uniquement avec les éléments calculés. Correspond fonctionnellement à 'histogram_quantile' de PromQL. Renvoie -1 si les valeurs du dernier bucket 'Infinity' (""+inf") sont égales à 0. Exemple : => 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) | ||
| Nombre d'éléments existants dans la configuration qui correspondent aux critères de filtre. | item filter - critères de sélection des éléments, permet le référencement par groupe d'hôtes, hôte, clé d'élément et balises. Les caractères génériques sont pris en charge. Voir filtre d'élément pour plus de détails. | Pris en charge uniquement dans les éléments calculés. Type de valeur pris en charge : entier Fonctionne comme un alias pour la fonction count(exists_foreach(item_filter)). Exemple : => item_count(/*/agent.ping?[group="Host group 1"]) → nombre d'hôtes avec l'élément agent.ping dans le "Host group 1" |
| kurtosis (/host/key,(sec|#num)<:time shift>) | ||
| "Tailedness" de la distribution de probabilité dans les valeurs collectées au cours de la période d'évaluation définie. Voir aussi : Kurtosis |
Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemple : => kurtosis(/host/key,1h) → aplatissement pendant la dernière heure jusqu'à maintenant |
| mad (/host/key,(sec|#num)<:time shift>) | ||
| Écart absolu médian des valeurs collectées au cours de la période d'évaluation définie. Voir aussi : Écart absolu médian |
Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemple : => mad(/host/key,1h) → écart absolu médian pour la dernière heure jusqu'à maintenant |
| max (/host/key,(sec|#num)<:time shift>) | ||
| Valeur la plus élevée d'un élément dans la période d'évaluation définie. | Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemple : => max(/host/key,1h) - min(/host/key,1h) → calcule la différence entre les valeurs maximales et minimales au cours de la dernière heure jusqu'à maintenant (delta de valeurs) |
| min (/host/key,(sec|#num)<:time shift>) | ||
| Valeur la plus basse d'un élément dans la période d'évaluation définie. | Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemple : => max(/host/key,1h) - min(/host/key,1h) → calcule la différence entre les valeurs maximales et minimales au cours de la dernière heure jusqu'à maintenant (delta de valeurs) |
| skewness (/host/key,(sec|#num)<:time shift>) | ||
| Asymétrie de la distribution des probabilités dans les valeurs collectées au cours de la période d'évaluation définie. Voir aussi : asymétrie |
Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemple : => skewness(/host/key,1h) → asymétrie pour la dernière heure jusqu'à maintenant |
| stddevpop (/host/key,(sec|#num)<:time shift>) | ||
| Écart-type de la population dans les valeurs collectées au cours de la période d'évaluation définie. Voir aussi :Écart-type |
Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemple : => stddevpop(/host/key,1h) → écart-type de la population pour la dernière heure jusqu'à maintenant |
| stddevsamp (/host/key,(sec|#num)<:time shift>) | ||
| Exemple d'écart type dans les valeurs collectées au cours de la période d'évaluation définie. Voir aussi : Écart-type |
Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemple : => stddevsamp(/host/key,1h) → exemple d'écart type pour la dernière heure jusqu'à maintenant |
| sum (/host/key,(sec|#num)<:time shift>) | ||
| Somme des valeurs collectées au cours de la période d'évaluation définie. | Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemple : => sum(/host/key,1h) → somme des valeurs de la dernière heure jusqu'à maintenant |
| sumofsquares (/host/key,(sec|#num)<:time shift>) | ||
| La somme des carrés des valeurs collectées au cours de la période d'évaluation définie. | Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemple : => sumofsquares(/host/key,1h) → somme des carrés pour la dernière heure jusqu'à maintenant |
| varpop (/host/key,(sec|#num)<:time shift>) | ||
| Écart de population des valeurs collectées au cours de la période d'évaluation définie. Voir aussi : Variance |
Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Exemple : => varpop(/host/key,1h) → variance de la population pour la dernière heure jusqu'à maintenant |
| varsamp (/host/key,(sec|#num)<:time shift>) | ||
| Exemple de variance des valeurs collectées au cours de la période d'évaluation définie. Voir aussi : Variance |
Voir les paramètres communs. | Types de valeur pris en charge : flottant, entier Au moins deux valeurs de données sont requises pour que cette fonction fonctionne. Exemple : => varsamp(/host/key,1h) → variance de l'échantillon pour la dernière heure jusqu'à maintenant |