Exclusion

Docs > Dashboards > Fonctions > Exclusion

Exclude null

Fonction	Rôle	Exemple
`exclude_null()`	Supprime de votre graphique ou de votre Top List tous les groupes qui possèdent un tag avec la valeur N/A.	`exclude_null(avg:system.load.1{*} by {host})`

Imaginons que vous disposez d’une métrique avec deux tags : account et region. account peut prendre trois valeurs différentes (prod, build et N/A), et region quatre valeurs différentes (us-east-1, us-west-1, eu-central-1 et N/A).

Lorsque vous représentez cette métrique sous la forme d’une série temporelle, vous obtenez 12 lignes sur votre graphique (3 x 4). Si vous appliquez la fonction exclude_null(), les lignes avec les combinaisons de tags contenant n’importe quelle valeur N/A sont supprimées. Ainsi, cette fonction vous permet d’obtenir 6 groupes (2 x 3).

Clamp

Fonction	Rôle	Exemple
`clamp_min()`	Définit les valeurs d’une métrique inférieures à un seuil sur la valeur de ce seuil.	`clamp_min(avg:system.load.1{*}, 100)`
`clamp_max()`	Définit les valeurs d’une métrique supérieures à un seuil sur la valeur de ce seuil.	`clamp_max(avg:system.load.1{*}, 100)`

Ajouter une valeur de seuil. La fonction clamp_min() définit tous les points de données en dessous du seuil pour qu’ils soient égaux à cette valeur, tandis que clamp_max() limite les points de données au-dessus du seuil.

Remarque : clamp_min(values, threshold) et clamp_max(values, threshold) définissent tout NaN dans les valeurs sur threshold.

Pour éviter ce comportement, appliquez la fonction default_zero() avant la fonction clamp_min() / clamp_max().

Cutoff

Fonction	Rôle	Exemple
`cutoff_min()`	Remplacer les valeurs de métrique en dessous d’une valeur de seuil par NaN.	`cutoff_min(avg:system.load.1{*}, 100)`
`cutoff_max()`	Exclure les valeurs nulles et appliquer un filtrage basé sur des seuils en utilisant les fonctions clamp et cutoff sur les métriques.	`cutoff_max(avg:system.load.1{*}, 100)`

Ajouter une valeur de seuil. La fonction cutoff_min() remplace toutes les valeurs de métrique inférieures à cette valeur de seuil par NaN, tandis que cutoff_max() remplace toutes les valeurs de métrique supérieures à cette valeur de seuil par NaN. Les fonctions cutoff ne remplacent pas les valeurs qui sont égales à la valeur de seuil.

Conseil : pour les fonctions Clamp et Cutoff, il peut s’avérer utile de visualiser la valeur du seuil que vous avez défini. Vous pouvez définir un indicateur horizontal dans les dashboards pour représenter cette valeur.