Configurer le tracing sur un pipeline TeamCity

Docs > Continuous Integration Visibility > CI Pipeline Visibility dans Datadog > Configurer le tracing sur un pipeline TeamCity

Présentation

TeamCity est une intégration en continu et un serveur de livraison qui optimise et automatise les processus de développements de logiciels.

Configurez le tracing pour recueillir des données sur lʼexécution de vos pipelines, corriger des problèmes de performances et liés aux adresses, et optimiser vos workflows de développement.

Compatibilité

Pipeline Visibility	Plateforme	Définition
Tentatives partielles	Retenter les déclencheurs de builds	Afficher les exécutions de pipelines partiellement tentées.
Temps de file dʼattente	Temps de file dʼattente	Consulter la durée pendant laquelle les tâches de pipeline restent dans la file dʼattente avant dʼêtre traitées
Raisons dʼéchecs de pipelines	Raisons dʼéchecs de pipelines	Identifier les raisons de lʼéchec dʼun pipeline à partir de messages dʼerreur.

Les versions suivantes de TeamCity sont prises en charge :

TeamCity >= 2021.2 ou ultérieur

Configurer lʼintégration Datadog

Lʼintégration entre TeamCity et Datadog CI Visibility est fournie via un plugin TeamCity. Pour activer lʼintégration :

Téléchargez le plugin de lʼintégration Datadog CI sur le serveur TeamCity en accédant à Administration -> Plugins -> Browse Plugin Repository.
Si vous ne lʼavez pas déjà fait, ajoutez un build composite TeamCity en tant que dernier build de la chaîne de builds. Ce build doit posséder une dépendance sur le dernier build actuel de la chaîne et aucun autre build qui en dépend. Les chaînes de builds dont le dernier build nʼest pas un build composite sont ignorées par le plugin. Vous trouverez ci-dessous un exemple de la chaîne de build qui est attendue, dans laquelle Aggregating Results est le dernier build composite :
Le dernier build composite doit être configuré correctement au niveau des réglages du contrôle de la version, avec la VCS Root jointe et le déclencheur VCS configuré.
Les paramètres de configuration suivants doivent être présents pour les projets TeamCity :
- datadog.ci.api.key : votre clé dʼAPI Datadog.
- datadog.ci.site: .
- datadog.ci.enabled : true (false peut servir à désactiver le plugin pour un projet spécifique).
Ces paramètres de configuration peuvent être ajoutés aux sous-projets TeamCity ou au projet root TeamCity. Une fois quʼils sont ajoutés au projet Root, ils sont propagés dans tous les sous-projets. Par exemple, pour activer le plgin pour tous les projets, ajoutez datadog.ci.enabled avec la valeur true au projet Root. Vous trouverez davantage dʼinformations sur le réglage des paramètres de configuration dans la documentation relative à la hiérarchie des projets TeamCity.
Pour activer le plugin, cliquez sur Enable uploaded plugins sur la page Administration -> Plugins. Vous pouvez aussi redémarrer le serveur TeamCity.

Visualiser des données de pipeline dans Datadog

Consultez vos données sur les pages CI Pipeline List et Executions après la fin des pipelines.

La page CI Pipeline List affiche des données pour la branche par défaut de chaque référentiel.

Configurer des informations dʼutilisateur Git

Le plugin récupère le nom et lʼe-mail de lʼauteur Git en fonction du style de nom dʼutilisateur TeamCity. Datadog recommande dʼutiliser les styles de nom dʼutilisateur Author Name and Email ou Author Email, car ils fournissent des informations sur lʼe-mail de lʼutilisateur. Lorsque lʼun des autres styles de nom dʼutilisateur est utilisé, (UserId ou Author Name), le plugin génère automatiquement un e-mail pour lʼutilisateur en ajoutant @Teamcity au nom dʼutilisateur. Par exemple, si le style de nom dʼutilisateur UserId est utilisé et si le nom dʼutilisateur de lʼauteur Git est john.doe, le plugin génère john.doe@Teamcity comme e-mail de lʼauteur Git. Le style du nom dʼutilisateur est défini pour les roots VCS, et il peut être modifié dans les réglages de la racine VCS.

Remarque : lʼe-mail de lʼauteur Git est utilisé à des fins de facturation. Ainsi, si des styles de nom dʼutilisateur ne fournissant pas dʼe-mail (UserId ou Author Name) sont utilisés, cela peut avoir un impact au niveau des coûts. Contactez lʼéquipe dʼassistance Datadog si vous avez des questions sur votre cas dʼutilisation.

Référentiel de plugin

Le code source du plugin de lʼintégration Datadog/CI est libre sous la licence Apache 2.0.

Dépannage

Tous les logs générés par le plugin Datadog CI Integration sont stockés dans le fichier teamcity-server.log et sont accessibles depuis le serveur TeamCity en allant sur Administration -> Diagnostic -> **Serveur **. accessible depuis le serveur TeamCity en allant sur Administration -> Diagnostic -> Server Logs. Pour obtenir plus d’informations sur les problèmes liés au plugin, veuillez consulter ces logs.