1.4 KiB
1.4 KiB
kb-logging
kb-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
WorkerGuardpendant toute la durée du processus.
Hors périmètre
La crate ne charge pas le fichier de configuration et ne définit pas les targets des autres crates. kb-config fournit les valeurs et chaque crate publie son propre target canonique.
API publique
init_logginginitialise le subscriber global ;LoggingConfig,LogTargetConfigetLogTargetFilterConfigdécrivent les routes ;LoggingGuardmaintient les writers et expose les routes installées ;tracing_targetretourne le target canonique de la crate ;LogFileRoutereste 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é.