CKTIS / Python
LoggerAdapter.error(): registar erros com o contexto da equipa
Em Python 3.12, usa `LoggerAdapter.error()` para registar mensagens de nível `ERROR` com um campo `team`, sem teres de passar o campo em cada chamada.
Versão: Python 3.12
Sintaxe
adapter = logging.LoggerAdapter(logger, extra={"team": team})
adapter.error(msg, *args, **kwargs)Cria o adaptador com logging.LoggerAdapter(logger, extra={"team": "platform"}). adapter.error() regista mensagens de nível ERROR através do Logger fornecido, ao contrário da função do módulo logging.error(), que usa o logger raiz. O adaptador não tem um limiar próprio: as definições do logger e dos seus handlers determinam se um registo é emitido.
Usa adapter.error() para indicar uma falha. A chamada não lança por si só uma exceção nem inclui, por predefinição, um traceback. Dentro de except, usa adapter.exception(...) ou adapter.error(..., exc_info=True) para incluir a exceção que está a ser tratada.
Em Python 3.12, a implementação predefinida de process() substitui o extra de cada chamada pelo contexto do construtor, em vez de os combinar. O campo team torna-se um atributo do LogRecord; o formatador apresenta-o com %(team)s. Evita nomes de atributos incorporados como levelname. Se o formatador esperar team e o registo não tiver esse campo, a formatação falha, a menos que exista um valor predefinido.
Exemplos
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
Executa o código como um script autónomo. O limiar `INFO` deixa passar os três registos e o `StreamHandler` escreve-os na saída padrão. `propagate = False` impede o seu encaminhamento para os handlers dos loggers ascendentes.
Lições relacionadas
- Python · Lição 27 · Avançado · Versão: 5