Connecter Sentry

Mis à jour le

StatHall lit en lecture seule les issues et les sessions de votre projet Sentry pour alimenter la partie technique du dashboard (crash-free, release health, anomalies).

Aucune écriture côté Sentry. Aucune notification sortante. La clé sert uniquement à interroger l’API.

Avant de commencer

Pré-requis Détail
Compte Sentry SaaS (*.sentry.io) ou self-hosted ≥ v23
Rôle minimal Member suffit. Préférez un compte de service / Integration Token plutôt qu’un token personnel humain.
Infos à récupérer organization_slug et project_slug (extraits de l’URL du projet)

Exemple : pour https://acme.sentry.io/projects/mobile-ios/ → organization_slug = acme, project_slug = mobile-ios.

Étape 1 — Récupérer les slugs

  1. Ouvrez le projet à superviser dans Sentry.
  2. Notez deux valeurs depuis l’URL :
    • organization_slug : entre https:// et .sentry.io/ (ou la racine de votre instance self-hosted).
    • project_slug : segment qui suit /projects/.

Étape 2 — Générer un token d’API

  1. Dans Sentry, allez dans Settings → Custom Integrations (ou) Settings → Auth Tokens.
  2. Créez un nouveau token avec uniquement ces scopes :
    • project:read
    • event:read
  3. Copiez le token immédiatement — Sentry ne le réaffichera jamais.
    • SaaS : commence par sntrys_… (org token) ou sntryu_… (user token).
    • Self-hosted : préfixe libre.

⚠️ Évitez org:admin, project:write et autres scopes en écriture. StatHall fonctionne en lecture seule.

Étape 3 — Saisir dans StatHall

Dans l’app, ouvrez Sources → Sentry et renseignez :

Champ Valeur
Organization slug étape 1
Project slug étape 1
API token étape 2 (sntrys_…)

Cliquez sur Tester la connexion. Si le test passe, Enregistrer. La première sync démarre dans la foulée.

Dépannage

Erreur Cause probable Action
401 Unauthorized Token invalide ou expiré Régénérer le token (étape 2)
403 Forbidden Scopes insuffisants Ajouter project:read + event:read
404 Not Found Mauvais slug (casse comprise) Re-vérifier dans l’URL Sentry
429 Too Many Requests Rate limit Sentry StatHall relance avec backoff. Réduire la fréquence si récurrent.

Bonus — auto-monitoring

Si vous voulez aussi remonter les erreurs de StatHall lui-même dans Sentry, configurez SENTRY_DSN_SELF dans .env. Ce DSN est distinct des tokens de lecture utilisés ici.