CKTIS / Python
Ostrzeżenia z kontekstem zespołu w `LoggerAdapter`
Utwórz `logging.LoggerAdapter` z istniejącego loggera i pola `team`, aby komunikaty `info`, `warning` i `error` zawierały ten sam kontekst zespołu.
Wersja: Python 3.12
Składnia
adapter = logging.LoggerAdapter(logger, {"team": "Platform"})
adapter.info(msg, *args, **kwargs)
adapter.warning(msg, *args, **kwargs)
adapter.error(msg, *args, **kwargs)W Pythonie 3.12 logging.LoggerAdapter(logger, {"team": "Platform"}) otacza istniejący logger i przekazuje mu wywołania z kontekstem zespołu. adapter.warning(...) rejestruje zdarzenie na poziomie WARNING, gdy coś odbiega od oczekiwań lub może sprawić problem. adapter.info(...) służy do rejestrowania zwykłego przebiegu pracy (INFO), a adapter.error(...) — niepowodzenia operacji (ERROR). To nie są funkcje modułowe logging.info, logging.warning i logging.error: te używają loggera głównego i nie otrzymują automatycznie kontekstu adaptera.
Domyślne process() w Pythonie 3.12 pozostawia komunikat bez zmian i przekazuje mapowanie z konstruktora jako extra. Jeśli podasz extra w pojedynczym wywołaniu adaptera, zostanie ono zastąpione, a nie połączone z tym mapowaniem. team staje się atrybutem LogRecord, więc Formatter może wyświetlić go przez %(team)s. Klucze w extra nie mogą kolidować z zarezerwowanymi atrybutami rekordu.
Każdy rekord obsługiwany przez taki formater musi zawierać team; bez niego formatowanie się nie powiedzie. O tym, czy komunikat zostanie wyświetlony, nadal decyduje konfiguracja loggera i handlera. W przykładzie próg INFO przepuszcza wszystkie trzy poziomy.
Przykłady
import logging
import sys
logger = logging.getLogger("ck tis.deployment".replace(" ", ""))
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, {"team": "Platform"})
adapter.info("Deployment started")
adapter.warning("Retrying health check")
adapter.error("Deployment failed")Wynik
INFO [Platform] Deployment started WARNING [Platform] Retrying health check ERROR [Platform] Deployment failed
Uruchom jako samodzielny skrypt w Pythonie 3.12. Handler zapisuje na standardowe wyjście, a wyłączenie propagacji zapobiega przekazywaniu rekordów do nadrzędnych loggerów. Oczekiwany wynik to trzy wiersze z `[Platform]`.
Powiązane lekcje
- Python · Lekcja 27 · Zaawansowany · Wersja: 5