Aller au contenu principal
Version : 0.4 · actuelle

Configurer la page d'état publique

Guide pratiqueRévisé le 11 octobre 2026
S'applique à :Excubius 0.4Rôles : Administrateur d'entité
PlansFree · Core · Pro · EnterpriseDéploiementAuto-hébergé

Chaque entité peut publier une page d'état pour des personnes sans compte : les clients finaux d'un client, le personnel d'une branche, un partenaire. Elle répond à une seule question, le service que j'utilise fonctionne-t-il ?, au nom, avec le logo et les couleurs de l'entité. Ce guide montre comment créer la page, construire ses composants, publier des incidents et la mettre en ligne.

Avant de commencer​

  • Vous devez disposer du rôle Entity admin sur l'entité que la page représente.
  • La fonctionnalité ui.public_status_page doit être activée. Tant qu'elle est désactivée, la page ne peut pas être ouverte et l'écran l'indique ; un super-administrateur l'active dans Settings › Instance.
  • Décidez de ce que les visiteurs doivent reconnaître : des services tels que Portail client ou Paiements par carte, et non des noms de serveurs.

Ce que voient les visiteurs, et ce qu'ils ne voient jamais​

La page est construite champ par champ à partir d'une liste d'autorisation, et jamais en filtrant des données internes.

Sur la pageJamais sur la page
Le titre, l'introduction, le logo, le thème et la couleur d'accentLes noms de ressources, les noms d'hôtes, les types, les étiquettes ou les ID
Les composants avec les noms que vous leur donnez, en groupes et dans votre ordreLes vérifications, les métriques, les valeurs ou les seuils
L'état de chaque composant et sa barre de disponibilité sur 90 joursLes alertes, leurs titres, leurs gravités ou leurs nombres
Les incidents que vous publiez, avec chaque mise à jour et son heureQui a publié, qui est responsable, tout ce qui vient de la boîte de réception des alertes
La maintenance que vous choisissez d'annoncer, avec son titre et sa description publicsLe motif interne d'une fenêtre de maintenance
Des liens vers RSS, Atom et JSON Feed, et un lien Sign in discretLes chemins d'entités, les autres entités, ou le nom et le logo du produit

Créer la page​

  1. Ouvrez Settings › Status page et choisissez l'entité dans le sélecteur, par exemple Combray SA.

  2. Sélectionnez Create a status page for Combray SA. La page est créée non publiée.

  3. Sous Page, renseignez les paramètres :

    ParamètreRemarques
    TitleNomme aussi l'onglet du navigateur et les flux
    IntroductionUn court texte sous le titre
    Logo addresshttps://… ou un chemin sur ce serveur, tel que /logos/ciguapa.svg. Lorsque ce champ est vide, le logo de la branche est utilisé, s'il en a un ; jamais celui du produit
    ThemeN'importe quel thème de la console ; Daylight par défaut
    Accent colourUne couleur pour les liens et les contours de focus, ou Use the theme's
    Time zone of the daily barsLe moment où chaque jour des barres de disponibilité commence et se termine. Les heures des incidents et des maintenances s'affichent dans le fuseau horaire de chaque visiteur
    Own domainFacultatif, par exemple status.ciguapa.example ; voir plus bas
  4. Sélectionnez Save.

La valeur de Public address est https://<server>/status/<entity short name>. Open the public page l'ouvre ; Show preview l'affiche ici, qu'elle soit publiée ou non.

Ajouter des composants​

Un composant est quelque chose que les visiteurs reconnaissent. Il suit des ressources de l'entité de la page ou des entités situées en dessous : une ressource entière, ou une seule vérification d'une ressource lorsque seule cette vérification compte pour le service.

  1. Sous Components, sélectionnez Add a component.
  2. Saisissez le Name, par exemple Paiements par carte, et, si vous le souhaitez, une Description et un Group. Les composants du même groupe sont affichés ensemble.
  3. Sous Follows, choisissez une Resource et soit The whole resource, soit une Check, puis sélectionnez Follow. Répétez l'opération pour chaque ressource dont dépend le service.
  4. Laissez Show the 90-day availability bar sélectionné, sauf si un pourcentage a peu de sens pour ce composant.
  5. Laissez Status shown sur From what it follows.
  6. Sélectionnez Save component.

Utilisez les flèches pour changer l'ordre. L'écran affiche à côté de chaque composant ce que disent les ressources qu'il suit ; un état manuel périmé est donc facile à repérer.

Ce que disent les éléments suivisÉtat du composant
Toutes les ressources suivies sont saines ; une vérification au niveau info compte comme saineOperational (opérationnel)
L'une est en avertissementDegraded performance (performances dégradées)
Certaines sont critiques ou injoignablesPartial outage (panne partielle)
Toutes celles qui remontent un état sont critiquesMajor outage (panne majeure)
Toutes sont dans une fenêtre de maintenanceUnder maintenance (en maintenance)
Rien n'a encore été signaléOperational sur la page, No data (aucune donnée) dans les barres

Les ressources en maintenance ne comptent ni pour ni contre : un nœud de base de données en maintenance et l'autre sain donnent Operational. Une ressource mise en sourdine compte selon l'état réel de ses vérifications, car la mise en sourdine modifie les notifications, pas le service.

Pour remplacer l'état manuellement, par exemple par Major outage lorsque vous en savez plus que les vérifications, choisissez-le dans Status shown. Remettez ensuite From what it follows.

