Aperçu

Lorsque vous utilisez l’Explorateur de métriques, les moniteurs ou les tableaux de bord pour interroger les données de métriques, vous pouvez filtrer les données pour restreindre la portée des séries temporelles retournées. Toute métrique peut être filtrée par tag(s) en utilisant le champ from à droite de la métrique.

Vous pouvez également appliquer un filtrage avancé à l’aide de filtres de valeur de tag basés sur des booléens ou des wildcards. Pour les requêtes en dehors des données de métriques telles que les journaux, les traces, la surveillance du réseau, la surveillance des utilisateurs réels, les synthétiques ou la sécurité, consultez la documentation sur la Syntaxe de recherche de journaux pour la configuration.

Requêtes filtrées booléennes

Vous pouvez utiliser la syntaxe suivante pour générer des requêtes de métrique avec des filtres basés sur des booléens :

• !
• ,
• NOT, not
• AND, and
• OR, or
• IN, in
• NOT IN, not in

Lorsque vous souhaitez inclure ou exclure plusieurs tags :

• Include uses AND logic
• Exclude uses OR logic

Pour en savoir plus sur les tags, consultez le guide Débuter avec les tags.

Remarque : La syntaxe booléenne symbolique (!, ,) ne peut pas être utilisée avec les opérateurs de syntaxe fonctionnelle (NOT, AND, OR, IN, NOT IN). La requête suivante est considérée comme invalide : avg:mymetric{env:prod AND !region:us-east}

Exemples de requêtes filtrées booléennes

Pour utiliser les exemples ci-dessous, cliquez sur l’icône de code </> pour voir l’éditeur de requêtes dans l’interface utilisateur, puis copiez et collez l’exemple de requête dans l’éditeur de requêtes.

avg:system.cpu.user{env:staging AND (availability-zone:us-east-1a OR availability-zone:us-east-1c)} by {availability-zone}

avg:system.cpu.user{env:shop.ist AND availability-zone IN (us-east-1a, us-east-1b, us-east4-b)} by {availability-zone}

avg:system.cpu.user{env:prod AND location NOT IN (atlanta,seattle,las-vegas)}

Requêtes filtrées par caractères génériques

Les tags peuvent être filtrés en utilisant un wildcard comme préfixe, suffixe ou sous-chaîne :

• pod_name: web-*
• cluster:*-trace
• node:*-prod-*

Exemples de requêtes filtrées par caractères génériques

avg:system.disk.in_use{!device:/dev/loop*} by {device}

sum:kubernetes.pods.running{service:*-canary} by {service}

avg:system.disk.utilized{region:*east*} by {region}

Fonctions d’exclusion

Ajoutez une fonction d’exclusion à votre requête pour :

• Exclude N/A values.
• Appliquer une valeur minimale ou maximale aux métriques qui atteignent le seuil.
• Exclude values that are above or below threshold values.

Les fonctions suppriment les points de données de vos visualisations, mais pas de Datadog.

Lectures complémentaires

Documentation, liens et articles supplémentaires utiles:

Commencer avec la recherche dans DatadogDOCUMENTATION Metrics ExplorerDOCUMENTATION Metrics SummaryDOCUMENTATION Distributions de métriquesDOCUMENTATION Syntaxe de recherche de logs et filtre de requêteDOCUMENTATION Fonctions d'exclusionDOCUMENTATION