Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

Definir o limiar de um logger com nome com setLevel()

Define um logger com nome para `logging.INFO`: `DEBUG` é descartado e `INFO` e os níveis superiores passam o limiar do logger. O handler continua a decidir o que é escrito.

Versão: Python 3.12

Sintaxe

logger = logging.getLogger(name)
logger.setLevel(level)  # e.g. logging.INFO or "INFO"

O método de instância logging.Logger.setLevel define o limiar do logger em que o invocas. Em Python 3.12, logging.getLogger("root") devolve o logger de raiz, pelo que invocar setLevel() nesse logger define o seu limiar. Voltar a procurar o mesmo nome devolve o mesmo objeto. Passa uma constante inteira como logging.INFO ou um nome de nível como "INFO". Com esse limiar, DEBUG é descartado; INFO, WARNING, ERROR e CRITICAL passam a verificação de nível do logger.

Um novo logger que não seja o de raiz começa com logging.NOTSET. O seu limiar efetivo é então o do antecessor mais próximo cujo nível seja diferente de NOTSET. Se todos os seus antecessores, incluindo o logger de raiz, também estiverem no nível NOTSET, o seu nível efetivo é NOTSET. O nível predefinido do logger de raiz é WARNING. Usa logger.getEffectiveLevel() para consultar o limiar efetivo.

setLevel() não adiciona um handler nem escolhe um destino. Cada handler tem o seu próprio limiar (Handler.setLevel) e pode aplicar filtros, pelo que um registo aceite pelo logger pode não ser escrito. Durante a propagação, os registos seguem diretamente para os handlers dos antecessores, sem voltar a verificar os níveis nem os filtros desses loggers. logger.propagate = False impede o encaminhamento para os antecessores.

Exemplos

import logging
import sys

logger = logging.getLogger("cktis.checkout")
logger.setLevel(logging.INFO)
logger.propagate = False

handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
logger.addHandler(handler)

logger.debug("Checking cart")
logger.info("Order accepted")
logger.warning("Receipt delayed")

Resultado

INFO: Order accepted
WARNING: Receipt delayed

O handler escreve em `sys.stdout` e o seu nível predefinido `NOTSET` não descarta registos com base na gravidade. Com a propagação desativada, num processo novo o logger descarta `DEBUG`, enquanto `INFO` e `WARNING` aparecem uma vez cada.

Lições relacionadas

  • Python · Lição 27 · Avançado · Versão: 5
  • Python · Lição 24 · Intermédio · Versão: 3

Fontes