CKTIS / Python
`logging.Logger.propagate`: propagar registos de log
`propagate` determina se um registo também chega aos processadores dos loggers antecessores. `False` interrompe a propagação ascendente sem desativar os processadores locais.
Versão: Python 3.12
Sintaxe
logger.addHandler(handler)
logger.propagate = False # Stop forwarding to ancestor handlers.
logger.propagate = True # Allow forwarding to ancestor handlers.Em Python 3.12, propagate é um atributo de instância de logging.Logger, não um método. O valor predefinido é True. A chamada logger.addHandler(handler) associa um processador (handler) diretamente a esse logger sem alterar propagate.
Se um evento passar o limiar efetivo e os filtros do logger de origem, o seu registo é disponibilizado primeiro aos processadores desse logger. Com True, a propagação sobe pela hierarquia de nomes separados por pontos e pode chegar ao logger raiz. Se um logger na cadeia tiver propagate = False, os seus processadores ainda podem tratar o registo, mas os dos níveis superiores não o recebem.
Durante a propagação, não se voltam a verificar os níveis nem os filtros dos loggers antecessores. O nível e os filtros de cada processador continuam a aplicar-se. Isto é diferente de herdar o nível efetivo: se o logger de origem não for a raiz e tiver o nível NOTSET, o seu limiar efetivo é determinado a partir da hierarquia antes da propagação.
Se um processador local e outro de um antecessor escreverem para o mesmo destino, podem surgir entradas duplicadas. Configura os processadores apenas num antecessor adequado, ou associa um processador local e define logger.propagate = False para isolar a respetiva saída. False, por si só, não garante silêncio: se não for encontrado nenhum processador no percurso, logging.lastResort pode emitir registos de nível WARNING ou superior.
Exemplos
import logging
import sys
def console_handler(label):
handler = logging.StreamHandler(sys.stdout)
handler.setLevel(logging.INFO)
handler.setFormatter(logging.Formatter(f"{label}: %(message)s"))
return handler
root = logging.getLogger()
root.setLevel(logging.ERROR)
root.addHandler(console_handler("root"))
logger = logging.getLogger("checkout")
logger.setLevel(logging.INFO)
logger.addHandler(console_handler("checkout"))
logger.propagate = True
logger.info("order received")
logger.propagate = False
logger.info("order saved")
Resultado
checkout: order received root: order received checkout: order saved
Os dois processadores escrevem o primeiro registo `INFO`. O processador da raiz aceita-o apesar de o próprio logger raiz estar configurado com `ERROR`. Depois de definir `False`, só o processador de `checkout` escreve o segundo registo.
Lições relacionadas
- Python · Lição 24 · Intermédio · Versão: 3