Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 = False

logging.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

Źródła