Passer au contenu principal
Des outils pour les développeurs modernes. GitLab unifie les tickets, la revue de code, l’intégration continue et le déploiement continu dans une seule interface. L’intégration GitLab relie AppSignal à votre dépôt GitLab (voir la source d’une exception, ouvrir un commit, etc.). Il s’agit d’une intégration personnelle : chaque utilisateur qui souhaite l’utiliser doit suivre ces étapes pour lui-même, sur chaque application AppSignal.
GitLab ne propose pas d’intégration AppSignal en un clic côté GitLab. La configuration ci-dessous utilise un jeton d’accès personnel GitLab, ce qui est officiellement pris en charge sur GitLab.com, GitLab Self-Managed et GitLab Dedicated. Cette intégration ne crée pas automatiquement de tickets sur GitLab, afin d’éviter une surcharge de tickets.
Site web : https://gitlab.com

Étape 1. Créer un jeton d’accès personnel GitLab

  1. Connectez-vous à GitLab et accédez à vos Settings utilisateur.
  2. Dans la barre latérale gauche, sélectionnez Access tokens (https://gitlab.com/-/user_settings/personal_access_tokens sur GitLab.com).
  3. Sélectionnez Add new token et renseignez :
    • Token name : AppSignal
    • Expiration date : choisissez une date qui correspond à la politique de votre organisation.
    • Scopes : sélectionnez les scopes minimaux dont AppSignal a besoin pour lire votre projet :
      • read_api — accès en lecture seule à l’API GitLab (métadonnées de projet, commits, fichiers).
      • read_repository — accès en lecture seule au contenu du dépôt via Git/HTTP.
  4. Sélectionnez Create personal access token et copiez immédiatement le jeton. GitLab ne l’affiche qu’une seule fois.
Utilisez read_api + read_repository plutôt que le scope global api. AppSignal n’a besoin que de lire les informations du projet, pas d’y écrire.

Étape 2. Ajouter l’intégration dans AppSignal

  1. Dans AppSignal, ouvrez l’application que vous souhaitez connecter.
  2. Allez dans App settings → Integrations → GitLab.
  3. Renseignez le formulaire :
    • Token : collez le jeton d’accès personnel que vous avez créé à l’étape 1.
    • GitLab URL : l’URL complète vers le projet GitLab, par exemple https://gitlab.com/your-namespace/your-project. Pour GitLab self-managed, utilisez le hostname de votre instance, par exemple https://gitlab.example.com/your-group/your-project.
  4. Sélectionnez create integration.
Vous pouvez revenir sur cette page à tout moment pour update integration ou remove integration.

Étape 3. Répétez pour chaque utilisateur

Comme il s’agit d’une intégration personnelle, chaque membre de l’équipe qui souhaite que les liens de source se résolvent dans son compte AppSignal doit répéter les étapes 1 et 2 avec son propre jeton GitLab.

Marqueurs de déploiement depuis GitLab CI/CD

Pour signaler les déploiements à AppSignal depuis un pipeline GitLab CI/CD, consultez la documentation sur les marqueurs de déploiement pour l’approche recommandée via l’option de configuration revision, ou l’exemple de l’API Markers si votre stack n’inclut pas d’intégration AppSignal.

Dépannage

Les liens de source dans AppSignal n’ouvrent pas le bon fichier. Rouvrez App settings → Integrations → GitLab dans AppSignal et confirmez que l’URL GitLab pointe vers la racine du projet (par exemple https://gitlab.com/namespace/project) et non vers un sous-chemin, une branche ou une URL .git.

Liste des intégrations