Paramètres
Bien démarrer
- Chargement…
Ajouter un site
- Ajoutez cette balise dans le
<head>de toutes les pages du site (thème, gabarit ou gestionnaire de balises) : - Objectifs proposés (à cocher, modifiables ensuite) :
Vérifier l’installation
Lit la page d’accueil de chaque site pour y trouver la balise du traceur et vérifier son data-site, avec la date de la dernière visite reçue. Une balise ajoutée par un gestionnaire de balises n’apparaît pas dans la page : la dernière visite reçue fait alors foi. Pour voir ce que le traceur enverrait depuis votre navigateur, ouvrez le site avec ?zstats=debug et regardez la console (rien n’est envoyé).
Alertes en place
Chargement…
Ajouter une alerte
Les alertes sont vérifiées toutes les 5 minutes. Un message part quand l’alerte se déclenche, et un autre quand la situation redevient normale : pas de message répété entre les deux.
Résumé de la semaine
Le lundi matin, sur la messagerie (Telegram, Slack, Discord, Mattermost et les appareils qui reçoivent « tout ») : visiteurs de la semaine écoulée et évolution, page la plus vue, nouvelle provenance, objectif le plus atteint, pour chaque site.
Recevoir les alertes sur Telegram
Créer le bot
- Ouvrez Telegram et écrivez à @BotFather (nouvelle fenêtre), le bot officiel qui crée les bots.
- Envoyez-lui
/newbot. - Choisissez un nom (par exemple « Alertes zstats »), puis un identifiant qui se termine par « bot » (par exemple
zstats_alertes_bot). - BotFather répond avec un jeton de la forme
123456789:AA…: copiez-le ci-dessous.
Choisir qui reçoit les alertes
Enregistrez d’abord le jeton du bot (étape 1).
- Pour vous : ouvrez votre bot dans Telegram et appuyez sur « Démarrer » (ou envoyez-lui n’importe quel message).
- Pour un groupe : ajoutez le bot au groupe, puis écrivez un message dans le groupe.
- Puis appuyez sur « Rechercher les conversations » et cochez celles qui doivent recevoir les alertes.
Ajouter un canal ou un identifiant à la main
Pour un canal : ajoutez le bot comme administrateur du canal, puis saisissez son identifiant public (@nom_du_canal). Un identifiant numérique (par exemple -1001234567890) convient aussi.
Tester
Choisissez d’abord au moins un destinataire (étape 2).
Interroger le bot
Dans une conversation autorisée (étape 2), écrivez au bot :
/stats— aujourd’hui, comparé à hier à la même heure/hier— la journée d’hier, comparée à avant-hier/semaine— les 7 derniers jours, comparés aux 7 précédents/live— les visiteurs en ce moment/note site.fr Newsletter envoyée— ajoute une annotation du jour (/note tous …pour tous les projets)- Ajoutez un site pour ne voir que lui :
/stats debunkons.fr,/live gazascale.org
Le bot ne répond qu’aux conversations autorisées ; une autre conversation reçoit seulement son identifiant, à ajouter ici si vous le souhaitez. Les rapports et les alertes peuvent aussi être envoyés sur Telegram (onglets Rapports et Alertes).
Le jeton est gardé sur le serveur, hors de la base de données ; il n’est jamais réaffiché en entier.
Slack, Discord ou Mattermost
Les alertes, rapports et pannes cochés « messagerie » partent aussi vers ces canaux. Créez un webhook entrant dans le service (Slack : application « Incoming Webhooks » ; Discord : Paramètres du salon › Intégrations › Webhooks ; Mattermost : Intégrations › Webhooks entrants), puis collez son adresse ici.
L’adresse contient un secret : elle est gardée sur le serveur, hors de la base, et n’est jamais réaffichée en entier. Sont envoyés le nom du site, des nombres et des adresses de pages ou de sites d’origine, jamais de donnée sur un visiteur ; ces textes, qui viennent des sites suivis, ne peuvent former ni lien ni mention (@channel).
Serveur d’envoi des e-mails (SMTP)
Infomaniak : serveur mail.infomaniak.com, port 465 (TLS direct), identifiant = adresse e-mail complète, mot de passe de cette adresse.
Tester l’envoi
Rapports par e-mail
Chargement…
Ajouter un rapport
Sauvegardes
Chargement…
Une copie compressée de toute la base est faite automatiquement chaque jour ; les plus récentes sont gardées sur le serveur. Pour en avoir une copie ailleurs, configurez la copie hors du serveur ci-dessous (ou téléchargez-en une de temps en temps). Chaque semaine, la plus récente (et la plus récente hors serveur) est ouverte et relue pour s’assurer qu’elle se restaurerait ; un échec apparaît dans la santé du serveur et déclenche l’alerte « Santé du serveur ».
La place libérée par les visites plus anciennes que la durée de conservation est réutilisée par la base ; une fois par mois, vers 4 h du matin, elle est rendue au disque s’il y en a assez (15 % et 50 Mo au moins). « Compacter la base » le fait tout de suite : le serveur ne répond plus pendant quelques secondes à quelques dizaines de secondes (les visites reçues entre-temps sont comptées après).
Restaurer une sauvegarde
Remet toute la base dans l’état de la sauvegarde choisie : visites, objectifs, parcours, annotations, alertes et rapports. Les visites reçues depuis sont perdues. Juste avant, une copie de sécurité de l’état actuel est faite (« avant restauration » dans la liste ci-dessus) : restaurez-la pour revenir en arrière. Les réglages (e-mail, Telegram, stockage, exclusions…), les accès nommés, les liens de partage et le journal d’activité restent tels qu’ils sont aujourd’hui (un accès révoqué depuis la sauvegarde le reste).
Copie hors du serveur
Chaque sauvegarde quotidienne est aussitôt envoyée vers un stockage compatible S3 (Infomaniak Object Storage ou Swiss Backup, Scaleway, OVHcloud, AWS…) ; seules les plus récentes y sont gardées. En cas d’échec, nouvel essai toutes les heures.
Chiffrement (conseillé) : avec une phrase de passe, la copie est chiffrée (AES-256) avant de quitter le serveur ; le fournisseur du stockage ne peut pas la lire. Notez cette phrase ailleurs : sans elle, les copies sont illisibles. Les copies hors serveur apparaissent dans « Restaurer une sauvegarde » (déchiffrées avec la phrase enregistrée) ; à la main : node scripts/decrypt-backup.mjs zstats-AAAA-MM-JJ.db.gz.enc.
Créez de préférence une clé limitée à ce seul compartiment. La clé secrète et la phrase de passe restent sur le serveur, hors de la base, et ne sont jamais réaffichées.
Accès nommés
Chargement…
Vos téléphones
Appareils connectés par « Plus › Ouvrir sur mon téléphone » du tableau de bord : chacun a son accès, valable 90 jours.
Chargement…
Créer un accès
- Lecture seule : le tableau de bord complet (statistiques, temps réel, exports CSV), sans rien pouvoir modifier ni ouvrir les paramètres.
- Administration : comme le jeton principal (
ADMIN_TOKEN), mais révocable séparément. - Annotations automatiques : peut seulement ajouter une annotation ; à donner à un outil de déploiement.
Pour interroger zstats depuis un script ou un autre outil : documentation de l’API (exemples prêts à copier).
Chaque personne saisit son jeton à la place de ADMIN_TOKEN sur la page de connexion. Seule une empreinte du jeton est gardée sur le serveur ; révoquer un accès le coupe immédiatement.
Annotations automatiques à chaque mise en ligne
Pour relier un changement de trafic à une nouvelle version d’un site : à chaque déploiement, une annotation (◆ sur le graphique) est ajoutée automatiquement.
- Créez ci-dessus un accès « Annotations automatiques » et copiez le jeton.
- Dans le dépôt GitHub du site : Settings › Secrets and variables › Actions › New repository secret, nom
ZSTATS_TOKEN, valeur = le jeton. - Ajoutez cette étape à la fin du workflow de déploiement (remplacez le site) :
Le jour est celui de la mise en ligne (heure de Paris) ; le texte reprend le début du message du dernier commit. Toute autre plateforme peut faire de même : une requête POST /api/annotations?site=… avec l’en-tête Authorization: Bearer … et le corps {"text": "…"}.
Créer un lien
La personne qui ouvre le lien voit le tableau de bord de ce site (ou de cette seule rubrique) : chiffres, graphique, tableaux, objectifs, annotations, temps réel et exports CSV des tableaux. Elle ne voit ni les autres sites, ni les paramètres, ni les dernières actions détaillées (codes visiteurs, IP tronquées), et ne peut rien modifier.
Toute personne qui a le lien peut voir ces statistiques : ne le publiez pas. Seule une empreinte du lien est gardée sur le serveur ; un lien perdu ne peut pas être réaffiché, mais vous pouvez en créer un autre. Révoquer un lien le coupe immédiatement.
Historique importé
Chargement…
Importer un historique
Depuis Plausible : Paramètres du site › Imports & Exports › Export CSV, puis envoyez ici l’archive .zip reçue, telle quelle. Sont repris, jour par jour : visiteurs, pages vues, visites et rebonds, pages, pages d’entrée et de sortie, sources, campagnes, pays, appareils, navigateurs et systèmes.
Depuis un autre outil (Google Analytics, Matomo, tableur…) : un fichier CSV avec une ligne par jour et au moins les colonnes date, visiteurs et pages vues (ou date, visitors, pageviews) ; visites et rebonds sont facultatives. Dates au format 2025-01-31 ou 31/01/2025.
Seuls les jours avant les premières visites mesurées par zstats sont importés, pour ne jamais compter deux fois les mêmes visites. Importer de nouveau remplace les jours contenus dans le fichier. L’historique importé apparaît dans les statistiques du site (sans rubrique ni filtre : il n’a pas le détail par visiteur) ; il ne contient que des totaux par jour, aucune donnée personnelle.
Ne pas compter mes visites
Chargement…
Les visites venant de ces adresses (vous, votre équipe, vos tests) ne sont plus comptées, sur tous les sites, à partir de maintenant ; les visites déjà enregistrées restent, sauf si vous les retirez (réseaux entièrement compris dans une plage exclue ; les totaux concernés sont recalculés). Rien n’est déposé chez les visiteurs : l’exclusion se fait sur le serveur, d’après l’adresse IP.
« Mon réseau actuel » exclut le réseau de votre connexion (les 3 premiers nombres de l’adresse en IPv4, les 3 premiers groupes en IPv6) : quelques voisins du même fournisseur peuvent aussi être exclus. En 4G/5G ou en déplacement, l’adresse change : ajoutez alors le nouveau réseau.
Ne pas compter cet appareil (téléphone, VPN…)
Chargement…
Ouvrez « Ne plus compter » sur chaque appareil et chaque navigateur que vous utilisez (ordinateur, téléphone…) : ce navigateur n’est plus compté sur ce site, même en 4G/5G ou derrière un VPN, jusqu’à « Compter de nouveau ». Le site affiche un message de confirmation. Seule une marque zstats_ignore est gardée dans ce navigateur, pour ce site ; elle disparaît si vous effacez les données du site. Vous pouvez aussi ajouter ?zstats=ignore à n’importe quelle adresse du site.
Faux sites d’origine (spam)
Chargement…
Des robots envoient de fausses visites dont l’« origine » est un site publicitaire, pour qu’on aille le visiter. Les visites venant d’un domaine de la liste (et de ses sous-domaines) ne sont pas comptées. « Nettoyer » supprime les visites déjà enregistrées depuis ces domaines (toutes les actions de ces visiteurs ce jour-là).
Sites suivis
Chargement…
« Silencieux » : aucune visite reçue depuis plus de 24 h. « Vérifier » lit la page d’accueil du site pour y trouver la balise du traceur et son data-site.
Fusionner deux sites
Par exemple www.site.fr dans site.fr : visites, objectifs, parcours, annotations, alertes, liens de partage et historique importé passent au second site. Avec la redirection, les visites qui arrivent encore sous l’ancien nom sont comptées sur le nouveau. Un même visiteur venu le même jour sous les deux noms peut compter deux fois ce jour-là.
Configuration d’un site
Fichier JSON avec les objectifs, parcours, alertes propres au site et liens de campagne : pour copier la configuration d’un site vers un autre (même un site qui n’a pas encore de visites), ou la garder dans un dépôt Git. L’import ajoute ce qui manque, sans doublon ni suppression ; les alertes d’objectif retrouvent l’objectif du même nom. Le fichier contient les adresses e-mail des alertes. API : GET|POST /api/config?site=.
Supprimer un site
Supprime toutes les données du site : visites, objectifs, parcours, annotations, alertes, liens de partage, totaux et historique importé ; il est retiré des rapports. Les sauvegardes déjà faites le contiennent encore. Pour qu’un site ne revienne pas, limitez les sites acceptés avec la variable SITES.
Adresses surveillées
Chargement…
Surveiller une adresse
L’adresse est interrogée toutes les 5 minutes (délai de 10 s). Après 2 échecs de suite (erreur HTTP, délai dépassé, serveur injoignable), un message part par e-mail et/ou Telegram ; un autre au retour en ligne, avec la durée de la panne. Disponibilité = part des vérifications réussies ; historique gardé 90 jours. Les adresses du réseau interne ne sont pas acceptées.
Recherche Google (Search Console)
- Sur console.cloud.google.com, créez un projet (par exemple « zstats »), puis activez l’API Google Search Console API (menu API et services › Bibliothèque).
- API et services › Identifiants › Créer des identifiants › Compte de service (aucun rôle nécessaire). Ouvrez-le, onglet Clés › Ajouter une clé › JSON : un fichier se télécharge.
- Choisissez ce fichier ci-dessous : il est lu par votre navigateur et envoyé seulement à votre serveur zstats.
- Sur search.google.com/search-console, pour chaque site : Paramètres › Utilisateurs et autorisations › Ajouter un utilisateur, avec l’adresse du compte de service (affichée ici une fois la clé enregistrée), autorisation « Restreint ».
Le bloc « Recherche Google » du tableau de bord montre ensuite, pour la période choisie, les requêtes tapées dans Google qui mènent au site (clics, impressions, taux de clic, position moyenne) et les pages qui apparaissent dans les résultats. Google publie ces chiffres avec 2 à 3 jours de retard. La clé reste sur le serveur, hors de la base, et n’est jamais réaffichée ; l’accès est en lecture seule.
Texte de confidentialité
À coller dans la politique de confidentialité de chaque site suivi (nLPD / RGPD). Il décrit ce que zstats mesure avec les réglages actuels de ce serveur (durée de conservation, localisation, copie des sauvegardes). Complétez le responsable du site entre crochets et faites-le relire si besoin : ce n’est pas un avis juridique.
Journal d’activité
Chargement…
Chaque modification (objectifs, alertes, paramètres, accès, liens de partage, sites…) avec l’accès utilisé : jeton principal ou nom de l’accès nommé, et l’adresse IP tronquée. Les consultations ne sont pas notées. Gardé 400 jours.