Orbit

Page de statut Orbit

A status page is a public, no-login URL that shows whether your project is up, how it has performed recently, and what you have deployed. Turning it on also starts an uptime check that pings your…

Une page de statut est une URL publique sans connexion qui montre si votre projet est actif, comment il a fonctionné récemment et ce que vous avez déployé. L'activation démarre également une vérification de disponibilité qui envoie une requête à votre projet chaque minute, ce qui vous permet d'obtenir une surveillance comme effet secondaire de la publication.

Où se trouvent les paramètres de la page de statut

Ouvrez Orbit, cliquez sur le projet, et choisissez Status page sous le groupe Observability dans l'onglet du projet. La page s'intitule Public status page.

Status page settings for an Orbit project

L'activer

  1. Activez Enable public status page.
  2. Choisissez un Public slug. Il devient partie de l'URL publique, donc choisissez quelque chose de reconnaissable, comme le nom de votre produit.
  3. Définissez optionnellement un Ping path. La valeur par défaut est /.
  4. Remplissez le Page title et le Tagline affichés en haut de la page publique.
  5. Décidez si vous souhaitez afficher les Show recent deploys et les Show recent incidents.
  6. Cliquez sur Save settings.

Une fois enregistré, la page affiche un badge Live et confirme que votre page de statut est publiée et envoie une requête chaque minute. Un lien vous dirige vers la page publique pour que vous voyiez ce que les visiteurs voient.

Règles du slug

Le slug doit contenir des lettres minuscules, des chiffres et des traits d'union, jusqu'à 80 caractères, et ne peut pas commencer ou finir par un trait d'union. Les slugs sont uniques sur tout Orbit, pas seulement sur votre compte, donc un mot courant peut déjà être utilisé. Si c'est le cas, l'enregistrement retourne un message indiquant que le slug est déjà utilisé et vous en choisissez un autre.

Choisissez le slug avec soin : c'est l'adresse publique que vous mettrez dans votre documentation et vos réponses de support, et le modifier ultérieurement casse tous les liens vers celui-ci.

Ce que les visiteurs voient

La page publique est construite à partir des mêmes données que les onglets de votre projet :

  • Current status, de la plus récente validation : Operational, Building, Deploying, Queued, Awaiting Approval, Build Failed, Cancelled ou Rolled Back.
  • Uptime, calculé sur des fenêtres roulantes de 24 heures, 7 jours et 30 jours à partir des vérifications minute par minute.
  • Recent deployments avec un taux de réussite, si vous avez activé cette section.
  • Statistiques sur 30 jours : taux de réussite, temps de création moyen et nombre total de validations.
  • Core Web Vitals, sous forme de p75 sur les 30 derniers jours, si vous les collectez.
  • Incidents, tirés des annotations que vous avez marquées sur la chronologie du projet.

La page s'actualise d'elle-même, donc un client qui la laisse ouverte lors d'un incident la voit se mettre à jour sans rechargement.

Tout sur la page est des données opérationnelles : état des validations, temps de réponse, disponibilité et vitals. Les messages de validation, les noms de branches, les variables d'environnement et les détails de votre référentiel ne sont pas publiés.

Les incidents proviennent de la chronologie

La section des incidents n'est pas un éditeur séparé. Elle affiche les annotations de type Incident à partir de la chronologie du projet, donc le flux de travail lors d'une panne est : marquer une annotation d'incident, et elle apparaît publiquement.

C'est intentionnel. Cela signifie que votre chronologie interne et votre communication publique restent synchronisées sans que personne ne maintienne deux enregistrements. Consultez Orbit Timeline Annotations pour savoir comment en rédiger une.

Rédigez les annotations d'incident comme si un client allait les lire, parce qu'il le fera. Dites ce qui est affecté, ce que vous savez et quand vous allez donner la prochaine mise à jour. Publiez ensuite une annotation de mise à jour quand c'est résolu, plutôt que de laisser le dernier message public comme « investigation en cours ».

