FEAT: Health checks complets — /health/ready + /health/live avec degradationLevel #13

New issue

Closed

opened 2026-08-10 21:02:19 +02:00 by nonobis · 0 comments

nonobis commented

2026-08-10 21:02:19 +02:00

Owner

🎯 Contexte

Les endpoints actuels sont /healthz et /readyz. La spec définit une sémantique plus riche avec checks de dépendances et niveau de dégradation IA.

📚 Référence spec (MASTER_SPECIFICATION.md v2.0)

Phase 24 :

GET /health (basique : API répond)
GET /health/ready (DB, Alarik, Broker IA, Redis OK)
GET /health/live (ready + pas de degradation active) → 503 si dégradé, avec degradationLevel
13.2 Health Checks : API 30s, PostgreSQL ping 30s, Alarik GET /health 30s, Broker IA (AMQP) 30s, Ollama /api/tags 60s, Agent heartbeat 30s

🔍 État actuel (vérifié dans le code)

HealthController : /healthz (liveness) + /readyz (HealthCheckService — DB seulement). Pas de checks Alarik/broker/Ollama/Redis, pas de /health/ready, pas de /health/live, pas de degradationLevel.

🧩 À faire

Aligner les routes : /health, /health/ready, /health/live (garder /healthz,/readyz en aliases si nécessaire)
Enregistrer les checks : PostgreSQL, Alarik, Broker IA (si configuré), Redis (si configuré)
Exposer degradationLevel dans /health/live (via le degradation tracker du ticket #4)
Tests

🧪 Critères d'acceptation

/health/ready → 503 si DB down
/health/live → 503 + degradationLevel si broker/exécutant IA down
Format de réponse conforme à l'exemple 13.2

📁 Fichiers concernés

src/Heimdall.Web/Controllers/HealthController.cs, src/Heimdall.Infrastructure/DependencyInjection.cs, src/Heimdall.Infrastructure/Services/Ai/

## 🎯 Contexte Les endpoints actuels sont `/healthz` et `/readyz`. La spec définit une sémantique plus riche avec checks de dépendances et niveau de dégradation IA. ## 📚 Référence spec (MASTER_SPECIFICATION.md v2.0) **Phase 24** : - `GET /health` (basique : API répond) - `GET /health/ready` (DB, Alarik, Broker IA, Redis OK) - `GET /health/live` (ready + pas de degradation active) → 503 si dégradé, avec `degradationLevel` **13.2 Health Checks** : API 30s, PostgreSQL ping 30s, Alarik GET /health 30s, Broker IA (AMQP) 30s, Ollama `/api/tags` 60s, Agent heartbeat 30s ## 🔍 État actuel (vérifié dans le code) `HealthController` : `/healthz` (liveness) + `/readyz` (HealthCheckService — DB seulement). Pas de checks Alarik/broker/Ollama/Redis, pas de `/health/ready`, pas de `/health/live`, pas de degradationLevel. ## 🧩 À faire - [ ] Aligner les routes : /health, /health/ready, /health/live (garder /healthz,/readyz en aliases si nécessaire) - [ ] Enregistrer les checks : PostgreSQL, Alarik, Broker IA (si configuré), Redis (si configuré) - [ ] Exposer `degradationLevel` dans /health/live (via le degradation tracker du ticket #4) - [ ] Tests ## 🧪 Critères d'acceptation - [ ] /health/ready → 503 si DB down - [ ] /health/live → 503 + degradationLevel si broker/exécutant IA down - [ ] Format de réponse conforme à l'exemple 13.2 ## 📁 Fichiers concernés src/Heimdall.Web/Controllers/HealthController.cs, src/Heimdall.Infrastructure/DependencyInjection.cs, src/Heimdall.Infrastructure/Services/Ai/

nonobis added the

labels

2026-08-10 21:02:19 +02:00

nonobis referenced this issue

2026-08-11 17:17:27 +02:00

FEAT: Remontée des logs agents — buffer + endpoint POST /api/agents/{id}/logs #50

nonobis referenced this issue

2026-08-12 09:56:25 +02:00