État de l'installation

Vérifiez que votre traceur Zenovay fonctionne sans avoir à surveiller le globe en temps réel. Le point de terminaison Install Health renvoie un instantané structuré de l'activité récente du traceur, de l'accessibilité de votre site, de la configuration actuelle « sans cookie » et de la collecte de consentement, ainsi qu'une liste d'actions à entreprendre en cas de problème.

Où le trouver

Dans le tableau de bord Zenovay :

1. Ouvrez la page Domaines et cliquez sur votre domaine.
2. Ouvrez Paramètres, puis cliquez sur l'onglet État de l'installation.
3. Le rapport se rafraîchit automatiquement toutes les 30 secondes. Utilisez Actualiser pour forcer une nouvelle vérification.

Lecture de la réponse

Chaque appel renvoie un objet JSON avec les champs suivants :

Couleurs de statut dans le tableau de bord

Les quatre cartes en haut de l'onglet utilisent les seuils suivants :

• Vert — événements reçus au cours des 5 dernières minutes.
• Jaune — événements reçus dans la dernière heure mais pas dans les 5 dernières minutes.
• Rouge — silencieux depuis plus d'une heure, ou aucun événement jamais reçu.

Problèmes fréquents et solutions

Le tableau issues énumère les codes de diagnostic que Zenovay peut renvoyer. Chaque élément porte une severity, un code stable, un message lisible et une fix_url.

Alertes par e-mail (activation par domaine)

Lorsque le diagnostic déclenche une erreur silent_tracker pour votre domaine, Zenovay envoie un e-mail unique au propriétaire du site. Lorsque les événements reprennent, vous recevez un e-mail unique de fin d'alerte. Un seul e-mail maximum par panne — cinq couches de déduplication empêchent le spam :

1. Le cron tourne toutes les 6 heures, pas toutes les minutes.
2. Le seuil silent_tracker lui-même nécessite un écart d'au moins 6 heures.
3. Les sites ayant reçu moins de 5 événements dans les dernières 24 heures ne déclenchent jamais d'alerte (un blog personnel avec une visite par jour ne vous enverra jamais d'e-mail).
4. Une machine à états interne se déclenche uniquement lors d'une transition (sain → silencieux ou silencieux → sain), jamais lors de cycles de cron consécutifs.
5. La clé d'idempotence du journal d'e-mails est ancrée à l'horodatage du premier silence de la panne — même un bug de la machine à états ne peut pas envoyer deux e-mails silencieux par panne.

Les domaines sandbox/développement (localhost, *.vercel.app, *.netlify.app, *.pages.dev, *.workers.dev, *.test, *.local) sont entièrement exclus des alertes.

Activez les alertes par domaine dans Domaine → Paramètres → État de l'installation → Alertes par e-mail. Activé par défaut.

Référence API

Exemple de requête

# L'URL N'A PAS de deux-points initial — remplacez ZV_VOTRE_CODE par
# votre véritable code depuis app.zenovay.com → Domaine → Paramètres.
# Le JWT Bearer est obligatoire ; copiez-le depuis une session de
# tableau de bord connectée via DevTools → Réseau → /api/auth/user.
curl https://api.zenovay.com/api/install-health/ZV_VOTRE_CODE \
-H "Authorization: Bearer $VOTRE_JWT"

Exemple de réponse

{
"last_event_seen_at": "2026-05-02T21:15:42.110Z",
"minutes_since_last_event": 0,
"last_event_count_5m": 12,
"last_event_count_24h": 1843,
"script_reachable": true,
"script_version": "v2.0.1",
"csp_blocking_suspected": false,
"cookieless_enabled": true,
"consent_recording_active": false,
"last_5_event_types": ["pageview", "click", "scroll", "form_submit", "outbound_click"],
"issues": []
}