CKTIS / Python
Pripojenie obsluhy logovania a zastavenie propagácie
Pomocou `addHandler()` pripojte obsluhu ku konkrétnemu loggeru a nastavením `propagate = False` zabráňte odovzdávaniu záznamov obsluhám nadradených loggerov vrátane koreňového.
Verzia: Python 3.12
Syntax
logger.addHandler(hdlr)
logger.propagate = Falselogging.Logger.addHandler pripojí existujúci objekt obsluhy ku konkrétnemu loggeru. Logger získajte pomocou logging.getLogger(name) a metóde logger.addHandler(hdlr) odovzdajte napríklad inštanciu logging.StreamHandler, nie samotnú triedu. Obsluha určuje cieľ výstupu a jej formátovač určuje podobu textu. Ak chcete obsluhu odpojiť, zavolajte logger.removeHandler(hdlr) namiesto priamej úpravy logger.handlers.
Logger, v ktorom záznam vzniká, najprv uplatní svoju efektívnu úroveň a vlastné filtre. Prijatý záznam ponúkne miestnym obsluhám a pri predvolenom propagate = True aj obsluhám postupne vyššie postavených loggerov, pokiaľ sa propagácia cestou nezastaví. Úrovne ani filtre nadradených loggerov sa pri odovzdávaní nekontrolujú, ale každá obsluha naďalej uplatňuje vlastný prah a vlastné filtre.
logger.propagate = False zastaví odovzdávanie vyššie po tom, čo miestne obsluhy dostali možnosť záznam spracovať. Nevypne logger ani nezmení nastavenie koreňového loggera: žiadna obsluha vyššie v tejto vetve záznam nedostane. Ak miestne a nadradené obsluhy zapisujú do rovnakého cieľa, vo výstupe sa môžu objaviť zdanlivé duplicity. Ak stačí spoločný cieľ, pripojte obsluhu len k vhodnému nadradenému loggeru a nechajte propagáciu zapnutú.
Prí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ýsledok
local: first root: first local: second
Spustite skript v novom procese Pythonu 3.12. `first` sa zobrazí dvakrát, s `local:` a s `root:`. Úroveň `WARNING` koreňového loggera nezablokuje odovzdaný záznam úrovne `INFO`, pretože smeruje priamo do jeho obsluhy. Po vypnutí propagácie sa `second` zobrazí len s `local:`.
Súvisiace lekcie
- Python · Lekcia 24 · Stredne pokročilá · Verzia: 3