CKTIS / Python
Připojení obsluhy logování a zastavení propagace
Pomocí `addHandler()` připojte obsluhu ke konkrétnímu loggeru a nastavením `propagate = False` zabraňte předávání záznamů obsluhám nadřazených loggerů včetně kořenového.
Verze: Python 3.12
Syntaxe
logger.addHandler(hdlr)
logger.propagate = Falselogging.Logger.addHandler připojí existující objekt obsluhy ke konkrétnímu loggeru. Logger získejte pomocí logging.getLogger(name) a metodě logger.addHandler(hdlr) předejte například instanci logging.StreamHandler, nikoli samotnou třídu. Obsluha určuje cíl výstupu a její formátovač určuje podobu textu. Chcete-li obsluhu odpojit, zavolejte logger.removeHandler(hdlr) místo přímé úpravy logger.handlers.
Logger, ve kterém záznam vzniká, nejprve uplatní svou efektivní úroveň a vlastní filtry. Přijatý záznam nabídne místním obsluhám a s výchozím propagate = True také obsluhám postupně všech nadřazených loggerů, pokud se propagace cestou nezastaví. Úrovně ani filtry nadřazených loggerů se při předávání nekontrolují, ale každá obsluha dál uplatňuje vlastní práh a vlastní filtry.
logger.propagate = False zastaví předávání výše poté, co místní obsluhy dostaly možnost záznam zpracovat. Nevypne logger ani nezmění nastavení kořenového loggeru: žádná obsluha výše v této větvi záznam nedostane. Pokud místní a nadřazené obsluhy zapisují do stejného cíle, mohou se ve výstupu objevit zdánlivé duplicity. Stačí-li společný cíl, připojte obsluhu pouze k vhodnému nadřazenému loggeru a ponechte propagaci zapnutou.
Příklady
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")
Výsledek
local: first root: first local: second
Spusťte skript v novém procesu Pythonu 3.12. `first` se zobrazí dvakrát, s `local:` a s `root:`. Úroveň `WARNING` kořenového loggeru neblokuje předaný záznam úrovně `INFO`, protože záznam míří přímo do jeho obsluhy. Po vypnutí propagace se `second` zobrazí jen s `local:`.
Související lekce
- Python · Lekce 24 · Středně pokročilá · Verze: 3