Exclusion

Exclude null

FonctionDescriptionExemple
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

FonctionDescriptionExemple
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)

Les fonctions clamp_min() et clamp_max() comprennent un paramètre :

  • THRESHOLD : la valeur du seuil que vous spécifiez.
    • clamp_min() définit la valeur de tous les points de données en dessous du seuil sur la valeur de ce seuil, tandis que la fonction clamp_max() limite les points de données au-dessus du seuil.

Cutoff

FonctionDescriptionExemple
cutoff_min()Supprime les valeurs d’une métrique inférieures à un seuil.cutoff_min(avg:system.load.1{*}, 100)
cutoff_max()Supprime les valeurs d’une métrique supérieures à un seuil.cutoff_max(avg:system.load.1{*}, 100)

Les fonctions cutoff_min() et cutoff_max() comprennent un paramètre :

  • THRESHOLD : la valeur du seuil que vous spécifiez.
    • cutoff_min() supprime du graphique toutes les valeurs de métrique inférieures au seuil, tandis que cutoff_max() supprime toutes les valeurs de métrique supérieures au seuil.

Les fonctions Cutoff ne suppriment pas les valeurs égales au seuil.

De plus, les fonctions ne suppriment pas définitivement les points de données de Datadog : les valeurs sont uniquement retirées de votre visualisation. Si vous désactivez la fonction, les valeurs supprimées s’affichent à nouveau.

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.

Autres fonctions