CKTIS / Python
Fijar el umbral de un logger con nombre mediante setLevel()
Configura un logger con nombre en `logging.INFO` para descartar `DEBUG` y dejar pasar `INFO` y los niveles superiores. El manejador sigue determinando qué llega a la salida.
Versión: Python 3.12
Sintaxis
logger = logging.getLogger(name)
logger.setLevel(level) # e.g. logging.INFO or "INFO"El método de instancia logging.Logger.setLevel fija el umbral del logger sobre el que lo llamas. En Python 3.12, logging.getLogger("root") devuelve el logger raíz, por lo que llamar a setLevel() sobre ese logger fija su umbral. Si vuelves a consultar el mismo nombre, obtienes el mismo objeto. Pasa una constante entera como logging.INFO o un nombre de nivel como "INFO". Con ese umbral, se descarta DEBUG; INFO, WARNING, ERROR y CRITICAL superan la comprobación de nivel del logger.
Un logger nuevo que no sea el raíz comienza con logging.NOTSET. Su umbral efectivo es entonces el del ancestro más cercano cuyo nivel no sea NOTSET. Si todos sus ancestros, incluido el logger raíz, también tienen el nivel NOTSET, su nivel efectivo es NOTSET. El nivel predeterminado del logger raíz es WARNING. Consulta el umbral efectivo con logger.getEffectiveLevel().
setLevel() no añade un manejador ni elige un destino. Cada manejador tiene su propio umbral (Handler.setLevel) y puede aplicar filtros, así que un registro aceptado por el logger podría no producir salida. Durante la propagación, los registros van directamente a los manejadores de los ancestros sin volver a comprobar los niveles ni los filtros de esos loggers. logger.propagate = False detiene el envío a los ancestros.
Ejemplos
import logging
import sys
logger = logging.getLogger("cktis.checkout")
logger.setLevel(logging.INFO)
logger.propagate = False
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
logger.addHandler(handler)
logger.debug("Checking cart")
logger.info("Order accepted")
logger.warning("Receipt delayed")Resultado
INFO: Order accepted WARNING: Receipt delayed
El manejador escribe en `sys.stdout` y su nivel predeterminado `NOTSET` no descarta registros por su gravedad. Con la propagación desactivada, en un proceso nuevo el logger descarta `DEBUG` y aparecen `INFO` y `WARNING` una vez cada uno.
Lecciones relacionadas
- Python · Lección 27 · Avanzado · Versión: 5
- Python · Lección 24 · Intermedio · Versión: 3