CKTIS / Python
Registar eventos com Logger.debug, info, warning e error
Escolhe um método de um logger com nome consoante a gravidade do evento e vê como a configuração do logger e dos processadores determina as mensagens apresentadas.
Versão: Python 3.12
Sintaxe
logger = logging.getLogger(name)
logger.debug(msg, *args, **kwargs)
logger.info(msg, *args, **kwargs)
logger.warning(msg, *args, **kwargs)
logger.error(msg, *args, **kwargs)Em Python 3.12, obtém um logger com nome através de logging.getLogger(name), normalmente logging.getLogger(__name__) num módulo. Chama debug, info, warning e error na instância de Logger devolvida. Pedir o mesmo nome devolve a mesma instância. As funções do módulo, como logging.info(), usam antes o logger raiz e chamam basicConfig() se este não tiver processadores (handlers). Os métodos de instância não configuram automaticamente o logger raiz.
Por ordem crescente de gravidade, usa debug() para detalhes de diagnóstico (DEBUG), info() para eventos habituais (INFO), warning() para um problema possível ou inesperado que não impede o programa de continuar (WARNING) e error() quando uma operação falhou (ERROR). Usa warning() em vez do obsoleto warn(). Registar uma exceção ao nível ERROR não volta a lançá-la. No entanto, a chamada a error() pode lançar uma exceção, por exemplo, um KeyError se extra tentar sobrescrever um campo reservado de um LogRecord.
Os quatro métodos aceitam msg, *args, **kwargs. Passa os valores separadamente, como em logger.debug("Items scanned: %d", 3): a substituição com % é feita ao formatar a mensagem. Sem argumentos posicionais depois de msg, não há substituição. As opções nomeadas são exc_info (detalhes da exceção), stack_info (pilha de chamadas atual), stacklevel (local da chamada que fica registado) e extra (campos personalizados do registo).
O nível efetivo do logger funciona como limiar: INFO descarta DEBUG. Com NOTSET, um logger com nome procura um nível nos seus antepassados; o nível predefinido da raiz é WARNING. Os processadores podem aplicar os seus próprios limiares e filtros. Ao propagar um registo aos processadores dos antepassados, não se voltam a verificar os níveis nem os filtros desses loggers.
Exemplos
import logging
import sys
logging.basicConfig(
level=logging.DEBUG,
stream=sys.stdout,
format="%(levelname)s %(name)s: %(message)s",
)
logger = logging.getLogger("inventory")
logger.debug("Items scanned: %d", 3)
logger.info("Inventory loaded")
logger.warning("Stock is low")
logger.error("Could not save inventory")
logger.setLevel(logging.INFO)
logger.debug("This line is filtered out")Resultado
DEBUG inventory: Items scanned: 3 INFO inventory: Inventory loaded WARNING inventory: Stock is low ERROR inventory: Could not save inventory
Executa o script num novo processo de Python 3.12. `basicConfig()` define o nível da raiz como `DEBUG` e envia a saída para `sys.stdout`. São apresentadas quatro linhas; depois de `logger.setLevel(logging.INFO)`, a última mensagem `DEBUG` é descartada.
Lições relacionadas
- Python · Lição 24 · Intermédio · Versão: 3