Create a Structured Logging System for Your Applications

Tu es un ingénieur backend senior spécialisé en observabilité et monitoring. Conçois un système de logs structurés complet pour une application [LANGAGE/FRAMEWORK] en production.

Contexte du projet :

• Type d'application : [TYPE_APPLICATION (ex: API REST, microservice, application web, CLI)]
• Environnements cibles : [ENVIRONNEMENTS (ex: développement, staging, production)]
• Volume estimé de logs : [VOLUME (ex: 1000 req/min, 10000 events/jour)]
• Stack d'agrégation existante : [STACK_LOGS (ex: ELK, Grafana Loki, Datadog, aucune)]

Livre les éléments suivants :

1. Architecture du système de logging :

   • Choix de la librairie de logging avec justification
   • Format structuré (JSON) avec schéma détaillé des champs obligatoires et optionnels
   • Niveaux de log (DEBUG, INFO, WARN, ERROR, FATAL) avec politique claire d'utilisation de chaque niveau et exemples concrets

2. Implémentation du logger central :

   • Classe ou module de logging réutilisable avec configuration centralisée
   • Support du contexte de requête (request ID, user ID, session ID) via propagation automatique
   • Enrichissement automatique des logs (timestamp ISO 8601, hostname, PID, version de l'app)
   • Gestion des données sensibles : masquage automatique (mots de passe, tokens, emails) via patterns configurables

3. Middlewares et intercepteurs :

   • Middleware de logging HTTP : méthode, URL, status code, durée, taille de la réponse
   • Intercepteur pour les appels base de données : requête (sans données sensibles), durée, nombre de résultats
   • Intercepteur pour les appels à des services externes : endpoint, durée, succès/échec

4. Gestion des erreurs dans les logs :

   • Capture automatique des stack traces avec contexte enrichi
   • Corrélation des erreurs avec le request ID pour le traçage
   • Niveaux d'alerte selon la criticité avec seuils configurables

5. Rotation et rétention :

   • Stratégie de rotation des fichiers (taille max, durée)
   • Politique de rétention par environnement
   • Configuration pour le streaming vers la stack d'agrégation

6. Performance et bonnes pratiques :

   • Logging asynchrone pour ne pas bloquer le thread principal
   • Sampling des logs DEBUG/TRACE en production
   • Tests unitaires pour valider le format et le contenu des logs

Fournis le code complet, documenté, avec des commentaires expliquant chaque décision technique. Inclus un exemple d'utilisation dans un endpoint réel et un fichier de configuration par environnement.