Configuration de Buildkite pour CI Visibility

Docs > Continuous Integration Visibility > CI Pipeline Visibility dans Datadog > Configuration de Buildkite pour CI Visibility

Section Overview

Buildkite est une plateforme d’intégration et de déploiement continus qui vous permet d’exécuter des builds sur votre propre infrastructure, vous offrant un contrôle total sur la sécurité et la personnalisation de votre environnement de build tout en gérant l’orchestration dans le cloud.

Configurez CI Visibility pour Buildkite afin d’optimiser l’utilisation de vos ressources, de réduire les coûts généraux et d’améliorer la vitesse et la qualité du cycle de vie de développement logiciel.

Compatibilité

Pipeline Visibility	Plateforme	Définition
Tentatives partielles	Pipelines partiels	Consultez les exécutions de pipelines faisant lʼobjet de nouvelles tentatives.
Mise en corrélation des métriques d’infrastructure	Mise en corrélation des métriques d’infrastructure	Mettre en corrélation les tâches avec les métriques d’infrastructure des hosts pour les agents Buildkite.
Étapes manuelles	Étapes manuelles	Consultez les pipelines déclenchés manuellement.
Temps de mise en file d’attente	Temps de mise en file d’attente	Afficher le temps pendant lequel les tâches de pipeline restent dans la file d’attente avant le traitement.
Tags personnalisés et mesures au moment de l’exécution	Tags et mesures personnalisés au moment de l’exécution	Configurer des tags et des mesures personnalisés au moment de l’exécution.
Spans personnalisées	Spans personnalisées	Configurer des spans personnalisées pour vos pipelines.
Filtrer les tâches CI sur le chemin critique	Filtrer les tâches CI sur le chemin critique	Filtrer par tâches sur le chemin critique.
Temps d’exécution	Durée d’exécution	Afficher le temps pendant lequel les pipelines ont exécuté des tâches.

Termes

Ce tableau présente le mappage des concepts entre Datadog CI Visibility et Buildkite :

Datadog	Buildkite
Pipeline	Build (exécution d’un pipeline)
Job	Job (exécution d’un step)

Configurer l’intégration Datadog

Pour configurer l’intégration Datadog pour Buildkite :

Accédez à Settings > Notification Services dans Buildkite et cliquez sur le bouton Add à côté de Datadog Pipeline Visibility.
Renseignez les informations suivantes dans le formulaire :
- Description : une description pour aider à identifier l’intégration à l’avenir, telle que Datadog CI Visibility integration.
- API key : votre clé d’API Datadog.
- Datadog site :
- Pipelines : sélectionnez tous les pipelines ou les sous-ensembles de pipelines que vous souhaitez tracer.
- Branch filtering : laissez ce champ vide pour tracer toutes les branches ou sélectionnez le sous-ensemble de branches que vous souhaitez tracer.
Cliquez sur Add Datadog Pipeline Visibility Notification pour enregistrer l’intégration.

Configuration avancée

Appliquer des tags personnalisés

Exécutez la commande buildkite-agent meta-data set pour ajouter des tags personnalisés aux traces Buildkite. Tous les tags de métadonnées avec une clé commençant par dd_tags. sont ajoutés aux spans de tâche et de pipeline. Ces tags peuvent vous servir à créer des facettes basées sur des chaînes afin de rechercher et d’organiser vos pipelines.

Le YAML ci-dessous implémente un pipeline simple doté de tags pour le nom d’équipe et la version de Go.

steps:
  - command: buildkite-agent meta-data set "dd_tags.team" "backend"
  - command: go version | buildkite-agent meta-data set "dd_tags.go.version"
    label: Go version
  - commands: go test ./...
    label: Run tests

Les tags suivants s’affichent dans la span racine ainsi que dans la span de tâche pertinente dans Datadog.

team: backend
go.version: go version go1.17 darwin/amd64 (la sortie varie selon l’exécuteur)

Le pipeline résultant ressemble à ce qui suit :

Trace de pipeline Buildkite avec des tags personnalisés

Toute métadonnée avec une clé commençant par dd-measures. et contenant une valeur numérique sera définie comme un tag de métrique qui peut être utilisé pour créer des mesures numériques.

Vous pouvez utiliser la commande buildkite-agent meta-data set pour créer ces tags.

Par exemple, vous pouvez mesurer la taille du binaire dans un pipeline avec cette commande :

steps:
  - commands:
    - go build -o dst/binary .
    - ls -l dst/binary | awk '{print \$5}' | tr -d '\n' | buildkite-agent meta-data set "dd_measures.binary_size"
    label: Go build

Les tags indiqués sous la span de pipeline sont alors appliqués au pipeline obtenu :

binary_size: 502 (la sortie dépend de la taille du fichier)

Ici, la valeur de binary_size vous permet de représenter l’évolution de la taille du binaire.

Mettre les métriques d’infrastructure en corrélation avec les tâches

Si vous utilisez des agents Buildkite, vous pouvez mettre en corrélation les tâches avec l’infrastructure qui les exécute. Pour que cette fonctionnalité fonctionne, installez l’Agent Datadog sur les hosts exécutant les agents Buildkite.

Afficher les pipelines partiels et en aval

Vous pouvez utiliser les filtres suivants pour personnaliser votre requête de recherche dans le CI Visibility Explorer.

La page des exécutions de pipeline avec Partial Pipeline:retry saisi dans la requête de recherche

Nom de la facette	ID de facette	Valeurs possibles
Downstream Pipeline	`@ci.pipeline.downstream`	`true`, `false`
Manually Triggered	`@ci.is_manual`	`true`, `false`
Partial Pipeline	`@ci.partial_pipeline`	`retry`, `paused`, `resumed`

Vous pouvez également appliquer ces filtres à l’aide du panneau de facettes sur le côté gauche de la page.

Le panneau de facettes avec la facette Partial Pipeline développée et la valeur Retry sélectionnée, la facette Partial Retry développée et la valeur true sélectionnée

Visualiser les données de pipeline dans Datadog

Les pages CI Pipeline List et Executions se remplissent de données une fois les pipelines terminés.

La page CI Pipeline List affiche des données uniquement pour la branche par défaut de chaque référentiel. Pour plus d’informations, consultez la section Rechercher et gérer les pipelines CI.