CKTIS / Python
`logging.Logger.propagate`: prosljeđivanje zapisa dnevnika
`propagate` određuje dolazi li zapis i do obrađivača nadređenih loggera. Vrijednost `False` zaustavlja prosljeđivanje prema gore, ali ne isključuje lokalne obrađivače.
Verzija: Python 3.12
Sintaksa
logger.addHandler(handler)
logger.propagate = False # Stop forwarding to ancestor handlers.
logger.propagate = True # Allow forwarding to ancestor handlers.U Pythonu 3.12 propagate je atribut instance logging.Logger, a ne metoda. Zadana vrijednost je True. Poziv logger.addHandler(handler) dodaje obrađivač izravno tom loggeru bez promjene atributa propagate.
Ako događaj prođe provjeru efektivne razine i filtara izvornog loggera, zapis se prvo nudi njegovim obrađivačima. Uz True prosljeđivanje se nastavlja prema gore kroz hijerarhiju naziva odvojenih točkama i može dosegnuti korijenski logger. Ako neki logger u lancu ima propagate = False, njegovi obrađivači i dalje mogu obraditi zapis, ali oni iznad njega neće ga primiti.
Pri prosljeđivanju se razine i filtri nadređenih loggera ne provjeravaju ponovno. Razina i filtri svakog obrađivača i dalje se primjenjuju. To nije isto što i nasljeđivanje efektivne razine: ako izvorni logger nije korijenski i ima razinu NOTSET, njegov se efektivni prag određuje prema hijerarhiji prije prosljeđivanja.
Ako lokalni obrađivač i obrađivač nadređenog loggera pišu na isto odredište, mogu nastati dvostruki unosi. Postavi obrađivače samo na prikladan nadređeni logger ili dodaj lokalni obrađivač i postavi logger.propagate = False kako bi odvojio njegov izlaz. Sam False ne jamči da neće biti ispisa: ako se na putu ne pronađe nijedan obrađivač, logging.lastResort može ispisati zapise razine WARNING ili više.
Primjeri
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")
Rezultat
checkout: order received root: order received checkout: order saved
Oba obrađivača ispisuju prvi zapis `INFO`. Obrađivač korijenskog loggera prihvaća ga iako je sam korijenski logger postavljen na `ERROR`. Nakon postavljanja `False` drugi zapis ispisuje samo obrađivač loggera `checkout`.
Povezane lekcije
- Python · Lekcija 24 · Srednje · Verzija: 3