Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła