WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Untergeordneten Logger mit Logger.getChild abrufen

Rufe einen Logger relativ zum Namen seines übergeordneten Loggers ab und leite seine Einträge an dessen Handler weiter, ohne den Handler zu kopieren.

Version: Python 3.12

Syntax

parent_logger.getChild(suffix)

logging.Logger.getChild(suffix) ist eine Instanzmethode, die seit Python 3.2 verfügbar ist. Bei einem Logger, der nicht der Root-Logger ist, hängt sie einen Punkt und das Suffix als Zeichenkette an den Namen an und ruft den Logger mit dem entstandenen Namen ab. Beim Root-Logger verwendet sie das Suffix direkt, ohne das Präfix root.. Wenn app der Logger namens app ist, liefern app.getChild("validation") und logging.getLogger("app.validation") dasselbe Objekt. Das Suffix darf Punkte enthalten: validation.rules bezeichnet einen tiefer untergeordneten Logger.

Die Methode kopiert keine Handler. Wenn app.validation einen Eintrag annimmt und propagate=True gilt (die Voreinstellung), gelangt der Eintrag auch zu den Handlern von app. app.propagate = False lässt diese Handler aktiv, verhindert aber die weitere Weitergabe an den Root-Logger.

Die Schwellenwerte von Logger und Handler greifen an unterschiedlichen Stellen. Bleibt die Stufe von app.validation auf NOTSET, verwendet der Logger im Beispiel INFO von app als effektive Stufe. Nach der Annahme des Eintrags werden bei der Weitergabe die Stufen und Filter übergeordneter Logger nicht erneut geprüft. Jeder Handler wendet aber weiterhin seinen eigenen Schwellenwert und seine Filter an. Ist derselbe Handler am untergeordneten und am übergeordneten Logger registriert, kann er den Eintrag zweimal ausgeben.

Beispiele

import logging
import sys

app = logging.getLogger("app")
app.setLevel(logging.INFO)
app.propagate = False

handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(name)s | %(levelname)s | %(message)s"))
app.addHandler(handler)

validation = app.getChild("validation")
assert validation is logging.getLogger("app.validation")
validation.info("Input accepted")

Ergebnis

app.validation | INFO | Input accepted

Führe das Skript in einem frischen Python-3.12-Prozess aus. Die Assertion prüft mit `is` die Objektidentität. Der einzige Handler hängt an `app`, aber in der Ausgabe steht `app.validation`, weil dieser Logger den Eintrag erzeugt hat.

Zugehörige Lektionen

  • Python · Lektion 24 · Mittlere Stufe · Version: 3

Quellen