Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes