CKTIS / Python
Dołączanie handlera i zatrzymywanie propagacji
Dołącz handler do wybranego loggera za pomocą `addHandler()` i użyj `propagate = False`, aby zatrzymać przekazywanie rekordów do handlerów loggerów nadrzędnych, w tym loggera głównego.
Wersja: Python 3.12
Składnia
logger.addHandler(hdlr)
logger.propagate = Falselogging.Logger.addHandler dołącza istniejący obiekt handlera do konkretnego loggera. Pobierz logger przez logging.getLogger(name) i przekaż do logger.addHandler(hdlr) obiekt, np. instancję logging.StreamHandler, a nie samą klasę. Handler określa miejsce zapisu, a jego formater ustala postać tekstu. Aby odłączyć handler, użyj logger.removeHandler(hdlr), zamiast modyfikować bezpośrednio listę logger.handlers.
Logger źródłowy najpierw stosuje swój efektywny poziom i własne filtry. Zaakceptowany rekord trafia do lokalnych handlerów, a przy domyślnym propagate = True także do handlerów kolejnych loggerów nadrzędnych, o ile nic nie zatrzyma propagacji. Poziomy i filtry loggerów nadrzędnych nie są wtedy sprawdzane, ale każdy handler nadal stosuje własny próg i filtry.
Ustawienie logger.propagate = False zatrzymuje przekazywanie w górę po obsłużeniu rekordu przez lokalne handlery. Nie wyłącza loggera i nie zmienia konfiguracji loggera głównego; rekord nie dotrze do żadnego handlera wyżej w tej gałęzi. Jeśli handler lokalny i handler nadrzędny zapisują w to samo miejsce, propagacja może dać pozornie zduplikowane wpisy. Gdy wystarczy wspólne wyjście, skonfiguruj handler tylko na odpowiednim loggerze nadrzędnym i pozostaw propagację włączoną.
Przykłady
import logging
import sys
logging.basicConfig(
level=logging.WARNING,
stream=sys.stdout,
format="root: %(message)s",
)
logger = logging.getLogger("cktis.demo")
logger.setLevel(logging.INFO)
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("local: %(message)s"))
logger.addHandler(handler)
logger.info("first")
logger.propagate = False
logger.info("second")
Wynik
local: first root: first local: second
Uruchom skrypt w nowym procesie Pythona 3.12. `first` pojawia się dwa razy: jako `local:` i jako `root:`. Poziom `WARNING` loggera głównego nie blokuje przekazanego rekordu `INFO`, ponieważ rekord trafia bezpośrednio do jego handlera. Po wyłączeniu propagacji `second` pojawia się tylko jako `local:`.
Powiązane lekcje
- Python · Lekcja 24 · Średniozaawansowany · Wersja: 3