CKTIS / Python
Rejestrowanie zdarzeń: Logger.debug, info, warning i error
Wybierz metodę nazwanego loggera zgodnie z wagą zdarzenia i sprawdź, jak poziom loggera oraz konfiguracja obsługi wpływają na to, co pojawi się w logu.
Wersja: Python 3.12
Składnia
logger = logging.getLogger(name)
logger.debug(msg, *args, **kwargs)
logger.info(msg, *args, **kwargs)
logger.warning(msg, *args, **kwargs)
logger.error(msg, *args, **kwargs)W Pythonie 3.12 pobierz nazwany logger przez logging.getLogger(name), na przykład logging.getLogger(__name__) w module. Wywołuj metody debug, info, warning i error na zwróconym obiekcie Logger. Powtórne użycie tej samej nazwy zwraca tę samą instancję. Funkcje modułowe, takie jak logging.info(), działają natomiast na loggerze głównym i wywołują basicConfig(), jeśli nie ma on obiektów obsługi (handlerów). Metody instancji nie konfigurują go automatycznie.
W kolejności rosnącej wagi: debug() oznacza szczegóły diagnostyczne (DEBUG), info() — zwykłe zdarzenia (INFO), warning() — problem, który wystąpił lub może wystąpić, ale nie zatrzymuje działania programu (WARNING), a error() — niepowodzenie operacji (ERROR). Używaj warning(), nie przestarzałego warn(). Zapisanie informacji o wyjątku na poziomie ERROR nie powoduje ponownego zgłoszenia tego wyjątku. Samo wywołanie error() może jednak zgłosić wyjątek, na przykład KeyError, jeśli extra próbuje nadpisać zastrzeżone pole obiektu LogRecord.
Wszystkie cztery metody przyjmują msg, *args, **kwargs. Przekaż wartości osobno, np. logger.debug("Items scanned: %d", 3); logowanie podstawia je przez % przy formatowaniu komunikatu. Bez argumentów pozycyjnych po msg podstawianie nie zachodzi. Opcje nazwane to exc_info (informacje o wyjątku), stack_info (bieżący stos), stacklevel (wskazanie miejsca wywołania) i extra (własne pola rekordu).
Efektywny poziom loggera jest progiem: INFO odrzuca DEBUG. Przy NOTSET nazwany logger szuka poziomu u przodków; domyślny poziom loggera głównego to WARNING. Obiekty obsługi mogą dodatkowo stosować własne progi i filtry. Gdy rekord jest przekazywany do obiektów obsługi przodków, nie sprawdza się ponownie poziomów ani filtrów samych loggerów przodków.
Przykłady
import logging
import sys
logging.basicConfig(
level=logging.DEBUG,
stream=sys.stdout,
format="%(levelname)s %(name)s: %(message)s",
)
logger = logging.getLogger("inventory")
logger.debug("Items scanned: %d", 3)
logger.info("Inventory loaded")
logger.warning("Stock is low")
logger.error("Could not save inventory")
logger.setLevel(logging.INFO)
logger.debug("This line is filtered out")Wynik
DEBUG inventory: Items scanned: 3 INFO inventory: Inventory loaded WARNING inventory: Stock is low ERROR inventory: Could not save inventory
Uruchom skrypt w nowym procesie Pythona 3.12. `basicConfig()` konfiguruje logger główny z poziomem `DEBUG` i kieruje wyjście na `sys.stdout`. Pojawiają się cztery wiersze; po `logger.setLevel(logging.INFO)` ostatni komunikat `DEBUG` jest odrzucany.
Powiązane lekcje
- Python · Lekcja 24 · Średniozaawansowany · Wersja: 3