Moniteurs de disponibilité

Un moniteur surveille un site web ou une API pour vous. Donnez une URL à Zenhook et nous la vérifions toutes les 5 minutes depuis l'extérieur de votre propre infrastructure, puis nous vous alertons dès qu'elle cesse de répondre.

Moniteurs et webhooks

Ce sont les deux directions opposées dans lesquelles Zenhook fonctionne, et il est facile de les confondre :

  • Canaux (webhooks) : votre application appelle Zenhook. Vous envoyez un webhook en POST vers l'URL d'un canal et Zenhook le transforme en alerte.
  • Moniteurs (disponibilité) : Zenhook appelle votre site. Vous nous donnez une URL et nous l'interrogeons selon une planification, en vous alertant lorsqu'elle devient indisponible ou se rétablit.

Un moniteur n'est donc pas un autre webhook. Vous ne nous envoyez rien, vous collez simplement l'adresse que vous voulez surveiller.

Ajouter un moniteur

1. Ouvrez Moniteurs. Dans l'application, allez dans l'onglet Moniteurs et appuyez sur +.

2. Collez l'URL. Saisissez l'adresse que vous voulez surveiller, par exemple https://example.com ou un endpoint de santé comme https://api.example.com/health.

3. (Facultatif) Ajoutez un mot-clé. Indiquez un mot ou une expression qui doit apparaître dans la réponse. Si la page se charge mais que le mot-clé est absent, le moniteur est considéré comme indisponible, utile pour détecter les pages d'erreur qui renvoient quand même un 200 OK.

4. Enregistrez. Zenhook commence à vérifier immédiatement et affiche le statut actuel, le dernier temps de réponse et l'historique récent des vérifications.

Comment fonctionnent les vérifications

Chaque moniteur est interrogé toutes les 5 minutes, avec un délai d'attente de 10 secondes. Une vérification réussit lorsque l'URL répond avec un statut HTTP compris entre 200 et 399 (les redirections sont suivies) et qu'elle contient votre mot-clé, si vous en avez défini un.

Un échec isolé ne vous réveille jamais. Quand une vérification échoue, Zenhook refait un essai 30 secondes plus tard, et demande à un point d'observation indépendant, sur un autre réseau avec son propre résolveur DNS, s'il joint encore le site. Un moniteur ne bascule en indisponible qu'une fois l'échec confirmé et ce second avis ne parvenant pas non plus à le joindre. Le retour est l'inverse : la première vérification réussie le repasse aussitôt en disponible.

En pratique, une vraie panne est confirmée environ 30 secondes après la première vérification en échec, donc vous l'apprenez au maximum 5 minutes et demie après que votre site est réellement tombé.

Lorsque le statut change, de disponible à indisponible, ou inversement, Zenhook envoie une alerte via vos canaux de notification (son, bureau, push et e-mail), de la même manière que les alertes de canal sont délivrées.

Un 200 ne veut pas dire disponible

Beaucoup de pannes répondent avec un code de statut en parfaite santé. Zenhook lit la réponse, pas seulement son numéro, et considère ceci comme indisponible :

  • Les pages d'erreur de CDN servies en 200 : bad gateway, service indisponible, origine injoignable, échec de négociation SSL, et le reste du mur de texte habituel.
  • Le cache périmé : votre CDN sert une copie en cache parce qu'il n'atteint plus votre origine. Le visiteur voit un site, mais le site est tombé.
  • Les pages de défi anti-bot : un CAPTCHA n'est pas votre contenu.
  • Un mot-clé absent : si vous en avez défini un et qu'il disparaît de la page, la vérification échoue.

FAQ

Vérifiez-vous depuis plusieurs endroits à la fois ?

Pas à chaque vérification, et ce n'est pas un vote. La vérification planifiée part d'un seul endroit. Un second point d'observation indépendant n'est consulté qu'en cas d'échec, et il dispose d'un droit de veto : s'il joint encore votre site, la panne est considérée comme la nôtre et vous n'êtes pas alerté. Nous n'alertons que si personne ne vous joint. Cette asymétrie est volontaire : l'erreur coûteuse, c'est de vous réveiller à 3h du matin pour un site qui fonctionnait.

Puis-je changer l'intervalle de vérification ?

Pas aujourd'hui. Chaque moniteur est vérifié toutes les 5 minutes, le même rythme pour tout le monde, sur tous les forfaits. Si vous avez besoin d'un autre intervalle, dites-nous pour quel usage.

Pourquoi vois-je un paramètre _zenhook dans mes logs ?

C'est nous. Chaque vérification ajoute une valeur _zenhook unique pour qu'aucun cache, le nôtre ou le vôtre, ne réponde à la place de votre serveur. Un moniteur qui tape dans un cache ne surveille rien.

Comment autoriser Zenhook dans mon pare-feu ou mon WAF ?

Les vérifications s'identifient avec l'agent utilisateur Zenhook Uptime Monitor/1.0. Si votre WAF le bloque ou lui sert un défi, le moniteur affichera indisponible alors que votre site va bien.

Puis-je surveiller localhost ou une adresse privée ?

Non. Zenhook vérifie depuis l'extérieur de votre infrastructure, donc localhost et les adresses de réseau privé sont refusés. Surveillez une URL publique, ou exposez un point de santé que vous acceptez de rendre joignable.

Pourquoi Vérifications récentes affiche moins de lignes que prévu ?

La liste montre les vérifications les plus récentes en premier, les statistiques couvrent les dernières 24 heures, et l'historique détaillé est conservé 7 jours.

Vais-je recevoir quarante alertes si c'est Zenhook qui casse ?

Non. Quand une part inhabituelle des moniteurs échoue dans le même cycle, la cause n'est presque jamais que tous ces sites sans rapport sont tombés en même temps : Zenhook supprime ces alertes, laisse les statuts intacts, et nous remonte le problème à nous plutôt qu'à vous.

Limites des forfaits

Le forfait gratuit inclut 3 moniteurs. Pro porte ce nombre à 20 moniteurs.

Vous ne recevez pas les alertes de moniteur ? Consultez le dépannage des notifications