39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
<!-- file: ks-logging/README.md -->
|
||
<!-- version: 5 -->
|
||
|
||
# ks-logging
|
||
|
||
`ks-logging` initialise le subscriber global `tracing` à partir d’une configuration de routes explicites vers la console ou des fichiers.
|
||
|
||
## Responsabilités
|
||
|
||
- sélectionner les routes activées ;
|
||
- appliquer niveaux, targets exactes et préfixes wildcard ;
|
||
- créer les writers non bloquants ;
|
||
- gérer les formats human, compact, pretty et JSON ;
|
||
- gérer les rotations de fichiers supportées ;
|
||
- conserver les `WorkerGuard` pendant toute la durée du processus.
|
||
|
||
## Hors périmètre
|
||
|
||
La crate ne charge pas actuellement le fichier de configuration et ne définit pas les targets des autres crates. Le cadrage `0.5.0-pre.002` confirme qu’un document logging séparé sera introduit en `0.5.1`; la propriété exacte du DTO source sera fixée sans faire dépendre la configuration générale du runtime tracing.
|
||
|
||
## API publique
|
||
|
||
- `init_logging` initialise le subscriber global ;
|
||
- `LoggingConfig`, `LogTargetConfig` et `LogTargetFilterConfig` décrivent les routes ;
|
||
- `LoggingGuard` maintient les writers et expose les routes installées ;
|
||
- `tracing_target` retourne le target canonique de la crate ;
|
||
- `LogFileRoute` reste disponible pour les anciens appelants file-only.
|
||
|
||
## Statut
|
||
|
||
L’initialisation multi-routes est fonctionnelle. Elle échoue explicitement si aucune route n’est activée ou si le subscriber global a déjà été initialisé.
|
||
|
||
## Documents
|
||
|
||
- [Utilisation](USAGE.md)
|
||
- [Travaux restants](TODO.md)
|
||
- [Historique](CHANGELOG.md)
|
||
- [Guide de configuration](../ks-config/USAGE.md)
|