WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Den Schwellenwert eines benannten Loggers mit setLevel() festlegen

Mit `logging.INFO` verwirft ein benannter Logger Meldungen der Stufe `DEBUG`. `INFO` und höhere Stufen passieren die Prüfung des Loggers; der Handler entscheidet weiterhin über die Ausgabe.

Version: Python 3.12

Syntax

logger = logging.getLogger(name)
logger.setLevel(level)  # e.g. logging.INFO or "INFO"

Die Instanzmethode logging.Logger.setLevel legt den Schwellenwert des Loggers fest, auf dem du sie aufrufst. In Python 3.12 liefert logging.getLogger("root") den Root-Logger. Ein Aufruf von setLevel() auf diesem Logger legt also dessen Schwellenwert fest. Derselbe Name liefert bei erneutem Abruf dasselbe Objekt. Übergib eine Ganzzahlkonstante wie logging.INFO oder einen Stufennamen wie "INFO". Bei dieser Schwelle wird DEBUG verworfen; INFO, WARNING, ERROR und CRITICAL passieren die Stufenprüfung des Loggers.

Ein neuer Logger, der nicht der Root-Logger ist, beginnt mit logging.NOTSET. Seine wirksame Schwelle richtet sich dann nach dem nächstgelegenen Vorfahren mit einer anderen Stufe als NOTSET. Stehen alle Vorfahren einschließlich des Root-Loggers ebenfalls auf NOTSET, ist die wirksame Stufe NOTSET. Der Root-Logger steht standardmäßig auf WARNING. Mit logger.getEffectiveLevel() kannst du die wirksame Schwelle abfragen.

setLevel() fügt keinen Handler hinzu und wählt kein Ausgabeziel. Jeder Handler hat eine eigene Schwelle (Handler.setLevel) und kann Filter verwenden. Ein vom Logger akzeptierter Eintrag kann also trotzdem ohne Ausgabe bleiben. Bei der Weiterleitung gehen Einträge direkt an die Handler der Vorfahren, ohne deren Logger-Stufen oder -Filter erneut zu prüfen. logger.propagate = False unterbindet die Weiterleitung an Vorfahren.

Beispiele

import logging
import sys

logger = logging.getLogger("cktis.checkout")
logger.setLevel(logging.INFO)
logger.propagate = False

handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
logger.addHandler(handler)

logger.debug("Checking cart")
logger.info("Order accepted")
logger.warning("Receipt delayed")

Ergebnis

INFO: Order accepted
WARNING: Receipt delayed

Der Handler schreibt nach `sys.stdout` und verwirft mit seiner Standardstufe `NOTSET` keine Einträge aufgrund ihrer Stufe. Da die Weiterleitung aus ist, verwirft der Logger in einem frischen Prozess `DEBUG`; `INFO` und `WARNING` erscheinen je einmal.

Zugehörige Lektionen

  • Python · Lektion 27 · Fortgeschritten · Version: 5
  • Python · Lektion 24 · Mittlere Stufe · Version: 3

Quellen