CKTIS / Python
`logging.Logger.propagate`: propagare i record di log
`propagate` stabilisce se un record di log raggiunge anche i gestori dei logger antenati. `False` interrompe la propagazione verso l’alto senza disattivare i gestori locali.
Versione: Python 3.12
Sintassi
logger.addHandler(handler)
logger.propagate = False # Stop forwarding to ancestor handlers.
logger.propagate = True # Allow forwarding to ancestor handlers.In Python 3.12, propagate è un attributo di istanza di logging.Logger, non un metodo. Il valore predefinito è True. La chiamata logger.addHandler(handler) collega un gestore direttamente a quel logger senza modificare propagate.
Se un evento supera la soglia effettiva e i filtri del logger di origine, il suo record viene offerto prima ai gestori di quel logger. Con True, la propagazione risale la gerarchia dei nomi separati da punti e può arrivare al logger radice. Se un logger della catena ha propagate = False, i suoi gestori possono ancora elaborare il record, ma quelli dei livelli superiori non lo ricevono.
Durante la propagazione non vengono ricontrollati i livelli né i filtri dei logger antenati. Si applicano comunque il livello e i filtri di ogni gestore. È un meccanismo distinto dall’ereditarietà del livello effettivo: se il logger di origine non è la radice e ha livello NOTSET, la sua soglia effettiva viene ricavata dalla gerarchia prima della propagazione.
Se un gestore locale e uno di un logger antenato scrivono nella stessa destinazione, possono comparire voci duplicate. Configura i gestori solo su un antenato adatto, oppure collega un gestore locale e imposta logger.propagate = False per isolarne l’output. False da solo non garantisce il silenzio: se non viene trovato alcun gestore lungo il percorso, logging.lastResort può emettere record di livello WARNING o superiore.
Esempi
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")
Risultato
checkout: order received root: order received checkout: order saved
Entrambi i gestori stampano il primo record `INFO`. Il gestore della radice lo accetta anche se il logger radice è impostato su `ERROR`. Dopo avere impostato `False`, solo il gestore di `checkout` stampa il secondo record.
Lezioni correlate
- Python · Lezione 24 · Intermedio · Versione: 3