Documentation

Pages d’état

Une page que vos propres clients peuvent lire, montrant ce qui fonctionne et ce qui ne fonctionne pas, hébergée chez nous pour qu’elle réponde quand votre infrastructure ne répond plus.

En construire une

Créez la page, puis ajoutez-y des composants. Un composant est un moniteur que vous avez choisi de publier, sous un nom que vos clients comprendront — « Checkout » plutôt que prod-api-lb-01. Groupez-les en sections s’il y en a assez pour le justifier.

Ajouter un composant, c’est publier ce moniteur. Son état, son historique et ses incidents deviennent visibles pour quiconque a le lien. Rien d’autre du moniteur n’est exposé — ni l’URL, ni la configuration, ni l’endroit depuis lequel le contrôle a eu lieu — mais le fait qu’il soit en ligne ou hors ligne devient public. C’est le but, et il vaut la peine de choisir délibérément les moniteurs que vous ajoutez.

Vous ne pouvez ajouter que des moniteurs du même espace de travail que la page. Dans un compte d’agence, c’est ce qui empêche le moniteur d’un client d’apparaître sur la page d’un autre.

Où elle vit

Chaque page reçoit immédiatement une adresse sur notre domaine. À partir de Starter, vous pouvez y faire pointer votre propre domaine — status.votreentreprise.fr — et nous nous occupons du certificat.

À partir de Pro, la page peut être en marque blanche : votre logo et vos couleurs, et aucune mention de nous.

Les incidents sur la page

Un incident ouvert par la surveillance apparaît automatiquement. Vous pouvez aussi en publier un à la main pour ce que nous ne voyons pas — un tiers dégradé, une migration planifiée — et le mettre à jour au fil de l’eau. Les mises à jour sont horodatées et conservées, si bien que la page constitue ensuite un compte rendu et pas seulement un instantané pendant.

Une fenêtre de maintenance planifiée est publiée sur la page — son titre, sa description et sa prochaine échéance — dès lors que « afficher sur les pages d’état » est activé, et elle apparaît aussi dans les flux de la page. Les abonnés peuvent être prévenus de son début et de sa fin. Elle retient les alertes tant qu’elle est ouverte, mais elle ne réécrit pas le taux de disponibilité : à moins de désactiver aussi « continuer à vérifier », les vérifications s’exécutent comme d’habitude et comptent comme d’habitude.

Abonnés

Les visiteurs peuvent s’abonner pour être prévenus par e-mail quand quelque chose change. Ils confirment d’abord, et chaque message contient une sortie qui fonctionne sans connexion — le destinataire d’une mise à jour d’état est le client de quelqu’un d’autre, et lui demander de créer un compte pour arrêter du courrier non sollicité est la façon dont une page récolte une plainte pour spam.

Ces adresses sont des données personnelles que vous avez collectées et que nous conservons pour vous. Elles sont à vous : exportez-les ou supprimez-les quand vous le souhaitez.

Pages privées

Définissez un mot de passe et la page le demande avant de montrer quoi que ce soit. Utile pour une page interne ou partagée avec un seul client dans le cadre d’un accord.

Le déverrouillage est mémorisé dans un cookie propre à cette page, si bien qu’en déverrouiller une n’en déverrouille pas une autre — et un visiteur qui a déverrouillé une page reçoit toujours la version en direct plutôt qu’une copie mise en cache.

Ce que nous ne montrons délibérément pas

Nulle part sur une page d’état nous ne nommons l’endroit depuis lequel un contrôle a eu lieu. Ni sur la page, ni dans un incident, ni dans l’API. L’endroit où un contrôle s’exécute nous appartient et nous pouvons le changer — les sondes se déplacent entre hôtes et emplacements — un code de région devant vos clients est donc une affirmation sur notre infrastructure qui vieillit sans que personne le remarque, et dont ils ne pourraient rien faire.

Flux

Toute page publique publie ses incidents sous forme de flux, dans les deux formats que les lecteurs comprennent : /feed.xml pour RSS et /atom.xml pour Atom, chacun à côté de l’adresse de la page elle-même. Les deux sont liés depuis la page, la plupart des lecteurs les trouvent donc à partir de la seule URL.

Un flux, c’est la façon de vous suivre sans donner d’adresse e-mail. Il porte exactement ce que porte la page — les incidents des trente derniers jours, les mises à jour que vous avez marquées publiques et les fenêtres de maintenance que vous avez choisi de publier — et rien d’autre : aucune note interne, aucun post-mortem, et rien sur l’endroit d’où un contrôle a eu lieu.

Une page protégée par mot de passe ou restreinte ne sert aucun flux. On ne peut pas demander un mot de passe à un lecteur de flux : un flux y serait un moyen de contourner la protection plutôt qu’une fonctionnalité.

Rapidité et disponibilité

Les pages d’état sont mises en cache à la périphérie et servies depuis une copie qui survit à la panne de notre propre origine. C’est toute la raison d’héberger une page d’état ailleurs que sur ce dont elle rend compte : une page injoignable pendant exactement la panne pour laquelle on la consulte a échoué à sa seule mission.