Suivi des erreurs Sentry

{{< details >}}

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

{{< /details >}}

Sentry est un système de suivi des erreurs open source. GitLab permet aux administrateurs de connecter Sentry à GitLab, afin que les utilisateurs puissent consulter une liste des erreurs Sentry dans GitLab.

GitLab s'intègre à la fois avec Sentry hébergé dans le cloud et avec Sentry déployé dans votre instance on-premise.

Activer l'intégration Sentry pour un projet {#enable-sentry-integration-for-a-project}

GitLab fournit un moyen de connecter Sentry à votre projet.

Prérequis :

• Disposer du rôle Chargé de maintenance ou Propriétaire pour le projet.

Pour activer l'intégration Sentry :

1. Inscrivez-vous sur Sentry.io ou déployez votre propre instance Sentry on-premise.
2. Créez un nouveau projet Sentry. Pour chaque projet GitLab que vous souhaitez intégrer, créez un nouveau projet Sentry.
3. Trouvez ou générez un jeton d'authentification Sentry. Pour la version SaaS de Sentry, vous pouvez trouver ou générer le jeton d'authentification à l'adresse https://sentry.io/api/. Accordez au jeton au minimum les portées suivantes : project:read, event:read et event:write (pour la résolution des événements).
4. Dans GitLab, activez et configurez le suivi des erreurs :
   1. Dans la barre supérieure, sélectionnez Rechercher ou accéder à et trouvez votre projet.
   2. Sélectionnez Paramètres > Supervision, puis développez Suivi des erreurs.
   3. Pour Activer le suivi d'erreur, sélectionnez Actif.
   4. Pour Backend du suivi des erreurs, sélectionnez Sentry.
   5. Pour URL de l'API Sentry, saisissez le nom d'hôte de votre instance Sentry. Par exemple, saisissez https://sentry.example.com. Pour la version SaaS de Sentry, le nom d'hôte est https://sentry.io. Pour la version SaaS de Sentry hébergée dans l'UE, le nom d'hôte est https://de.sentry.io.
   6. Pour Jeton d'authentification, saisissez le jeton que vous avez généré précédemment.
   7. Pour tester la connexion à Sentry et remplir la liste déroulante Projet, sélectionnez Connecter.
   8. Dans la liste Projet, choisissez un projet Sentry à lier à votre projet GitLab.
   9. Sélectionnez Enregistrer les modifications.

Pour afficher la liste des erreurs Sentry, dans la barre latérale de votre projet, accédez à Supervision > Suivi des erreurs.

Activer l'intégration GitLab de Sentry {#enable-sentrys-integration-with-gitlab}

Vous pouvez également activer l'intégration GitLab de Sentry en suivant les étapes décrites dans la documentation Sentry.

Dépannage {#troubleshooting}

Lorsque vous utilisez le suivi des erreurs, vous pouvez rencontrer les problèmes suivants.

Erreur Connection failed. Check auth token and try again {#error-connection-failed-check-auth-token-and-try-again}

Si la fonctionnalité Supervision est désactivée dans les paramètres du projet, une erreur peut s'afficher lorsque vous tentez d'activer l'intégration Sentry pour un projet. La requête résultante vers /project/path/-/error_tracking/projects.json?api_host=https:%2F%2Fsentry.example.com%2F&token=<token> renvoie une erreur 404.

Pour résoudre ce problème, activez la fonctionnalité Supervision pour le projet.

Erreur Connection has failed. Re-check Auth Token and try again {#error-connection-has-failed-re-check-auth-token-and-try-again}

Les intégrations Sentry on-premise peuvent rencontrer ce problème lors de la tentative de connexion.

Prérequis :

• Disposer d'un accès administrateur.

Pour résoudre ce problème :

1. Dans le coin supérieur droit, sélectionnez Admin.
2. Dans la barre latérale gauche, sélectionnez Paramètres > Réseau.
3. Développez Requêtes sortantes.
4. Cochez les cases Autoriser les requêtes vers le réseau local des crochets Web et des intégrations et Autoriser les requêtes vers le réseau local depuis les crochets système.
5. Sélectionnez Enregistrer les modifications.