Configuration d'Azure Pipelines pour CI Visibility

Documentation > Continuous Integration Visibility > CI Pipeline Visibility dans Datadog > Configuration d'Azure Pipelines pour CI Visibility

Azure DevOps Server n'est pas officiellement pris en charge.

Présentation

Azure Pipelines est un service d’intégration continue et de livraison continue qui prend en charge n’importe quel langage, plateforme ou cloud.

Configurez CI Visibility pour Azure Pipelines afin d’obtenir des informations en temps réel sur vos workflows CI/CD, de suivre les performances des pipelines, d’analyser les inefficacités et de gérer vos opérations de déploiement.

Compatibilité

Pipeline Visibility	Plateforme	Définition
Analyse des logs	Analyse des logs	Utilisez des modèles LLM sur les logs pertinents pour analyser la cause racine des jobs CI ayant échoué.
Corrélation des logs	Corrélation des logs	Corrélez les spans de pipeline et de job aux logs. Nécessite Logs Storage.
Tags personnalisés et mesures au moment de l’exécution	Tags personnalisés et mesures au moment de l’exécution	Configurez des tags et mesures personnalisés au moment de l’exécution.
Spans personnalisés	Spans personnalisés	Configurez des spans personnalisés pour vos pipelines.
Filtrer les jobs CI sur le chemin critique	Filtrer les jobs CI sur le chemin critique	Filtrez par jobs sur le chemin critique.
Temps d’exécution	Temps d’exécution	Affichez la durée pendant laquelle les pipelines ont exécuté des jobs.

Terminologie

Ce tableau montre la correspondance des concepts entre Datadog CI Visibility et Azure Pipelines :

Datadog	Azure Pipelines
Pipeline	Pipeline
Phase	Étape
Job	Job
Non disponible dans Datadog	Étape

Configurer l’intégration Datadog

Activez CI Visibility dans Datadog

Une fois l’application Azure créée et installée, activez CI Visibility pour les organisations et les projets que vous souhaitez que Datadog surveille.

Vérifiez que votre organisation Azure DevOps est liée à un locataire Microsoft Entra. Consultez les instructions de configuration du code source Azure pour obtenir des conseils sur la connexion des projets Azure DevOps à Datadog.
Dans Datadog, accédez à Software Delivery → CI Visibility → Add a Pipeline Provider → Azure Pipelines.
Cliquez sur Configure à côté de l’organisation Azure DevOps que vous souhaitez activer.
Pour activer CI Visibility pour l’ensemble de l’organisation, activez Enable CI Visibility. Les futurs projets détectés par l’application Azure seront automatiquement activés.
Pour activer CI Visibility pour des projets individuels:
- Faites défiler la liste des projets.
- Activez Enable CI Visibility pour chaque projet que vous souhaitez surveiller.

Les pipelines apparaissent dans Datadog immédiatement après l’activation de CI Visibility pour une organisation ou un projet.

Si vous avez précédemment configuré Azure Pipelines à l'aide d'abonnements aux hooks de service, désactivez cette intégration avant d'activer CI Visibility pour les mêmes projets. L'exécution simultanée des deux intégrations n'entraîne pas de coûts supplémentaires, mais crée des données en double.

L’intégration Datadog pour Azure Pipelines fonctionne en utilisant des hooks de service pour envoyer des données à Datadog.

Installez l’extension Datadog CI Visibility depuis Azure Marketplace. Il existe plusieurs extensions commençant par Datadog, assurez-vous d’installer l’extension Datadog CI Visibility.
Pour chaque projet, accédez à Project settings > Service hooks dans Azure DevOps et sélectionnez l’icône plus verte (+) pour créer un abonnement.
Créez un abonnement au service Datadog CI Visibility pour chacun des types de webhook suivants. Ces types d’événements sont requis et doivent être activés individuellement.
- Run state changed
- Run stage state changed
- Run job state changed
- Run stage approval completed
- Run stage waiting for approval
- Build completed
Cliquez sur Next pour passer à l’étape suivante et définir les éléments suivants :
- Datadog Site : <span class="js-region-param region-param" data-region-param="dd_site"></span>
- Datadog API Key : Votre clé d’API Datadog.
Cliquez sur Finish.

Configuration de plusieurs projets en masse

Datadog propose un script pour vous aider à activer les hooks de service sur plusieurs ou la totalité de vos projets Azure en utilisant l’API Azure. Le script nécessite Python 3 et le package requests.

Pour exécuter le script, vous avez besoin de :

Un nom d’utilisateur Azure DevOps
Un jeton d’API Azure DevOps
Un nom d’organisation Azure DevOps

Le script prend en charge les variables d’environnement DD_API_KEY et DD_SITE, ainsi que les paramètres de flag --dd-api-key et --dd-site.

Pour plus d’informations, vous pouvez exécuter la commande suivante :

./service_hooks.py --help

Tous les projets Azure

Exemple pour activer les hooks dans tous les projets :

./service_hooks.py \
    --dd-api-key ******************** \
    --az-user "John Doe" \
    --az-token ********************** \
    --az-org datadoghq \
    --threads 4

Projets Azure spécifiques

Exemple pour activer les hooks dans des projets spécifiés :

./service_hooks.py \
    --dd-api-key ******************** \
    --az-user "John Doe" \
    --az-token ********************** \
    --az-org datadoghq \
    projectName1 projectName2

Configuration avancée

Définir des tags personnalisés

Vous pouvez définir des tags personnalisés pour tous les spans de pipeline et de job de vos projets Azure afin d’améliorer la traçabilité. Pour plus d’informations, consultez Tags et mesures personnalisés.

Gérer les logs de jobs

Analyse des logs

L’analyse des logs utilise des modèles LLM pour classer les échecs de job par cause racine en fonction des logs pertinents provenant d’Azure Pipelines.

Pour une explication complète, consultez le guide sur l’utilisation de l’analyse des logs.

L’analyse des logs est activée par défaut dans Datadog. Pour recevoir les logs de job Azure Pipelines à des fins d’analyse, configurez l’intégration Datadog Azure DevOps en suivant les étapes indiquées dans la tuile d’intégration Azure. Pour gérer les paramètres d’analyse des logs, accédez aux paramètres du dépôt CI/CD et configurez l’analyse des logs au niveau de l’organisation Datadog ou pour les dépôts souhaités.

Vous pouvez également ajouter l’Analyse des logs à un commentaire de PR. Consultez le guide sur l’utilisation des commentaires de PR.

Stockage des logs

Pour activer le stockage des logs, accédez aux paramètres du dépôt CI/CD et activez le stockage des logs au niveau de l’organisation Datadog ou pour les dépôts souhaités.

Logs Storage est facturé séparément de CI Visibility. La rétention, l’exclusion et les index des logs sont configurés dans Log Management. Les logs des jobs Azure peuvent être identifiés par les tags datadog.product:cipipeline et source:azurepipelines.

Visualisez les données de pipeline dans Datadog

Les pages CI Pipeline List et Executions sont alimentées en données une fois les workflows terminés.

La page CI Pipeline List affiche uniquement les données de la branche par défaut de chaque dépôt. Pour plus d’informations, consultez Rechercher et gérer les pipelines CI.