Publier la page​

  1. Vérifiez la page avec Show preview.
  2. Sous Page, sélectionnez Published, puis Save.

Tant que la page n'est pas publiée, son adresse répond par une erreur not found ; l'aperçu continue de fonctionner.

Signaler un incident​

  1. Sous Incidents, sélectionnez Report an incident.
  2. Saisissez le Title, l'Impact (No impact, Minor impact, Major impact ou Critical impact), les Affected components, le Status et un premier Message.
  3. Sélectionnez Report. L'incident et sa première mise à jour apparaissent sur la page et dans les flux avec leur heure.
  4. Au fur et à mesure que vous en apprenez davantage, publiez des mises à jour avec Post update, chacune avec un état (Investigating, Identified, Monitoring ou Resolved) et un message.

Un incident ouvert élève l'état des composants qu'il affecte au moins au niveau de son impact : mineur à Degraded performance, majeur à Partial outage, critique à Major outage. Publier Resolved le ferme ; il reste sous Past incidents pendant 30 jours.

Par l'API, vous pouvez aussi corriger le texte d'une mise à jour antérieure, mais pas son heure ni son état, et signaler un incident après coup avec l'heure à laquelle il a commencé.

Annoncer une maintenance​

Lorsque vous créez une fenêtre de maintenance, sélectionnez Announce on the status page et renseignez un Public title et, si vous le souhaitez, une Public description ; consultez Planifier une fenêtre de maintenance. La fenêtre apparaît sur la page de chaque entité dont les composants suivent des ressources qu'elle couvre : sous Maintenance tant qu'elle est en cours, sinon avec sa prochaine occurrence dans les 30 jours. Une fenêtre hebdomadaire indique qu'elle se répète au lieu de lister chaque semaine. Seuls le titre et la description publics sont affichés, jamais le motif interne.

Servir la page sur son propre domaine​

Pour publier la page à l'adresse https://status.ciguapa.example/status/ciguapa :

  1. Faites pointer le DNS du nom vers le serveur, avec un enregistrement CNAME ou A.
  2. Demandez à un super-administrateur d'ajouter le nom comme alias dans Settings › Server and certificates et, avec un certificat Let's Encrypt ou votre propre certificat, de le conserver parmi les noms du certificat. Consultez Configurer les noms et TLS.
  3. Saisissez le nom dans Own domain de la page et sélectionnez Save.

Les liens de la page et de ses flux utilisent alors ce nom lorsque la page est ouverte par son intermédiaire. La racine de ce nom, https://status.ciguapa.example/, ouvre toujours la page de connexion de la console ; partagez donc l'adresse complète avec /status/<short name>.

Définir l'apparence d'une branche​

Settings › Branch appearance définit, sur une entité, le Default theme et le Logo address ; chaque entité située en dessous en hérite jusqu'à ce qu'elle définisse les siens. In effect affiche le résultat et son origine. Une page d'état sans logo propre utilise le logo de son entité. Dans cette version, la console elle-même n'applique pas encore le thème d'une branche ; le choix de thème d'une personne l'emporterait de toute façon.

Disponibilité​

Chaque composant enregistre le temps passé dans chaque état, par jour du fuseau horaire de la page. Les jours avec un changement d'heure d'été comptent 23 ou 25 heures. La barre affiche une cellule par jour, 90 sur un ordinateur, 60 sur une tablette et 30 sur un téléphone, colorée selon le pire état qui a duré une minute ou plus ce jour-là, avec des détails au survol, au toucher ou au focus clavier.

  • Daily uptime = 1 − (panne majeure + 0,3 × panne partielle) ÷ temps connu. Les performances dégradées comptent comme disponibles. La maintenance et No data sont exclues du temps connu ; les travaux planifiés ne diminuent donc jamais le chiffre.
  • Le pourcentage affiché en tête utilise la même formule sur 90 jours. Un composant créé récemment affiche uptime since suivi de son premier jour.
  • Une période avec une indisponibilité, même brève, affiche au plus 99,99 %, jamais 100 %.
  • L'historique est conservé 400 jours. Un nouveau fuseau horaire s'applique aux nouveaux jours ; les jours déjà enregistrés conservent leurs limites.

Flux et mise en cache​

La page renvoie vers trois flux de ses mises à jour d'incidents et de ses maintenances annoncées : RSS 2.0, Atom 1.0 et JSON Feed 1.1, à /api/v1/status/<short name>/feed.rss, feed.atom et feed.json. Ajoutez ?lang=es pour obtenir des libellés en espagnol. Les abonnements par e-mail ne sont pas encore disponibles.

Les adresses publiques ne nécessitent aucune connexion et sont peu coûteuses à servir. La page répond avec Cache-Control: public, max-age=30 et un ETag, les flux avec max-age=300, de sorte qu'un CDN ou le proxy placé devant peut les mettre en cache tels quels. Les réponses portent Access-Control-Allow-Origin: *, afin que d'autres sites puissent lire le JSON.

Mettre la page hors ligne​

  • Pour la masquer un moment, décochez Published et enregistrez. Son adresse répond aussitôt par une erreur not found.
  • Désactiver la fonctionnalité ui.public_status_page produit le même effet pour toutes les pages.
  • Delete the page supprime la page avec ses composants, ses incidents et son historique de disponibilité. Cette action est irréversible.