Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti