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

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

Fuentes