Connecter Cloudflare
StatHall surveille ce que Cloudflare sert pour vous : le dernier déploiement Pages, le trafic d’une zone, et la validité du jeton lui-même. Lecture seule — les permissions demandées ne permettent aucune modification.
Étape 1 — le jeton d’API
- Console Cloudflare → votre profil → API Tokens → Create Token.
- Partez d’un Custom token et n’accordez que de la lecture :
| Portée | Permission | Niveau | Nécessaire pour |
|---|---|---|---|
| Account | Account Analytics | Read | trafic agrégé |
| Account | Cloudflare Pages | Read | état des déploiements |
| Zone | Analytics | Read | trafic d’une zone |
- Limitez le jeton aux comptes et zones concernés, puis créez-le et copiez-le : il n’est affiché qu’une fois.
N’utilisez pas de clé globale d’API (Global API Key) : elle donne tous les droits sur tout le compte et ne peut pas être restreinte.
Étape 2 — désigner ce qu’on surveille
Au moins un des deux, les deux si vous voulez :
- Projet Pages — l’identifiant de compte (
Account ID, visible dans la barre latérale de la console ou dans l’URL) et le nom du projet tel qu’il apparaît dans Workers & Pages. - Zone — le
Zone ID, en bas à droite de la page Overview du domaine.
Sans l’un ni l’autre, le connecteur n’aurait rien à mesurer : le test de connexion le refuse plutôt que de vous laisser croire le contraire.
Ce qui est collecté
| Série | Sens |
|---|---|
cloudflare.token.active | 0 quand le jeton n’est plus accepté |
cloudflare.pages.deploy_failed | 1 quand le dernier déploiement a échoué ou a été annulé |
cloudflare.pages.deploy_age_seconds | âge du dernier déploiement de production |
cloudflare.zone.requests | requêtes servies sur la dernière heure |
cloudflare.zone.bytes | octets servis sur la dernière heure |
Déploiements et jeton sont relevés toutes les dix minutes ; le trafic de zone une fois par heure.
Si le trafic de zone reste vide
Les séries de zone passent par l’API GraphQL d’analytics de Cloudflare.
Vérifiez dans l’ordre : la permission Analytics → Read sur la zone, le
Zone ID (et non le Account ID), et que la zone a bien reçu du trafic
sur la dernière heure. L’absence de ces séries n’empêche ni le suivi des
déploiements ni la surveillance du jeton.
Révoquer
Supprimez le connecteur ici, puis le jeton dans API Tokens.