CKTIS / Python
Nastavení prahu pojmenovaného loggeru pomocí setLevel()
Nastavte pojmenovaný logger na `logging.INFO`: `DEBUG` se zahodí, zatímco `INFO` a vyšší úrovně projdou kontrolou loggeru. O výstupu dál rozhoduje obslužná rutina.
Verze: Python 3.12
Syntaxe
logger = logging.getLogger(name)
logger.setLevel(level) # e.g. logging.INFO or "INFO"Metoda instance logging.Logger.setLevel nastaví práh loggeru, na kterém ji zavoláte. V Pythonu 3.12 vrací logging.getLogger("root") kořenový logger, takže voláním setLevel() na tomto loggeru nastavíte jeho práh. Opakované vyhledání stejného názvu vrací stejný objekt. Zadejte celočíselnou konstantu jako logging.INFO nebo název úrovně, například "INFO". Při tomto prahu se DEBUG zahodí; INFO, WARNING, ERROR a CRITICAL projdou kontrolou úrovně loggeru.
Nový logger, který není kořenový, začíná s úrovní logging.NOTSET. Jeho efektivní práh se pak bere z nejbližšího nadřazeného loggeru s jinou úrovní než NOTSET. Pokud mají všechny nadřazené loggery včetně kořenového také úroveň NOTSET, je efektivní úroveň NOTSET. Výchozí úroveň kořenového loggeru je WARNING. Efektivní práh zjistíte pomocí logger.getEffectiveLevel().
setLevel() nepřidává obslužnou rutinu ani nevybírá cíl výstupu. Každá obslužná rutina má vlastní práh (Handler.setLevel) a může používat filtry, takže záznam přijatý loggerem nemusí skončit na výstupu. Při předávání jdou záznamy přímo obslužným rutinám nadřazených loggerů bez opětovné kontroly úrovní a filtrů těchto loggerů. Nastavení logger.propagate = False předávání nadřazeným loggerům zastaví.
Příklady
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")Výsledek
INFO: Order accepted WARNING: Receipt delayed
Obslužná rutina zapisuje do `sys.stdout` a její výchozí úroveň `NOTSET` neodmítá záznamy podle závažnosti. Předávání je vypnuté, takže v novém procesu logger zahodí `DEBUG` a `INFO` i `WARNING` se vypíšou každý jednou.
Související lekce
- Python · Lekce 27 · Pokročilá · Verze: 5
- Python · Lekce 24 · Středně pokročilá · Verze: 3