La vérification de disponibilité

L'activation de la page de statut démarre une vérification qui récupère l'URL de production de votre projet, au chemin de requête que vous avez défini, une fois par minute. Chaque résultat est stocké, et les pourcentages de disponibilité sur la page publique sont calculés à partir de ces enregistrements.

Les vérifications sont conservées pendant 90 jours et les plus anciennes sont supprimées automatiquement.

Choisir un bon chemin de requête

La valeur par défaut / fonctionne pour la plupart des projets. Deux raisons de choisir quelque chose d'autre :

  • Votre page d'accueil est lourde. Un chemin léger est une chose plus équitable et moins coûteuse à interroger une fois par minute.
  • Votre page d'accueil peut être active alors que l'application est cassée. Une coque statique en cache retournera joyeusement 200 tandis que votre API est hors ligne. Un chemin comme /api/health qui exerce réellement l'application dit la vérité.

Si vous avez déjà configuré une vérification de santé pour la restauration automatique, l'utilisation du même chemin ici maintient les deux signaux cohérents. Consultez Deploying Your Project pour les paramètres de vérification de santé.

Ne pointez pas le chemin de requête vers quelque chose de coûteux, et ne le pointez pas vers un chemin derrière l'authentification. Un chemin qui retourne 401 ou 302 vers une page de connexion enregistrera un échec chaque minute et votre disponibilité affichera zéro.

Supprimer la page de statut

Cliquez sur Remove page et confirmez. La confirmation est explicite : tout l'historique de disponibilité sera supprimé.

C'est worth pausing on. La suppression de la page n'est pas un bouton de pause. La vérification s'arrête, l'URL publique cesse de fonctionner, et l'enregistrement de disponibilité accumulé disparaît avec. Si vous voulez seulement que la page soit temporairement invisible, il n'y a pas de mode masqué : réfléchissez à savoir si désactiver le bouton d'activation et conserver la configuration en place vous convient mieux que de la supprimer.

Le slug est libéré quand la page est supprimée, donc quelqu'un d'autre peut la réclamer par la suite.

Conseils pratiques

Publiez avant d'en avoir besoin. Une page de statut créée lors d'une panne est une page que personne n'a mise en signet. Mettez le lien dans votre pied de page, votre documentation et votre signature d'assistance pendant que tout va bien.

Ne faites pas de promesses excessives. Le chiffre de disponibilité sur la page provient d'une vérification d'une minute contre un seul chemin. C'est une surveillance honnête, pas un contrat SLA, et elle ne devrait pas être présentée comme telle.

Gardez le tagline court. Il se trouve sous le titre sur une page que les gens ouvrent quand ils sont déjà frustrés. Une seule ligne disant ce que le service est, et rien d'autre.

Dépannage

La disponibilité affiche 0% ou est beaucoup plus basse que la réalité. Le chemin de requête retourne une réponse non-2xx. Ouvrez-le dans une fenêtre de navigateur privée : une redirection vers une page de connexion, un 404 d'un chemin qui n'existe plus, ou un blocage géographique sont les causes habituelles.

L'URL publique retourne 404. La page est enregistrée mais le bouton d'activation est désactivé, ou le slug dans votre lien ne correspond pas à celui enregistré. Copiez le lien depuis la page des paramètres.

Le slug est rejeté. Il est utilisé, contient un caractère invalide, ou commence ou finit par un trait d'union.

Aucune vitals n'apparaît sur la page publique. Les vitals proviennent du script de collecteur sur votre site. Consultez Orbit Web Vitals.

Aucun incident n'apparaît bien que nous en ayons eu un. L'annotation doit être de type Incident, et le commutateur Show recent incidents doit être activé.

Où aller ensuite

Vous avez besoin d'aide?

Envoyez-nous un email à support@kapsulehost.com ou ouvrez un chat dans KPanel.

Ouvrir KPanel
Page de statut Orbit