CKTIS / Python
Añadir un manejador de registros y detener la propagación
Usa `addHandler()` para añadir un manejador a un registrador concreto y `propagate = False` para impedir que sus registros lleguen a los manejadores de los registradores antecesores, incluido el registrador raíz.
Versión: Python 3.12
Sintaxis
logger.addHandler(hdlr)
logger.propagate = Falselogging.Logger.addHandler añade un objeto manejador existente a un registrador concreto. Obtén el registrador con logging.getLogger(name) y pasa a logger.addHandler(hdlr) un objeto como una instancia de logging.StreamHandler, no la clase en sí. El manejador determina el destino y su formateador determina el aspecto del texto. Para desvincular el manejador, llama a logger.removeHandler(hdlr) en lugar de modificar logger.handlers directamente.
El registrador de origen aplica primero su nivel efectivo y sus propios filtros. Si acepta el registro, se lo ofrece a sus manejadores locales y, con propagate = True por defecto, a los manejadores de los sucesivos registradores antecesores, salvo que se detenga la propagación. En ese recorrido no se comprueban los niveles ni los filtros de los registradores antecesores, pero cada manejador sigue aplicando su propio umbral y sus propios filtros.
logger.propagate = False detiene el envío hacia arriba después de que los manejadores locales hayan tenido la oportunidad de procesar el registro. No desactiva el registrador ni reconfigura el registrador raíz: ningún manejador situado más arriba en esa rama recibe el registro. Si los manejadores locales y los de los antecesores escriben en el mismo destino, la propagación puede producir lo que parecen duplicados. Si basta con un destino compartido, añade el manejador solo al antecesor adecuado y deja activada la propagación.
Ejemplos
import logging
import sys
logging.basicConfig(
level=logging.WARNING,
stream=sys.stdout,
format="root: %(message)s",
)
logger = logging.getLogger("cktis.demo")
logger.setLevel(logging.INFO)
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("local: %(message)s"))
logger.addHandler(handler)
logger.info("first")
logger.propagate = False
logger.info("second")
Resultado
local: first root: first local: second
Ejecuta el script en un proceso nuevo de Python 3.12. `first` aparece dos veces, con `local:` y con `root:`. El nivel `WARNING` del registrador raíz no bloquea el registro propagado de nivel `INFO`, porque este llega directamente a su manejador. Al desactivar la propagación, `second` solo aparece con `local:`.
Lecciones relacionadas
- Python · Lección 24 · Intermedio · Versión: 3