Skip to main content

Monitoring

Healthcheck applicatif​

Patrimo expose un endpoint de healthcheck :

GET /api/health

Réponse attendue (HTTP 200) :

{
  "status": "ok",
  "timestamp": "2024-03-15T10:30:00.000Z",
  "version": "0.1.0"
}

Ce endpoint est utilisé par :

  • Docker Compose (healthcheck du service app en production)
  • Coolify (vérification de disponibilité du service)
  • Tout outil de supervision externe (UptimeRobot, Betterstack…)

Logs Docker​

# Logs en temps réel
docker compose logs -f

# Logs de l'app uniquement
docker compose logs -f app

# Dernières 100 lignes
docker compose logs --tail=100 app

Les logs Next.js incluent les erreurs de rendu serveur, les actions serveur en échec et les requêtes lentes.

Supervision avec Coolify​

Coolify affiche dans l'interface :

  • Status du container (running / stopped / unhealthy)
  • Logs en temps réel
  • Métriques CPU et RAM basiques
  • Historique des déploiements

Si le healthcheck échoue, Coolify marque le service comme unhealthy et peut redémarrer automatiquement le container (restart: always).

Supervision externe (recommandé)​

Pour être alerté en cas de panne, configurez un outil de monitoring externe pointant vers votre endpoint de healthcheck :

OutilTypeGratuit
UptimeRobotSaaS✅ (50 monitors)
BetterstackSaaS✅ (10 monitors)
GatusSelf-hosted✅

Configuration minimale : vérifier GET https://patrimo.votre-domaine.com/api/health toutes les 5 minutes, alerte si HTTP ≠ 200.

Logs applicatifs​

Next.js écrit dans stdout/stderr. En production, les console.error sont visibles dans les logs Docker. Les console.log de debug ne doivent pas être présents dans le code (règle CLAUDE.md).

Voir aussi​