Aller au contenu principal

Logging en production

Règles

  • Utiliser des tableaux de contexte structurés
  • Inclure module, action, ID acteur et ID cible quand utile
  • Utiliser error pour les échecs nécessitant une attention
  • Utiliser warning pour les états suspects récupérables
  • Utiliser info pour les jalons métier importants

À ne pas faire

  • Ne pas logger les payloads bruts des endpoints sensibles
  • Ne pas logger les tokens, cookies, mots de passe ou clés privées

Niveaux de log

NiveauUsage
emergencySystème inutilisable
criticalPanne critique, intervention immédiate
errorErreur runtime, action requise
warningÉtat anormal mais récupéré
infoÉvénement métier normal important
debugDéveloppement uniquement, pas en prod

Configuration

LOG_CHANNEL=daily
LOG_LEVEL=info

Les logs quotidiens sont dans storage/logs/laravel-YYYY-MM-DD.log.

Accès aux logs depuis l'interface

Les logs de chaque module sont accessibles depuis Admin → Applications → [Module] → Paramètres → "Logs d'exécution".

La route AJAX retourne les 300 dernières lignes du fichier de log sélectionné.