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 - ±è¨¦°ù¾±´Ç»å±ð d'¨¦valuation maximum en secondes (les suffixes peuvent ¨ºtre utilis¨¦s), ou
- #num - ±è¨¦°ù¾±´Ç»å±ð 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 ±è¨¦°ù¾±´Ç»å±ð 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 ±è¨¦°ù¾±´Ç»å±ð 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 ¨¤ '' 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 ±è¨¦°ù¾±´Ç»å±ð d'¨¦valuation d¨¦finie. Voir aussi : |
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 ±è¨¦°ù¾±´Ç»å±ð d'¨¦valuation d¨¦finie. Voir aussi : |
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 ±è¨¦°ù¾±´Ç»å±ð 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 ±è¨¦°ù¾±´Ç»å±ð 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 ±è¨¦°ù¾±´Ç»å±ð d'¨¦valuation d¨¦finie. Voir aussi : |
Voir les param¨¨tres communs. | Types de valeur pris en charge : flottant, entier Exemple : => skewness(/host/key,1h) ¡ú ²¹²õ²â³¾¨¦³Ù°ù¾±±ð 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 ±è¨¦°ù¾±´Ç»å±ð d'¨¦valuation d¨¦finie. Voir aussi : |
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 ±è¨¦°ù¾±´Ç»å±ð d'¨¦valuation d¨¦finie. Voir aussi : |
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 ±è¨¦°ù¾±´Ç»å±ð 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 ±è¨¦°ù¾±´Ç»å±ð 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 ±è¨¦°ù¾±´Ç»å±ð d'¨¦valuation d¨¦finie. Voir aussi : |
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 ±è¨¦°ù¾±´Ç»å±ð d'¨¦valuation d¨¦finie. Voir aussi : |
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 |