# Sondes de santé

> Comment Wakastart vérifie qu'un conteneur est vivant, prêt à recevoir du trafic et bien démarré, et ce que votre service doit exposer.

Une sonde de santé est une requête HTTP que la plateforme envoie régulièrement à chaque conteneur d'un service. Selon la réponse, elle redémarre le conteneur, lui retire du trafic ou attend qu'il ait fini de démarrer.

## Définition

Wakastart propose trois [sondes](/v1.0/glossaire#sonde-de-santé), activables séparément dans la carte **Health Probes** de la définition de service :

| Sonde | Question posée | En cas d'échec répété |
|---|---|---|
| **Liveness Probe** (vie) | Le conteneur est-il encore vivant ? | Le conteneur est redémarré |
| **Readiness Probe** (disponibilité) | Le conteneur peut-il recevoir du trafic ? | Le conteneur ne reçoit plus de trafic, sans être redémarré |
| **Startup Probe** (démarrage) | Le conteneur a-t-il fini de démarrer ? | Les deux autres sondes attendent ; au-delà du délai, le conteneur est redémarré |

Chaque sonde est une requête `GET` sur le chemin `/health`, envoyée au port du service. Une réponse de code 200 à 399 est un succès ; toute autre réponse, ou l'absence de réponse dans le délai, est un échec.

## Pourquoi ça existe

Un processus peut rester en vie tout en étant bloqué : boucle infinie, pool de connexions épuisé. Sans sonde, il continue de recevoir des requêtes qu'il ne traite pas. Les sondes permettent aussi un déploiement sans coupure : un nouveau conteneur ne reçoit du trafic qu'une fois prêt, et l'ancien n'est arrêté qu'ensuite.

## Comment ça marche

### Paramètres

| Paramètre | Vie | Disponibilité | Démarrage |
|---|---|---|---|
| Chemin | `/health` | `/health` | `/health` |
| Délai avant la première sonde | 30 s | 10 s | 0 s |
| Intervalle | 30 s | 10 s | 10 s |
| Délai de réponse | 10 s | 5 s | 5 s |
| Échecs avant action | 3 | 3 | 30 |

Avec ces valeurs, un conteneur bloqué est redémarré environ 90 secondes après son premier échec. La sonde de démarrage laisse jusqu'à 5 minutes (30 essais espacés de 10 secondes) à un service lent à démarrer.

### Activation par défaut

| Sonde | Formulaire **Nouveau Service** de la console | Définition importée sans réglage |
|---|---|---|
| Vie | désactivée | activée |
| Disponibilité | désactivée | activée |
| Démarrage | désactivée | désactivée |

À la création d'un service dans la console, activez vous-même **Liveness Probe** et **Readiness Probe** si votre service répond sur `/health`. Une instance hérite de l'activation choisie dans la définition. Changer l'activation d'une sonde redéploie les instances du service.

### Ce que votre service doit exposer

Votre service doit répondre sur `GET /health`, sur son port d'écoute, en moins de 5 secondes, sans authentification. Une réponse minimale suffit :

```ts
// Exemple avec Node.js et Express
app.get("/health", (_req, res) => {
  res.status(200).json({ status: "ok" });
});
```

Gardez cette route légère : ne vérifiez pas toutes vos dépendances à chaque appel, sans quoi une base momentanément lente ferait redémarrer tous vos conteneurs.

## Exemples

- **API classique.** Vie et disponibilité activées, démarrage désactivé. L'API répond `200` sur `/health` dès que le serveur HTTP écoute.
- **Service lent à démarrer.** Une application qui charge un modèle en mémoire pendant 2 minutes active la sonde de démarrage, pour que la sonde de vie ne la redémarre pas en boucle.
- **Programme sans serveur HTTP.** Un traitement de fond qui n'écoute sur aucun port désactive les trois sondes.

## Pour aller plus loin

- [Modifier un service](/v1.0/services/modifier-un-service)
- [Consulter l'état d'un service](/v1.0/services/consulter-l-etat-d-un-service)
- [Résoudre les problèmes de services](/v1.0/services/depannage)
