CKTIS / Python
`logging.Logger.propagate`: propagar registros de logging
`propagate` controla si un registro llega también a los manejadores de los loggers antecesores. `False` detiene la propagación hacia arriba sin desactivar los manejadores locales.
Versión: Python 3.12
Sintaxis
logger.addHandler(handler)
logger.propagate = False # Stop forwarding to ancestor handlers.
logger.propagate = True # Allow forwarding to ancestor handlers.En Python 3.12, propagate es un atributo de instancia de logging.Logger, no un método. Su valor predeterminado es True. La llamada logger.addHandler(handler) añade un manejador directamente a ese logger sin cambiar propagate.
Si un evento supera el umbral efectivo y los filtros del logger de origen, su registro se ofrece primero a los manejadores de ese logger. Con True, la propagación asciende por la jerarquía de nombres separados por puntos y puede llegar hasta el logger raíz. Si algún logger de la cadena tiene propagate = False, sus propios manejadores aún pueden procesar el registro, pero los de niveles superiores no lo reciben.
Al propagar el registro no se vuelven a comprobar los niveles ni los filtros de los loggers antecesores. Sí se aplican el nivel y los filtros de cada manejador. Esto no es lo mismo que heredar el nivel efectivo: si el logger de origen no es el raíz y su nivel es NOTSET, su umbral efectivo se determina mediante la jerarquía antes de propagar el registro.
Si un manejador local y otro de un antecesor escriben en el mismo destino, pueden aparecer entradas duplicadas. Configura los manejadores solo en un antecesor adecuado, o añade uno local y establece logger.propagate = False para aislar su salida. False por sí solo no garantiza el silencio: si no se encuentra ningún manejador en el recorrido, logging.lastResort puede emitir registros de nivel WARNING o superior.
Ejemplos
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")
Resultado
checkout: order received root: order received checkout: order saved
Ambos manejadores imprimen el primer registro `INFO`. El manejador de la raíz lo acepta aunque el propio logger raíz esté configurado en `ERROR`. Tras establecer `False`, solo el manejador de `checkout` imprime el segundo registro.
Lecciones relacionadas
- Python · Lección 24 · Intermedio · Versión: 3