CKTIS / Python
Logging-Handler mit addHandler hinzufügen und wieder entfernen
Prüfe die direkt am Logger registrierten Handler, füge mit `addHandler()` einen konfigurierten Handler hinzu und leere die Liste über `removeHandler()` statt durch direkte Änderungen.
Version: Python 3.12
Syntax
logger.handlers
logger.addHandler(handler)
logger.removeHandler(handler)
# Detach all directly attached handlers during controlled reconfiguration:
for handler in tuple(logger.handlers):
logger.removeHandler(handler)In Python 3.12 enthält logger.handlers die direkt bei diesem Logger registrierten Handler, nicht die Handler übergeordneter Logger. Du kannst die Liste beispielsweise mit len(logger.handlers) prüfen, solltest sie aber als schreibgeschützt behandeln. logger.addHandler(handler) registriert eine vorhandene logging.Handler-Instanz, etwa einen logging.StreamHandler; der Aufruf selbst protokolliert keine Nachricht.
Verwende nicht logger.handlers.clear(): Der Aufruf leert die Liste, umgeht aber die Sperren von addHandler() und removeHandler(). Um bei einer kontrollierten Neukonfiguration alle direkten Handler zu entfernen, iteriere über tuple(logger.handlers) und rufe für jedes Element logger.removeHandler(handler) auf. Die Momentaufnahme verhindert, dass du über die Liste iterierst, die du gerade änderst, macht den gesamten Vorgang aber nicht atomar. Das Entfernen schließt den Handler nicht. Rufe handler.close() separat auf, wenn du für den Handler zuständig bist und er nicht mehr verwendet wird.
Ist propagate aktiviert, kann ein Datensatz auch die Handler übergeordneter Logger erreichen und dadurch mehrfach ausgegeben werden. logger.propagate = False stoppt diese Weiterleitung. Eine leere Liste direkter Handler garantiert keine Stille: Wird entlang der Weiterleitungskette kein Handler gefunden, kann logging.lastResort den Datensatz verarbeiten.
Beispiele
import logging
import sys
logger = logging.getLogger("cktis.lesson27")
logger.setLevel(logging.INFO)
logger.propagate = False
console = logging.StreamHandler(sys.stdout)
console.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
print(len(logger.handlers))
try:
logger.addHandler(console)
print(len(logger.handlers))
logger.info("ready")
finally:
for attached in tuple(logger.handlers):
logger.removeHandler(attached)
console.close()
print(len(logger.handlers))Ergebnis
0 1 INFO: ready 0
Führe das Skript in einem frischen Python-3.12-Prozess aus. Die Zahlen `0`, `1` und `0` geben die Anzahl direkter Handler vor dem Hinzufügen, danach und nach dem Entfernen an. Der Handler schreibt `INFO: ready` auf die Standardausgabe.
Zugehörige Lektionen
- Python · Lektion 27 · Fortgeschritten · Version: 5
Quellen
- Logging facility for Python — Logger.handlers
- Logging facility for Python — Logger.addHandler
- Logging facility for Python — Logger.removeHandler
- Logging facility for Python — Logger.propagate
- Logging facility for Python — Handler.close
- Logging facility for Python — logging.lastResort
- Logging handlers — StreamHandler
- Logging Cookbook — Using a context manager for selective logging