WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

LoggerAdapter.error(): Fehler mit Teamkontext protokollieren

Mit `LoggerAdapter.error()` protokollierst du in Python 3.12 auf der Stufe `ERROR` mit einem Feld `team`, ohne es bei jedem Aufruf zu übergeben.

Version: Python 3.12

Syntax

adapter = logging.LoggerAdapter(logger, extra={"team": team})
adapter.error(msg, *args, **kwargs)

Erzeuge den Adapter mit logging.LoggerAdapter(logger, extra={"team": "platform"}). adapter.error() protokolliert auf der Stufe ERROR über den übergebenen Logger. Die Modulfunktion logging.error() verwendet dagegen den Root-Logger. Der Adapter hat keine eigene Mindeststufe: Die Einstellungen des Loggers und seiner Handler bestimmen, ob ein Eintrag ausgegeben wird.

Verwende adapter.error(), um einen Fehlschlag zu melden. Der Aufruf löst selbst keine Ausnahme aus und gibt standardmäßig keinen Traceback aus. Verwende innerhalb von except den Aufruf adapter.exception(...) oder adapter.error(..., exc_info=True), um die behandelte Ausnahme mit zu protokollieren.

In Python 3.12 ersetzt die Standardimplementierung von process() ein beim Aufruf übergebenes extra durch den Kontext aus dem Konstruktor, statt beide zusammenzuführen. team wird zum Attribut des LogRecord; der Formatter gibt es mit %(team)s aus. Vermeide Namen eingebauter Attribute wie levelname. Erwartet der Formatter team, obwohl das Feld im Eintrag fehlt, schlägt die Formatierung fehl, sofern kein Standardwert eingerichtet ist.

Beispiele

import logging
import sys

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

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

adapter = logging.LoggerAdapter(logger, extra={"team": "platform"})
adapter.info("Deployment started for %s", "api")
adapter.warning("Health check is slow")
adapter.error("Deployment failed")

Ergebnis

INFO [platform] Deployment started for api
WARNING [platform] Health check is slow
ERROR [platform] Deployment failed

Führe das Beispiel als eigenständiges Skript aus. Die Mindeststufe `INFO` lässt alle drei Einträge durch, und der `StreamHandler` schreibt sie auf die Standardausgabe. `propagate = False` verhindert die Weiterleitung an Handler übergeordneter Logger.

Zugehörige Lektionen

  • Python · Lektion 27 · Fortgeschritten · Version: 5

Quellen