28 lines
1.2 KiB
Markdown
28 lines
1.2 KiB
Markdown
<!-- file: ks-logging/README.md -->
|
|
<!-- version: 8 -->
|
|
|
|
# ks-logging
|
|
|
|
`ks-logging` possède le contrat logging indépendant du workspace et initialise le subscriber global `tracing` à partir du profil logging sélectionné.
|
|
|
|
## Responsabilités
|
|
|
|
- charger `logging.config.json` et résoudre ses placeholders d'environnement ;
|
|
- valider `config/schemas/logging.config.schema.json` ;
|
|
- posséder `logs_directory` comme valeur globale indépendante des profils ;
|
|
- sélectionner un `default_profile` ou un profil explicitement choisi par une composition ;
|
|
- résoudre les chemins relatifs des targets fichier sous `logs_directory` ;
|
|
- initialiser les routes `tracing` sans exposer de secret.
|
|
|
|
`logs_directory` utilise actuellement `${KS_LOGS_DIRECTORY:-logs}`. Une installation peut donc déplacer la racine des logs par environnement ou `.env` sans recopier le chemin dans chaque profil logging.
|
|
|
|
## Frontière
|
|
|
|
Les types logging restent possédés par `ks-logging`, pas par `ks-config`. Une composition de binaire ne recopie aucune route : elle référence le document logging partagé et peut remplacer seulement le profil sélectionné.
|
|
|
|
## Documents
|
|
|
|
- [Utilisation](USAGE.md)
|
|
- [Historique](CHANGELOG.md)
|
|
- [Guide logging](../docs/guides/LOGGING.md)
|