Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje