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