---
title: "Connecter Cloudflare"
description: "Déploiements Pages, trafic de zone et validité du jeton."
lang: fr
canonical: "https://www.stathall.com/docs/connecteur-cloudflare/"
updated: "2026-09-16"
---

# 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

1. Console Cloudflare → votre profil → **API Tokens** → **Create Token**.
2. 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 |

3. 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**.