---
title: "Connecter Supabase"
description: "État d'un projet Supabase et santé de ses services."
lang: fr
canonical: "https://www.stathall.com/docs/connecteur-supabase/"
updated: "2026-09-16"
---

# Connecter Supabase


StatHall lit l'**état d'un projet Supabase** et la santé de ses services.
Lecture seule : aucune donnée de votre base n'est lue, aucune écriture
n'est possible avec ce qui vous est demandé ici.

## Ce que ça apporte

- L'alerte **« projet en pause »**. Un projet du palier gratuit s'endort
  après une période sans trafic : l'application qui vit dessus tombe, et
  rien ne le dit. C'est le premier motif d'installation de ce connecteur.
- L'état service par service : base, authentification, API REST,
  stockage, temps réel.

## Étape 1 — la référence du projet

Ouvrez votre projet dans la console Supabase. La référence est le
fragment de l'URL qui suit `/project/` :

```text
https://supabase.com/dashboard/project/abcdefghijklmnopqrst
                                       └──── la référence ────┘
```

Vous la retrouvez aussi dans **Project Settings → General**.

## Étape 2 — le jeton d'accès personnel

1. Console Supabase → votre avatar → **Account settings**.
2. Onglet **Access tokens** → **Generate new token**.
3. Nommez-le par exemple `stathall-lecture` et copiez-le : il commence
   par `sbp_` et **ne sera plus affiché**.

> Un jeton d'accès personnel porte vos droits sur l'organisation.
> Créez-en un dédié à StatHall pour pouvoir le révoquer seul, sans
> toucher au reste.

## Étape 3 — vérifier

Collez les deux valeurs, cliquez sur **Tester la connexion**. La réponse
nomme le projet et son état — si elle ne le fait pas, rien n'est
enregistré d'utile.

## Ce qui est collecté

| Série | Sens |
|---|---|
| `supabase.project.up` | 1 quand l'état est `ACTIVE_HEALTHY` |
| `supabase.project.paused` | 1 quand le projet est en pause ou inactif |
| `supabase.project.degraded` | 1 sur un état en échec |
| `supabase.service.up` | 1 par service sain (`db`, `auth`, `rest`, `storage`, `realtime`) |

Relevé toutes les dix minutes. Un état inconnu de StatHall est tracé mais
n'alerte pas — Supabase ajoute des états, et une liste figée
transformerait chaque nouveauté en fausse alerte.

## Révoquer

Supprimez le connecteur ici, puis révoquez le jeton depuis
**Account settings → Access tokens**. Les deux gestes sont indépendants :
le second est le seul qui coupe réellement l'accès.
