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