Connecter Sentry
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
- Ouvrez le projet à superviser dans Sentry.
- Notez deux valeurs depuis l’URL :
organization_slug: entrehttps://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
- Dans Sentry, allez dans Settings → Custom Integrations (ou) Settings → Auth Tokens.
- Créez un nouveau token avec uniquement ces scopes :
project:readevent:read
- Copiez le token immédiatement — Sentry ne le réaffichera jamais.
- SaaS : commence par
sntrys_…(org token) ousntryu_…(user token). - Self-hosted : préfixe libre.
- SaaS : commence par
⚠️ Évitez
org:admin,project:writeet 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.