WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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