CKTIS / Python
Registrar advertencias con contexto de equipo mediante `LoggerAdapter`
Envuelve un registrador existente en `logging.LoggerAdapter` con un campo `team` para que las llamadas a `info`, `warning` y `error` compartan el contexto del equipo.
Versión: Python 3.12
Sintaxis
adapter = logging.LoggerAdapter(logger, {"team": "Platform"})
adapter.info(msg, *args, **kwargs)
adapter.warning(msg, *args, **kwargs)
adapter.error(msg, *args, **kwargs)En Python 3.12, logging.LoggerAdapter(logger, {"team": "Platform"}) envuelve un registrador existente y le reenvía las llamadas con el contexto del equipo. Usa adapter.warning(...) para registrar un WARNING cuando ocurre algo inesperado o puede surgir un problema. adapter.info(...) indica progreso normal (INFO) y adapter.error(...) indica que una operación ha fallado (ERROR). En cambio, las funciones del módulo logging.info, logging.warning y logging.error usan el registrador raíz y no reciben automáticamente el contexto del adaptador.
En Python 3.12, la implementación predeterminada de process() deja intacto el mensaje y pasa el mapping del constructor como extra. Si pasas extra en una llamada al adaptador, se sustituye en lugar de combinarse con el del constructor. team pasa a ser un atributo de LogRecord, por lo que un Formatter puede mostrarlo con %(team)s. Las claves de extra no deben coincidir con atributos reservados del registro.
Todos los registros que procese ese formateador deben contener team; si falta, el formateo falla. La configuración del registrador y del manejador sigue determinando si se emite el mensaje. En el ejemplo, el umbral INFO deja pasar los tres niveles.
Ejemplos
import logging
import sys
logger = logging.getLogger("ck tis.deployment".replace(" ", ""))
logger.setLevel(logging.INFO)
logger.propagate = False
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(levelname)s [%(team)s] %(message)s"))
logger.addHandler(handler)
adapter = logging.LoggerAdapter(logger, {"team": "Platform"})
adapter.info("Deployment started")
adapter.warning("Retrying health check")
adapter.error("Deployment failed")Resultado
INFO [Platform] Deployment started WARNING [Platform] Retrying health check ERROR [Platform] Deployment failed
Ejecuta el código como un script independiente con Python 3.12. El manejador escribe en la salida estándar y la propagación desactivada impide que los registros lleguen a registradores superiores. Se esperan tres líneas, cada una con `[Platform]`.
Lecciones relacionadas
- Python · Lección 27 · Avanzado · Versión: 5