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

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

Fontes