---
title: "Connecter Sentry"
description: "Crashes et erreurs iOS/Android en temps réel, avec le quota du projet."
lang: fr
canonical: "https://www.stathall.com/docs/connecteur-sentry/"
updated: "2026-09-16"
---

# 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

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.