CKTIS / Python
`logging.Logger.propagate`: odovzdávanie logovacích záznamov
`propagate` určuje, či záznam dostanú aj obslužné objekty nadradených loggerov. Hodnota `False` zastaví odovzdávanie smerom nahor, ale nevypne miestne obslužné objekty.
Verzia: Python 3.12
Syntax
logger.addHandler(handler)
logger.propagate = False # Stop forwarding to ancestor handlers.
logger.propagate = True # Allow forwarding to ancestor handlers.V Pythone 3.12 je propagate atribút inštancie logging.Logger, nie metóda. Predvolená hodnota je True. Volanie logger.addHandler(handler) pripojí obslužný objekt (handler) priamo k danému loggeru bez zmeny propagate.
Ak udalosť prejde kontrolou efektívnej úrovne a filtrov zdrojového loggera, záznam sa najprv ponúkne jeho vlastným obslužným objektom. Pri True pokračuje odovzdávanie nahor hierarchiou názvov oddelených bodkami, prípadne až ku koreňovému loggeru. Ak má niektorý logger v reťazci propagate = False, jeho obslužné objekty ešte môžu záznam spracovať, ale tie nad ním ho nedostanú.
Pri odovzdávaní sa úrovne ani filtre nadradených loggerov znova nekontrolujú. Úroveň a filtre každého obslužného objektu však stále platia. To nie je to isté ako dedenie efektívnej úrovne: ak zdrojový logger nie je koreňový a má úroveň NOTSET, jeho efektívny prah sa určí podľa hierarchie ešte pred odovzdávaním.
Ak miestny a nadradený obslužný objekt zapisujú do rovnakého cieľa, môžu vzniknúť duplicitné záznamy. Nakonfiguruj obslužné objekty len na vhodnom nadradenom loggeri alebo pripoj miestny obslužný objekt a nastav logger.propagate = False, aby bol jeho výstup oddelený. Samotné False nezaručuje ticho: ak sa po ceste nenájde žiadny obslužný objekt, logging.lastResort môže vypísať záznamy úrovne WARNING alebo vyššej.
Príklady
import logging
import sys
def console_handler(label):
handler = logging.StreamHandler(sys.stdout)
handler.setLevel(logging.INFO)
handler.setFormatter(logging.Formatter(f"{label}: %(message)s"))
return handler
root = logging.getLogger()
root.setLevel(logging.ERROR)
root.addHandler(console_handler("root"))
logger = logging.getLogger("checkout")
logger.setLevel(logging.INFO)
logger.addHandler(console_handler("checkout"))
logger.propagate = True
logger.info("order received")
logger.propagate = False
logger.info("order saved")
Výsledok
checkout: order received root: order received checkout: order saved
Prvý záznam `INFO` vypíšu oba obslužné objekty. Objekt koreňového loggera ho prijme, aj keď je samotný koreňový logger nastavený na `ERROR`. Po nastavení `False` vypíše druhý záznam iba obslužný objekt loggera `checkout`.
Súvisiace lekcie
- Python · Lekcia 24 · Stredne pokročilá · Verzia: 3