KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

Een logginghandler koppelen en doorgifte stoppen

Koppel met `addHandler()` een handler aan een specifieke logger en gebruik `propagate = False` om te voorkomen dat logrecords de handlers van bovenliggende loggers bereiken, inclusief die van de rootlogger.

Versie: Python 3.12

Syntax

logger.addHandler(hdlr)
logger.propagate = False

logging.Logger.addHandler koppelt een bestaand handlerobject aan een specifieke logger. Haal de logger op met logging.getLogger(name) en geef aan logger.addHandler(hdlr) een object door, zoals een instantie van logging.StreamHandler, niet de klasse zelf. De handler bepaalt de bestemming; de formatter van die handler bepaalt hoe de tekst eruitziet. Koppel de handler los met logger.removeHandler(hdlr) in plaats van logger.handlers rechtstreeks te wijzigen.

De logger waar het record ontstaat, past eerst zijn effectieve niveau en eigen filters toe. Een geaccepteerd record wordt aangeboden aan lokale handlers en, met de standaardinstelling propagate = True, aan de handlers van opeenvolgende bovenliggende loggers, tenzij de doorgifte onderweg stopt. De niveaus en filters van die loggers worden bij doorgifte niet gecontroleerd, maar elke handler past nog steeds zijn eigen drempel en filters toe.

Met logger.propagate = False stopt de doorgifte na deze logger, nadat de lokale handlers het record hebben kunnen verwerken. Dit schakelt de logger niet uit en wijzigt de configuratie van de rootlogger niet: geen handler hoger in die tak ontvangt het record. Als lokale en bovenliggende handlers naar dezelfde bestemming schrijven, kan de uitvoer dubbel lijken. Als één gedeelde bestemming volstaat, koppel de handler dan alleen aan de juiste bovenliggende logger en laat doorgifte ingeschakeld.

Voorbeelden

import logging
import sys

logging.basicConfig(
    level=logging.WARNING,
    stream=sys.stdout,
    format="root: %(message)s",
)

logger = logging.getLogger("cktis.demo")
logger.setLevel(logging.INFO)
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("local: %(message)s"))
logger.addHandler(handler)

logger.info("first")
logger.propagate = False
logger.info("second")

Resultaat

local: first
root: first
local: second

Voer het script uit in een nieuw Python 3.12-proces. `first` verschijnt twee keer, met `local:` en met `root:`. Het niveau `WARNING` van de rootlogger houdt het doorgegeven `INFO`-record niet tegen, want het gaat rechtstreeks naar de handler van de rootlogger. Nadat doorgifte is uitgeschakeld, verschijnt `second` alleen met `local:`.

Gerelateerde lessen

  • Python · Les 24 · Gemiddeld · Versie: 3

Bronnen