1.5 KiB
1.5 KiB
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
WorkerGuardpendant 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_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é.