Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

Protokolování událostí pomocí Logger.debug, info, warning a error

Zvolte metodu pojmenovaného loggeru podle závažnosti události a zjistěte, jak nastavení loggeru a obsluh určuje, které zprávy se zobrazí.

Verze: Python 3.12

Syntaxe

logger = logging.getLogger(name)
logger.debug(msg, *args, **kwargs)
logger.info(msg, *args, **kwargs)
logger.warning(msg, *args, **kwargs)
logger.error(msg, *args, **kwargs)

V Pythonu 3.12 získáte pojmenovaný logger pomocí logging.getLogger(name), v modulu obvykle pomocí logging.getLogger(__name__). Metody debug, info, warning a error volejte na vrácené instanci Logger. Se stejným názvem získáte znovu stejnou instanci. Funkce modulu, například logging.info(), naopak používají kořenový logger a volají basicConfig(), pokud nemá žádné objekty obsluhy (handlery). Metody instance kořenový logger automaticky nenastavují.

Podle rostoucí závažnosti použijte debug() pro diagnostické podrobnosti (DEBUG), info() pro běžné události (INFO), warning() pro možný nebo neočekávaný problém, při kterém program může pokračovat (WARNING), a error(), když operace selhala (ERROR). Používejte warning(), nikoli zastaralé warn(). Zaznamenání výjimky na úrovni ERROR tuto výjimku znovu nevyvolá. Samotné volání error() však může vyvolat výjimku, například KeyError, pokud se extra pokusí přepsat vyhrazené pole objektu LogRecord.

Všechny čtyři metody přijímají msg, *args, **kwargs. Hodnoty předávejte zvlášť, například logger.debug("Items scanned: %d", 3): dosadí se pomocí % při formátování zprávy. Bez pozičních argumentů za msg se nic nedosazuje. Pojmenované volby jsou exc_info (informace o výjimce), stack_info (aktuální zásobník volání), stacklevel (zaznamenané místo volání) a extra (vlastní pole záznamu).

Efektivní úroveň loggeru funguje jako práh: INFO vyřadí DEBUG. Při NOTSET hledá pojmenovaný logger úroveň u svých předků; kořenový logger má ve výchozím stavu WARNING. Obsluhy mohou uplatňovat vlastní prahy a filtry. Při předávání záznamu obsluhám předků se úrovně ani filtry těchto nadřazených loggerů znovu nekontrolují.

Příklady

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")

Výsledek

DEBUG inventory: Items scanned: 3
INFO inventory: Inventory loaded
WARNING inventory: Stock is low
ERROR inventory: Could not save inventory

Spusťte skript v novém procesu Pythonu 3.12. `basicConfig()` nastaví úroveň kořenového loggeru na `DEBUG` a nasměruje výstup na `sys.stdout`. Zobrazí se čtyři řádky; po `logger.setLevel(logging.INFO)` se poslední zpráva `DEBUG` odfiltruje.

Související lekce

  • Python · Lekce 24 · Středně pokročilá · Verze: 3

Zdroje