> ## Documentation Index
> Fetch the complete documentation index at: https://infra-docs.kaeyros.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Health checks et sondes de disponibilité

> Plusieurs mécanismes vérifient la santé des services : sondes K8s, Uptime Kuma, Checkmate externe et surveillance métier applicative.

Quatre niveaux de vérification travaillent ensemble pour garantir la disponibilité des services de production. Cette page détaille chaque mécanisme, sa configuration et les points de vigilance actuels.

## 1. Sondes Kubernetes

Les sondes sont définies dans les fichiers de valeurs Helm des applications. Sans elles, Kubernetes ne peut pas détecter qu'un pod ne répond plus.

| Sonde | Rôle | Quand elle échoue |
| - | - | - |
| `startupProbe` | Attendre le temps de démarrage | Kubernetes attend avant de tester les autres sondes |
| `livenessProbe` | Détecter un blocage | Kubernetes redémarre le pod |
| `readinessProbe` | Contrôler le trafic | Le pod est retiré du Service (pas de trafic) |

Consultez la page [/deploiement/fichier-valeurs](https://infra-docs.kaeyros.org/deploiement/fichier-valeurs.md) pour les gabarits de configuration des sondes.

## 2. Uptime Kuma

**URL** : [health-check.kaeyros.org](https://health-check.kaeyros.org)

Uptime Kuma reçoit les sondes provisionnées automatiquement par un opérateur (`uptime-operator`). Celui-ci lit les annotations sur les ressources Ingress et crée les sondes correspondantes.

Exemple d'annotations sur un Ingress :

```yaml theme={null}
annotations:
  uptime-kuma.io/enabled: "true"
  uptime-kuma.io/interval: "60"
  uptime-kuma.io/monitor-name: "biolab production"
```

| Annotation | Description |
| - | - |
| `uptime-kuma.io/enabled` | Active la sonde (`"true"` ou `"false"`) |
| `uptime-kuma.io/interval` | Intervalle de vérification en secondes |
| `uptime-kuma.io/monitor-name` | Nom affiché dans le dashboard |

> [!WARNING]
>
> Aucune instance Uptime Kuma n'a été trouvée en fonctionnement sur le serveur d'outillage. L'opérateur pose les sondes mais elles n'ont pas de destination active. Consultez la page [/operations/chantiers](https://infra-docs.kaeyros.org/operations/chantiers.md) pour le suivi de ce point.

## 3. Checkmate (supervision externe)

**URL** : [monitoring.kaeyros.org](https://monitoring.kaeyros.org)

Checkmate est une supervision externe indépendante, hébergée en dehors du cluster. Elle sonde les URL publiques depuis Internet et alerte en cas d'indisponibilité détectée de l'extérieur.

## 4. Sondes métier applicatives

Certaines applications exposent un endpoint `/health/metier` qui vérifie l'état de leurs dépendances critiques :

* Connexion à la base de données
* Disponibilité du cache
* État d'un service tiers

Ces sondes sont distinctes des sondes Kubernetes : elles vérifient la capacité de l'application à traiter ses cas d'usage, pas seulement sa capacité à répondre HTTP 200.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.