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

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 = False

logging.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

Fuentes