Files
khadhroony-bot3/kb-logging
2026-08-09 17:47:35 +02:00
..
2026-07-28 18:41:30 +02:00
2026-07-24 22:01:07 +02:00
2026-08-09 17:47:35 +02:00
2026-08-09 17:47:35 +02:00
2026-08-09 17:47:35 +02:00
2026-07-31 15:44:46 +02:00

kb-logging

kb-logging initialise le subscriber global tracing à partir dune 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 quun 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

Linitialisation multi-routes est fonctionnelle. Elle échoue explicitement si aucune route nest activée ou si le subscriber global a déjà été initialisé.

Documents