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

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

Fuentes