WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Ereignisse mit Logger.debug, info, warning und error protokollieren

Wähle die Methode eines benannten Loggers nach dem Schweregrad des Ereignisses und erkenne, wie Logger und Handler die sichtbaren Meldungen bestimmen.

Version: Python 3.12

Syntax

logger = logging.getLogger(name)
logger.debug(msg, *args, **kwargs)
logger.info(msg, *args, **kwargs)
logger.warning(msg, *args, **kwargs)
logger.error(msg, *args, **kwargs)

In Python 3.12 erhältst du einen benannten Logger mit logging.getLogger(name), in einem Modul meist mit logging.getLogger(__name__). Rufe debug, info, warning und error auf der zurückgegebenen Logger-Instanz auf. Derselbe Name liefert erneut dieselbe Instanz. Modulfunktionen wie logging.info() verwenden dagegen den Root-Logger und rufen basicConfig() auf, wenn er keine Handler hat. Instanzmethoden konfigurieren den Root-Logger nicht automatisch.

Nach aufsteigendem Schweregrad: debug() dient für Diagnosedetails (DEBUG), info() für gewöhnliche Ereignisse (INFO), warning() für ein mögliches oder unerwartetes Problem, bei dem das Programm weiterarbeiten kann (WARNING), und error() für einen fehlgeschlagenen Vorgang (ERROR). Verwende warning() statt des veralteten warn(). Das Protokollieren einer Ausnahme auf der Stufe ERROR löst diese Ausnahme nicht erneut aus. Der Aufruf von error() kann jedoch selbst eine Ausnahme auslösen, etwa einen KeyError, wenn extra ein reserviertes Feld eines LogRecord überschreiben soll.

Alle vier Methoden akzeptieren msg, *args, **kwargs. Übergib Werte separat, etwa mit logger.debug("Items scanned: %d", 3): Beim Formatieren setzt das Logging die Werte mit % ein. Ohne Positionsargumente nach msg wird nichts ersetzt. Die Schlüsselwortoptionen sind exc_info (Ausnahmeinformationen), stack_info (aktueller Aufrufstapel), stacklevel (aufgezeichnete Aufrufstelle) und extra (eigene Felder im Log-Datensatz).

Der effektive Pegel des Loggers ist eine Schwelle: INFO verwirft DEBUG. Bei NOTSET sucht ein benannter Logger nach dem Pegel seiner Vorfahren; der Root-Logger hat standardmäßig WARNING. Handler können eigene Schwellen und Filter anwenden. Bei der Weitergabe an Handler übergeordneter Logger werden die Pegel und Filter dieser Logger nicht erneut geprüft.

Beispiele

import logging
import sys

logging.basicConfig(
    level=logging.DEBUG,
    stream=sys.stdout,
    format="%(levelname)s %(name)s: %(message)s",
)
logger = logging.getLogger("inventory")

logger.debug("Items scanned: %d", 3)
logger.info("Inventory loaded")
logger.warning("Stock is low")
logger.error("Could not save inventory")

logger.setLevel(logging.INFO)
logger.debug("This line is filtered out")

Ergebnis

DEBUG inventory: Items scanned: 3
INFO inventory: Inventory loaded
WARNING inventory: Stock is low
ERROR inventory: Could not save inventory

Führe das Skript in einem neuen Python-3.12-Prozess aus. `basicConfig()` setzt den Root-Pegel auf `DEBUG` und leitet die Ausgabe an `sys.stdout`. Vier Zeilen erscheinen; nach `logger.setLevel(logging.INFO)` wird die letzte `DEBUG`-Meldung verworfen.

Zugehörige Lektionen

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

Quellen