# Sondes et page de statut

> Comment les sondes HTTP surveillent vos URLs publiques, et comment elles alimentent la page de statut publique de chaque environnement.

Une sonde vérifie, à intervalle régulier et depuis l'extérieur de votre application, qu'une URL publique répond. Les sondes d'un environnement sont regroupées et publiées sur une page de statut que vos utilisateurs peuvent consulter sans compte.

## Définition

- La **supervision d'un environnement** se compose d'un groupe de sondes et d'une page de statut. Elle s'active une fois par environnement, depuis l'onglet **Monitoring**.
- Une **sonde** interroge une URL en HTTPS toutes les 30 secondes, 1, 5 ou 15 minutes.
- La **page de statut publique** affiche l'état des sondes de l'environnement, à l'adresse `https://status.wakastart.app/<application>-<environnement>`, par exemple `https://status.wakastart.app/monapp-prod`.

La page de statut est publique : n'y nommez pas de sonde avec une information que vous ne voulez pas montrer.

## Comment ça marche

```mermaid
sequenceDiagram
  participant V as Vous (onglet Monitoring)
  participant W as Wakastart
  participant P as Page de statut
  V->>W: Activer le monitoring
  W->>P: crée le groupe de sondes, puis la page
  V->>W: Ajouter une sonde (URL https://…)
  W-->>V: sonde En attente, puis Actif
  V->>W: Appliquer les changements
  W->>P: publie les sondes actives
  loop toutes les 30 s à 15 min
    P->>P: interroge chaque URL et affiche son état
  end
```

1. À l'activation, Wakastart crée le groupe de sondes de l'environnement, nommé `<Application> - <environnement>`, puis la page de statut, intitulée `<Application> - <environnement> Status`.
2. Chaque sonde ajoutée passe par **En attente** et **Provisionnement** avant d'être **Actif**.
3. La page de statut publie les sondes actives au moment de sa dernière mise à jour. Après avoir ajouté ou supprimé des sondes, cliquez sur **Appliquer les changements** pour mettre la page à jour.
4. Les résultats des vérifications, disponibilité et historique, se lisent sur la page de statut.

Une sonde peut viser une route publique de l'environnement, choisie dans une liste, ou une URL saisie à la main. Une route ne peut porter qu'une sonde active.

## Exemples

- **Une wakapp avec un front et une API** : deux sondes en prod, `Front` sur `https://app.mon-app.exemple.fr/` et `API` sur `https://api.mon-app.exemple.fr/health`, toutes les minutes. L'URL de la page de statut est ajoutée au pied de page de l'application.
- **Un environnement de recette** : supervision activée, une sonde toutes les 15 minutes, page de statut partagée avec l'équipe qui teste.

## Pour aller plus loin

- [Activer la supervision d'un environnement](/v1.0/supervision/activer-la-supervision)
- [Ajouter une sonde](/v1.0/supervision/ajouter-une-sonde)
- [État de santé](/v1.0/supervision/etat-de-sante)
