Datadog

{{< details >}}

• Édition : Gratuite, GitLab Premium, GitLab Ultimate
• Offre : GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

L'intégration Datadog vous permet de connecter vos projets GitLab à Datadog, en synchronisant les métadonnées du dépôt pour enrichir votre télémétrie Datadog, permettre à Datadog de commenter les merge requests et envoyer les informations sur les pipelines CI/CD et les jobs à Datadog.

Connecter votre compte Datadog {#connect-your-datadog-account}

Les utilisateurs disposant du rôle Administrateur peuvent configurer l'intégration pour l'instance entière ou pour un projet ou groupe spécifique :

1. Si vous ne disposez pas d'une clé d'API Datadog :
   1. Connectez-vous à Datadog.
   2. Accédez à la section Intégrations.
   3. Générez une clé d'API dans l'onglet APIs. Copiez cette valeur, car vous en aurez besoin lors d'une étape ultérieure.
2. Pour les intégrations pour un projet ou un groupe spécifique : Dans GitLab, accédez à votre projet ou groupe.
3. Pour les intégrations pour l'instance entière :
   1. Connectez-vous à GitLab en tant qu'utilisateur disposant d'un accès administrateur.
   2. dans le coin supérieur droit, sélectionnez Admin.
4. Dans la barre latérale gauche, sélectionnez Paramètres > Intégrations.
5. Faites défiler jusqu'à Ajouter une intégration, puis sélectionnez Datadog.
6. Sélectionnez Actif pour activer l'intégration.
7. Spécifiez le Datadog site vers lequel envoyer les données.
8. Facultatif. Pour remplacer l'URL de l'API utilisée pour envoyer les données directement, fournissez une URL de l'API. Utilisé uniquement dans les scénarios avancés.
9. Fournissez votre Clé de l'API Datadog.

Configurer CI Visibility {#configure-ci-visibility}

Vous pouvez activer Datadog CI Visibility pour envoyer les données de pipeline CI/CD et de job à Datadog. Utilisez cette fonctionnalité pour surveiller et résoudre les échecs de job et les problèmes de performance.

Pour plus d'informations, consultez la documentation Datadog CI Visibility.

[!warning] Datadog CI Visibility est facturé par committer. L'utilisation de cette fonctionnalité peut affecter votre facture Datadog. Pour plus de détails, consultez la page de tarification Datadog.

Cette fonctionnalité est basée sur les webhooks (Webhooks) et ne nécessite qu'une configuration dans GitLab :

1. Facultatif. Sélectionnez Activer la collecte des journaux de jobs du pipeline pour activer la collecte des job logs pour la sortie des jobs. (Introduit dans GitLab 15.3.)
2. Facultatif. Si vous utilisez plusieurs instances GitLab, fournissez un nom de Service unique pour différencier vos instances GitLab. <!-- vale gitlab_base.Spelling = NO -->
3. Facultatif. Si vous utilisez des groupes d'instances GitLab (comme les environnements de staging et de production), fournissez un nom d'Env. Cette valeur est associée à chaque span que l'intégration génère. <!-- vale gitlab_base.Spelling = YES -->
4. Facultatif. Pour définir des étiquettes personnalisées pour tous les spans auxquels l'intégration est configurée, saisissez une étiquette par ligne dans Étiquettes. Chaque ligne doit être au format key:value.
5. Facultatif. Sélectionnez Tester les paramètres.
6. Sélectionnez Enregistrer les modifications.

Lorsque l'intégration envoie des données, vous pouvez les consulter dans la section CI Visibility de votre compte Datadog.

Sujets connexes {#related-topics}

• Documentation Datadog CI Visibility