CKTIS / Python
Ustawianie progu nazwanego loggera za pomocą setLevel()
Ustaw próg `logging.INFO` dla nazwanego loggera: `DEBUG` zostanie odrzucony, a `INFO` i wyższe poziomy przejdą przez próg loggera. O wyjściu decyduje też handler.
Wersja: Python 3.12
Składnia
logger = logging.getLogger(name)
logger.setLevel(level) # e.g. logging.INFO or "INFO"Metoda instancji logging.Logger.setLevel ustawia próg loggera, na którym ją wywołasz. W Pythonie 3.12 logging.getLogger("root") zwraca logger główny, więc wywołanie na nim setLevel() ustawia jego próg. Kolejne wywołania getLogger z tą samą nazwą zwracają ten sam obiekt. Metoda przyjmuje stałą całkowitą, taką jak logging.INFO, lub nazwę poziomu, np. "INFO". Przy tym progu DEBUG odpada, a INFO, WARNING, ERROR i CRITICAL przechodzą kontrolę poziomu loggera.
Nowy logger inny niż główny ma poziom logging.NOTSET. Oznacza to, że jego efektywny próg pochodzi od najbliższego przodka z poziomem innym niż NOTSET. Jeśli wszyscy przodkowie, w tym logger główny, również mają poziom NOTSET, efektywny próg to NOTSET. Logger główny domyślnie ma poziom WARNING. Efektywny próg można sprawdzić przez logger.getEffectiveLevel().
setLevel() nie dodaje handlera ani nie wybiera miejsca zapisu. Każdy handler ma własny próg (Handler.setLevel) i może używać filtrów, więc zaakceptowany rekord nie musi pojawić się na wyjściu. Podczas propagacji rekord trafia bezpośrednio do handlerów przodków bez ponownego sprawdzania poziomów i filtrów tych loggerów. logger.propagate = False zatrzymuje przekazywanie rekordu do przodków.
Przykłady
import logging
import sys
logger = logging.getLogger("cktis.checkout")
logger.setLevel(logging.INFO)
logger.propagate = False
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
logger.addHandler(handler)
logger.debug("Checking cart")
logger.info("Order accepted")
logger.warning("Receipt delayed")Wynik
INFO: Order accepted WARNING: Receipt delayed
Handler zapisuje do `sys.stdout`, a jego domyślny poziom `NOTSET` nie odrzuca rekordów na podstawie poziomu. Propagacja jest wyłączona, więc w nowym procesie `DEBUG` odpada na progu loggera, a `INFO` i `WARNING` pojawiają się po jednym razie.
Powiązane lekcje
- Python · Lekcja 27 · Zaawansowany · Wersja: 5
- Python · Lekcja 24 · Średniozaawansowany · Wersja: 3