CKTIS / Python
LoggerAdapter.error(): registrar errores con contexto de equipo
En Python 3.12, usa `LoggerAdapter.error()` para registrar mensajes de nivel `ERROR` con un campo `team`, sin tener que pasarlo en cada llamada.
Versión: Python 3.12
Sintaxis
adapter = logging.LoggerAdapter(logger, extra={"team": team})
adapter.error(msg, *args, **kwargs)Crea el adaptador con logging.LoggerAdapter(logger, extra={"team": "platform"}). adapter.error() registra mensajes de nivel ERROR a través del Logger proporcionado. En cambio, la función del módulo logging.error() usa el registrador raíz. El adaptador no tiene un umbral propio: la configuración del registrador y de sus manejadores determina si se emite un registro.
Usa adapter.error() para comunicar un fallo. La llamada no lanza por sí misma una excepción ni incluye por defecto una traza de pila. Dentro de except, usa adapter.exception(...) o adapter.error(..., exc_info=True) para incluir la excepción que se está gestionando.
En Python 3.12, la implementación predeterminada de process() sustituye el extra de una llamada por el contexto del constructor, en lugar de combinarlos. El campo team se convierte en un atributo de LogRecord; el formateador lo muestra con %(team)s. Evita los nombres de atributos incorporados como levelname. Si el formateador espera team y el registro no tiene ese campo, el formateo falla salvo que se haya configurado un valor predeterminado.
Ejemplos
import logging
import sys
logger = logging.getLogger("deploy")
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, extra={"team": "platform"})
adapter.info("Deployment started for %s", "api")
adapter.warning("Health check is slow")
adapter.error("Deployment failed")Resultado
INFO [platform] Deployment started for api WARNING [platform] Health check is slow ERROR [platform] Deployment failed
Ejecuta el código como un script independiente. El umbral `INFO` permite los tres registros y el `StreamHandler` los escribe en la salida estándar. `propagate = False` impide que se reenvíen a los manejadores de los registradores antecesores.
Lecciones relacionadas
- Python · Lección 27 · Avanzado · Versión: 5