Définir les paramètres d'ingestion pour CI Visibility

Docs > Continuous Integration Visibility > Guides sur CI Visibility > Définir les paramètres d'ingestion pour CI Visibility

Présentation

Les filtres d’exclusion permettent de contrôler précisément votre budget de CI Visibility en vous laissant définir une ou plusieurs conditions pour que Datadog ne traite pas certains événements.

Compatibilité

Des filtres sont disponibles pour Pipeline Visibility.

Ajouter un filtre d’exclusion

Les filtres d’exclusion ne sont pas nécessaires pour configurer Pipeline Visibility. Toutes les données sont ingérées et traitées par défaut.

Pour créer des filtres pour votre organisation, votre compte utilisateur doit disposer de l’autorisation ci_ingestion_control_write.

Dans Datadog, accédez à CI > Settings > Ingestion Settings.
Sélectionnez Add an Exclusion Filter.

Nommez le filtre et définissez une requête. Après avoir défini une requête, l’aperçu se trouvant au-dessus des champs de saisie affiche les données ingérées qui correspondent à votre requête. Une fois que votre filtre est créé et activé, les événements similaires à ceux présentés dans l’aperçu sont exclu de l’ingestion.

Créer un filtre dʼexclusion pour un pipeline spécifique

Une fois que vous avez ajouté un filtre, chaque ligne de cette page affiche :

Filter name - le nom du filtre
Exclusion query - la requête qui a été définie pour ce filtre
Basculer pour activer/désactiver le filtre - les filtres nouvellement créés sont activés par défaut.

Toutes les spans correspondant à un ou plusieurs filtres ne sont ni ingérés ni traités par Datadog.

Définir des requêtes pour un filtre d’exclusion

Les filtres sont définis de manière flexible par le biais d’une interface d’édition de requêtes. Vous pouvez vous appuyer sur des tags et des attributs pour créer vos filtres.

Exemples de filtres d’exclusion

Vous trouverez ci-dessous des exemples de la façon dont les filtres d’exclusion peuvent vous permettre d’optimiser l’utilisation et la facturation de CI Visibility.

Filtrer par l’adresse e-mail de l’auteur de git

Vous pouvez choisir de ne pas surveiller un ou plusieurs auteurs spécifiques en définissant un filtre avec l’adresse e-mail de l’auteur de git (@git.commit.author.email). La capture d’écran ci-dessous montre un filtre dans lequel tous les spans associés à des commits provenant de cette adresse e-mail spécifique de l’auteur de git ne sont pas ingérés.

Filtre dʼexclusion pour les paramètres dʼingestion pour une adresse e-mail

Filtrer par domaine d’adresse e-mail de l’auteur de git

Vous pouvez également exclure plusieurs auteurs à la fois par domaine d’adresse e-mail (par exemple, vous pouvez choisir dʼexclure les contributeurs externes qui commettent dans les dépôts surveillés). La capture d’écran ci-dessous montre un filtre dans lequel tous les spans associés à des commits provenant de domaines d’adresses e-mail qui ne correspondent pas à celui de la requête ne sont pas ingérés.

Filtrer par référentiel

Vous pouvez exclure des référentiels spécifiques de la surveillance (par exemple, un référentiel de test interne) en définissant un filtre avec le nom (@git.repository.name) ou l’ID (@git.repository.id) du référentiel. La capture d’écran ci-dessous montre un filtre dans lequel tous les spans associés aux commits de ce dépôt ne sont pas ingérés.

Filtre dʼexclusion pour les paramètres dʼingestion pour un référentiel

Mettre à jour des filtres d’exclusion

Les filtres d’exclusion peuvent être activés/désactivés, mis à jour et supprimés par les utilisateurs disposant dʼautorisations ci_ingestion_control_write. Ils sont appliqués au niveau de l’organisation. Vous pouvez consulter des informations détaillées sur les personnes qui ont modifié les filtres d’exclusion en utilisant le journal dʼaudit de Datadog.

Activer et désactiver des filtres

Un bouton situé à droite de chaque filtre vous permet d’activer et de désactiver le filtre à tout moment. Les filtres nouvellement créés sont activés par défaut.

Remarque : dans la plupart des cas, les filtres sont appliqués aux données ingérées dans un délai de moins d’une seconde (p95) après leur activation. Cependant, il est possible qu’un filtre activé nécessite jusqu’à quelques minutes pour prendre effet.