CKTIS / Python
`logging.Logger.propagate`: předávání logovacích záznamů
`propagate` určuje, zda záznam dostanou také obslužné objekty nadřazených loggerů. Hodnota `False` zastaví předávání směrem nahoru, ale nevypne místní obslužné objekty.
Verze: Python 3.12
Syntaxe
logger.addHandler(handler)
logger.propagate = False # Stop forwarding to ancestor handlers.
logger.propagate = True # Allow forwarding to ancestor handlers.V Pythonu 3.12 je propagate atribut instance logging.Logger, nikoli metoda. Výchozí hodnota je True. Volání logger.addHandler(handler) připojí obslužný objekt (handler) přímo k danému loggeru a hodnotu propagate nezmění.
Pokud událost projde kontrolou efektivní úrovně a filtrů zdrojového loggeru, záznam se nejprve nabídne jeho vlastním obslužným objektům. Při True pokračuje předávání vzhůru hierarchií názvů oddělených tečkami, případně až ke kořenovému loggeru. Pokud má některý logger v řetězci propagate = False, jeho vlastní obslužné objekty mohou záznam ještě zpracovat, ale ty výše ho nedostanou.
Při předávání se znovu nekontrolují úrovně ani filtry nadřazených loggerů. Úroveň a filtry jednotlivých obslužných objektů však stále platí. To je něco jiného než dědění efektivní úrovně: pokud zdrojový logger není kořenový a má úroveň NOTSET, jeho efektivní práh se určí podle hierarchie ještě před předáváním.
Pokud místní a nadřazený obslužný objekt zapisují do stejného cíle, mohou vzniknout duplicitní záznamy. Nakonfiguruj obslužné objekty jen na vhodném nadřazeném loggeru, nebo připoj místní obslužný objekt a nastav logger.propagate = False, aby byl jeho výstup oddělený. Samotné False nezaručuje ticho: pokud se po cestě nenajde žádný obslužný objekt, logging.lastResort může vypsat záznamy úrovně WARNING nebo vyšší.
Pří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ýsledek
checkout: order received root: order received checkout: order saved
První záznam `INFO` vypíšou oba obslužné objekty. Objekt kořenového loggeru ho přijme, i když má samotný kořenový logger nastaveno `ERROR`. Po nastavení `False` vypíše druhý záznam jen obslužný objekt loggeru `checkout`.
Související lekce
- Python · Lekce 24 · Středně pokročilá · Verze: 3