CKTIS / Python
Registrar eventos con Logger.debug, info, warning y error
Elige un método de un registrador con nombre según la gravedad del evento y comprueba cómo el registrador y los manejadores determinan qué mensajes aparecen.
Versión: Python 3.12
Sintaxis
logger = logging.getLogger(name)
logger.debug(msg, *args, **kwargs)
logger.info(msg, *args, **kwargs)
logger.warning(msg, *args, **kwargs)
logger.error(msg, *args, **kwargs)En Python 3.12, obtén un registrador con nombre mediante logging.getLogger(name), normalmente logging.getLogger(__name__) en un módulo. Llama a debug, info, warning y error en la instancia de Logger devuelta. Pedir el mismo nombre devuelve la misma instancia. Las funciones del módulo, como logging.info(), usan en cambio el registrador raíz y llaman a basicConfig() si no tiene manejadores. Los métodos de instancia no configuran automáticamente el registrador raíz.
De menor a mayor gravedad, usa debug() para detalles de diagnóstico (DEBUG), info() para eventos habituales (INFO), warning() para un problema posible o inesperado que permite al programa seguir funcionando (WARNING) y error() cuando una operación ha fallado (ERROR). Usa warning() en lugar del obsoleto warn(). Registrar una excepción en el nivel ERROR no vuelve a lanzarla. Sin embargo, la llamada a error() puede lanzar una excepción, por ejemplo, KeyError si extra intenta sobrescribir un campo reservado de un LogRecord.
Los cuatro métodos aceptan msg, *args, **kwargs. Pasa los valores por separado, como en logger.debug("Items scanned: %d", 3): la sustitución mediante % se realiza al formatear el mensaje. Sin argumentos posicionales después de msg, no se hace ninguna sustitución. Las opciones con nombre son exc_info (detalles de la excepción), stack_info (pila de llamadas actual), stacklevel (ubicación de llamada que se registra) y extra (campos personalizados del registro).
El nivel efectivo del registrador es un umbral: INFO descarta DEBUG. Con NOTSET, un registrador con nombre busca un nivel en sus antecesores; el nivel predeterminado de la raíz es WARNING. Los manejadores pueden aplicar sus propios umbrales y filtros. Cuando un registro se propaga a los manejadores de los antecesores, no vuelven a comprobarse los niveles ni los filtros de esos registradores.
Ejemplos
import logging
import sys
logging.basicConfig(
level=logging.DEBUG,
stream=sys.stdout,
format="%(levelname)s %(name)s: %(message)s",
)
logger = logging.getLogger("inventory")
logger.debug("Items scanned: %d", 3)
logger.info("Inventory loaded")
logger.warning("Stock is low")
logger.error("Could not save inventory")
logger.setLevel(logging.INFO)
logger.debug("This line is filtered out")Resultado
DEBUG inventory: Items scanned: 3 INFO inventory: Inventory loaded WARNING inventory: Stock is low ERROR inventory: Could not save inventory
Ejecuta el script en un proceso nuevo de Python 3.12. `basicConfig()` fija el nivel de la raíz en `DEBUG` y dirige la salida a `sys.stdout`. Aparecen cuatro líneas; después de `logger.setLevel(logging.INFO)`, se descarta el último mensaje `DEBUG`.
Lecciones relacionadas
- Python · Lección 24 · Intermedio · Versión: 3