Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

LoggerAdapter.error(): logowanie błędów z kontekstem zespołu

W Pythonie 3.12 użyj `LoggerAdapter.error()`, aby zapisywać komunikaty na poziomie `ERROR` z polem `team`, bez przekazywania tego pola przy każdym wywołaniu.

Wersja: Python 3.12

Składnia

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

Utwórz adapter za pomocą logging.LoggerAdapter(logger, extra={"team": "platform"}). Wywołanie adapter.error() zapisuje komunikat na poziomie ERROR za pośrednictwem wskazanego obiektu Logger. Funkcja modułu logging.error() korzysta natomiast z głównego loggera. Adapter nie ma własnego progu logowania: o tym, czy wpis trafi do wyjścia, decydują ustawienia loggera i jego handlerów.

Użyj adapter.error(), aby odnotować niepowodzenie. Samo wywołanie nie zgłasza wyjątku ani domyślnie nie dołącza śladu stosu. Wewnątrz except użyj adapter.exception(...) lub adapter.error(..., exc_info=True), aby dołączyć dane obsługiwanego wyjątku.

W Pythonie 3.12 domyślne process() zastępuje extra z pojedynczego wywołania kontekstem przekazanym konstruktorowi, zamiast je scalać. Pole team staje się atrybutem LogRecord; formater wyświetla je przez %(team)s. Nie używaj nazw wbudowanych atrybutów, takich jak levelname. Jeśli formater wymaga team, a rekord nie zawiera tego pola i nie ustawiono wartości domyślnej, formatowanie się nie powiedzie.

Przykłady

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")

Wynik

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

Uruchom jako osobny skrypt. Próg `INFO` przepuszcza wszystkie trzy wpisy, a `StreamHandler` zapisuje je na standardowe wyjście. `propagate = False` zapobiega przekazywaniu wpisów do handlerów loggerów nadrzędnych.

Powiązane lekcje

  • Python · Lekcja 27 · Zaawansowany · Wersja: 5

Źródła