> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> Connectez AppSignal à votre projet GitLab pour consulter les sources et lier les révisions, et signaler les déploiements depuis GitLab CI/CD.

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.

<Tip>
  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.
</Tip>

Site web : [https://gitlab.com](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.

<Tip>
  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.
</Tip>

## É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](/application/markers/deploy-markers#gitlab-support) pour l'approche recommandée via l'option de configuration `revision`, ou l'[exemple de l'API Markers](/application/markers/deploy-markers#gitlab-cicd-example) 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`.

<hr />

### Liste des intégrations

* [Asana](/application/integrations/asana)
* [Discord](/application/integrations/discord)
* [Geckoboard](/application/integrations/geckoboard)
* [GitLab](/application/integrations/gitlab)
* [Google Hangouts Chat](/application/integrations/hangouts)
* [Jira](/application/integrations/jira)
* [Linear](/application/integrations/linear)
* [Microsoft Teams](/application/integrations/teams)
* [OpsGenie](/application/integrations/opsgenie)
* [PagerDuty](/application/integrations/pagerduty)
* [Shortcut](/application/integrations/shortcut)
* [Slack](/application/integrations/slack)
* [Squadcast](/application/integrations/squadcast)
* [Trello](/application/integrations/trello)
* [Webhooks](/application/integrations/webhooks)