Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

Zaznamenávanie udalostí pomocou Logger.debug, info, warning a error

Vyberte metódu pomenovaného loggera podľa závažnosti udalosti a zistite, ako nastavenia loggera a obslužných objektov určujú, ktoré správy sa zobrazia.

Verzia: Python 3.12

Syntax

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 Pythone 3.12 získate pomenovaný logger pomocou logging.getLogger(name), v module zvyčajne pomocou logging.getLogger(__name__). Metódy debug, info, warning a error volajte na vrátenej inštancii Logger. Pri rovnakom názve dostanete tú istú inštanciu. Funkcie modulu, napríklad logging.info(), namiesto toho používajú koreňový logger a volajú basicConfig(), ak nemá obslužné objekty (handlery). Metódy inštancie koreňový logger automaticky nenastavujú.

Podľa rastúcej závažnosti použite debug() na diagnostické podrobnosti (DEBUG), info() na bežné udalosti (INFO), warning() na možný alebo neočakávaný problém, pri ktorom program môže pokračovať (WARNING), a error(), keď operácia zlyhala (ERROR). Používajte warning() namiesto zastaraného warn(). Zaznamenanie výnimky na úrovni ERROR túto výnimku znova nevyvolá. Samotné volanie error() však môže vyvolať výnimku, napríklad KeyError, ak sa extra pokúsi prepísať vyhradené pole objektu LogRecord.

Všetky štyri metódy prijímajú msg, *args, **kwargs. Hodnoty odovzdávajte samostatne, napríklad logger.debug("Items scanned: %d", 3): dosadia sa pomocou % pri formátovaní správy. Bez pozičných argumentov za msg sa nič nedosadzuje. Pomenované voľby sú exc_info (informácie o výnimke), stack_info (aktuálny zásobník volaní), stacklevel (zaznamenané miesto volania) a extra (vlastné polia záznamu).

Efektívna úroveň loggera je prah: INFO vyradí DEBUG. Pri NOTSET hľadá pomenovaný logger úroveň u svojich predkov; predvolená úroveň koreňového loggera je WARNING. Obslužné objekty môžu uplatňovať vlastné prahy a filtre. Keď sa záznam posúva obslužným objektom predkov, úrovne ani filtre týchto nadradených loggerov sa znova nekontrolujú.

Prí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ýsledok

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

Spustite skript v novom procese Pythonu 3.12. `basicConfig()` nastaví úroveň koreňového loggera na `DEBUG` a nasmeruje výstup na `sys.stdout`. Zobrazia sa štyri riadky; po `logger.setLevel(logging.INFO)` sa posledná správa `DEBUG` odfiltruje.

Súvisiace lekcie

  • Python · Lekcia 24 · Stredne pokročilá · Verzia: 3

Zdroje