Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła