[comment]: # translation:outdated

[comment]: # ({ee60e21e-ee60e21e})
# 1 Fonctions d'agrégation

Sauf indication contraire, toutes les fonctions répertoriées ici sont prises en charge dans :

- Les [expressions de déclenchement](/manual/config/triggers/expression)
- Les [éléments calculés](/manual/config/items/itemtypes/calculated)

Les fonctions d'agrégation peuvent fonctionner avec :

- l'historique des éléments, par exemple, `min(/host/key,1h)` 
- les fonctions [foreach](/manual/appendix/functions/aggregate/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/key` et `(sec|#num)<:time shift>` ne doivent jamais être entre guillemets

[comment]: # ({/ee60e21e-ee60e21e})

[comment]: # ({4d343eb8-4d343eb8})
##### Paramètres communs

- `/host/key` est 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](/manual/config/triggers#evaluation_period) maximum en secondes (les [suffixes](/manual/appendix/suffixes) peuvent être utilisés), ou
    - **\#num** - [période d'évaluation](/manual/config/triggers#evaluation_period) 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](/manual/config/triggers/expression#time_shift) sur la spécification du décalage horaire.

[comment]: # ({/4d343eb8-4d343eb8})

[comment]: # ({bd2bf16a-ad86e84b})

#### 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](#common-parameters).|Types de valeur pris en charge : flottant, entier<br><br>Exemples :<br>=> **avg**(/host/key,**1h**) → valeur moyenne pour la dernière heure jusqu'à [maintenant](/manual/config/triggers#evaluation_period)<br>=> **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](/manual/config/triggers#evaluation_period)<br>=> **avg**(/host/key,**\#5**) → valeur moyenne des cinq dernières valeurs<br>=> **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<br><br>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](/manual/appendix/functions/aggregate/foreach#item_filter)<br>**time period** - voir [période](/manual/appendix/functions/aggregate/foreach#time_period)<br>**percentage** - pourcentage (0-100)|Pris en charge uniquement dans les éléments calculés.<br><br>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](/manual/appendix/functions/aggregate/foreach) pour plus de détails.|Type de valeur pris en charge : entier<br><br>Exemple :<br>=> **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](/manual/config/triggers#evaluation_period)<br><br>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<br>**bucketN, valueN** - paires saisies manuellement (>=2) de paramètres ou réponse de [bucket\_rate\_foreach](/manual/appendix/functions/aggregate/foreach)|Compatible uniquement avec les éléments calculés.<br><br>Correspond fonctionnellement à '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)' de PromQL.<br><br> Renvoie -1 si les valeurs du dernier bucket 'Infinity' ("*"+inf"*) sont égales à 0. <br><br>Exemple :<br>=> **histogram\_quantile**(0.75,1.0,last(/host/rate\_bucket\[1.0\]),"+Inf",last(/host/rate\_bucket\[Inf\])<br>=> **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](/manual/appendix/functions/aggregate/foreach#item_filter) pour plus de détails.|Pris en charge uniquement dans les éléments calculés.<br><br>Type de valeur pris en charge : entier<br><br>Fonctionne comme un alias pour la fonction *count(exists\_foreach(item\_filter))*.<br><br>Exemple :<br>=> **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.<br><br>Voir aussi : [Kurtosis](https://en.wikipedia.org/wiki/Kurtosis)|Voir les  [paramètres communs](#common-parameters).|Types de valeur pris en charge : flottant, entier<br><br>Exemple :<br>=> **kurtosis**(/host/key,**1h**) → aplatissement pendant la dernière heure jusqu'à [maintenant](/manual/config/triggers#evaluation_period)|
|**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.<br><br>Voir aussi : [Écart absolu médian](https://en.wikipedia.org/wiki/Median_absolute_deviation)|Voir les [paramètres communs](#common parameters).|Types de valeur pris en charge : flottant, entier<br><br>Exemple :<br>=> **mad**(/host/key,**1h**) → écart absolu médian pour la dernière heure jusqu'à [maintenant](/manual/config/triggers#evaluation_period)|
|**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](#common-parameters).|Types de valeur pris en charge : flottant, entier<br><br>Exemple :<br>=> **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](/manual/config/triggers#evaluation_period) (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](#common-parameters).|Types de valeur pris en charge : flottant, entier<br><br>Exemple :<br>=> **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](/manual/config/triggers#evaluation_period) (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.<br><br>Voir aussi : [asymétrie](https://fr.wikipedia.org/wiki/Asym%C3%A9trie_(statistiques))|Voir les [paramètres communs](#common-parameters).|Types de valeur pris en charge : flottant, entier<br><br>Exemple :<br>=> **skewness**(/host/key,**1h**) → asymétrie pour la dernière heure jusqu'à [maintenant](/manual/config/triggers#evaluation_period)|
|**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.<br><br>Voir aussi :[Écart-type](https://fr.wikipedia.org/wiki/%C3%89cart_type)|Voir les [paramètres communs](#paramètres-communs).|Types de valeur pris en charge : flottant, entier<br><br>Exemple :<br>=> **stddevpop**(/host/key,**1h**) → écart-type de la population pour la dernière heure jusqu'à [maintenant](/manual/config/triggers#evaluation_period)|
|**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.<br><br>Voir aussi : [Écart-type](https://fr.wikipedia.org/wiki/%C3%89cart_type)|Voir les [paramètres communs](#paramètres-communs).|Types de valeur pris en charge : flottant, entier<br><br>Exemple :<br>=> **stddevsamp**(/host/key,**1h**) → exemple d'écart type pour la dernière heure jusqu'à [maintenant](/manual/config/triggers#evaluation_period)|
|**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](#paramètres-communs).|Types de valeur pris en charge : flottant, entier<br><br>Exemple :<br>=> **sum**(/host/key,**1h**) → somme des valeurs de la dernière heure jusqu'à [maintenant](/manual/config/triggers#evaluation_period)|
|**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](#paramètres-communs).|Types de valeur pris en charge : flottant, entier<br><br>Exemple :<br>=> **sumofsquares**(/host/key,**1h**) → somme des carrés pour la dernière heure jusqu'à [maintenant](/manual/config/triggers#evaluation_period)|
|**varpop** (/host/key,(sec\|\#num)\<:time shift\>)|<|<|
|Écart de population des valeurs collectées au cours de la période d'évaluation définie.<br><br>Voir aussi : [Variance](https://fr.wikipedia.org/wiki/Variance_(math%C3%A9matiques))|Voir les [paramètres communs](#paramètres-communs).|Types de valeur pris en charge : flottant, entier<br><br>Exemple :<br>=> **varpop**(/host/key,**1h**) → variance de la population pour la dernière heure jusqu'à [maintenant](/manual/config/triggers#evaluation_period)|
|**varsamp** (/host/key,(sec\|\#num)\<:time shift\>)|<|<|
|Exemple de variance des valeurs collectées au cours de la période d'évaluation définie.<br><br>Voir aussi : [Variance](https://fr.wikipedia.org/wiki/Variance_(math%C3%A9matiques))|Voir les [paramètres communs](#paramètres-communs).|Types de valeur pris en charge : flottant, entier<br><br>Au moins deux valeurs de données sont requises pour que cette fonction fonctionne.<br><br>Exemple :<br>=> **varsamp**(/host/key,**1h**) → variance de l'échantillon pour la dernière heure jusqu'à [maintenant](/manual/config/triggers#evaluation_period)|

[comment]: # ({/bd2bf16a-ad86e84b})