Observabilité

Métriques, sondes et stack locale.

Sondes HTTP (cette API)

Utilisez ces chemins pour la supervision et l’orchestration.

  • GET /health — statut général et modèle chargé
  • GET /ready — readiness détaillée
  • GET /version — version applicative (JSON)
/health /ready /version

Prometheus (optionnel)

Si PROMETHEUS_ENABLED est activé, les métriques HTTP sont exposées sur un chemin dédié (valeur par défaut dans le dépôt : /observability/prometheus — configurable via PROMETHEUS_PATH).

Vérifiez la réponse avec un scrape Prometheus ou un simple GET lorsque la fonctionnalité est active.

/observability/prometheus

Si vous obtenez 404, l’instrumentation Prometheus est probablement désactivée dans l’environnement courant.

Limitation de débit

L’API applique du rate limiting (slowapi) par adresse IP. En cas de dépassement : HTTP 429 — prévoir un backoff côté client. Les quotas effectifs (multiplicateurs dev/prod, Redis optionnel) sont exposés en JSON.

GET /rate-limit

Stack locale (Docker)

À la racine du dépôt : make observability-up utilise monitoring/docker-compose.observability.yml. Arrêt : make observability-down.

CI & rapports

Les workflows GitHub Actions publient des résumés (build, tests) dans le Step Summary de chaque job.