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

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

Fuentes