Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Python

Beleženje dogodkov z Logger.debug, info, warning in error

Izberite metodo poimenovanega zapisovalnika glede na resnost dogodka in ugotovite, kako nastavitve zapisovalnika in obdelovalnikov določajo, katera sporočila se izpišejo.

Različica: Python 3.12

Sintaksa

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 pridobite poimenovani zapisovalnik z logging.getLogger(name), v modulu običajno z logging.getLogger(__name__). Metode debug, info, warning in error pokličite na vrnjeni instanci Logger. Z istim imenom znova dobite isto instanco. Funkcije modula, kot je logging.info(), uporabljajo korenski zapisovalnik in pokličejo basicConfig(), če nima obdelovalnikov. Metode instance korenskega zapisovalnika ne nastavijo samodejno.

Po naraščajoči resnosti uporabite debug() za diagnostične podrobnosti (DEBUG), info() za običajne dogodke (INFO), warning() za možno ali nepričakovano težavo, ob kateri program še lahko deluje (WARNING), in error(), ko opravilo ni uspelo (ERROR). Uporabite warning() namesto zastarele metode warn(). Beleženje izjeme na ravni ERROR te izjeme ne sproži znova. Sam klic error() pa lahko sproži izjemo, na primer KeyError, če poskuša extra prepisati rezervirano polje objekta LogRecord.

Vse štiri metode sprejmejo msg, *args, **kwargs. Vrednosti podajte ločeno, na primer logger.debug("Items scanned: %d", 3): pri oblikovanju sporočila se vstavijo z operatorjem %. Če za msg ni položajnih argumentov, vstavljanja ni. Ključne možnosti so exc_info (podatki o izjemi), stack_info (trenutni sklad klicev), stacklevel (mesto klica, ki se zabeleži) in extra (polja zapisa po meri).

Efektivna raven zapisovalnika je prag: INFO zavrže DEBUG. Pri NOTSET poimenovani zapisovalnik poišče raven pri svojih prednikih; privzeta raven korenskega zapisovalnika je WARNING. Obdelovalniki lahko uporabijo lastne pragove in filtre. Ko se zapis posreduje obdelovalnikom prednikov, se ravni in filtri teh nadrejenih zapisovalnikov ne preverijo znova.

Primeri

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

Rezultat

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

Zaženite skript v novem procesu Python 3.12. `basicConfig()` nastavi raven korenskega zapisovalnika na `DEBUG` in preusmeri izpis na `sys.stdout`. Izpišejo se štiri vrstice; po `logger.setLevel(logging.INFO)` se zadnje sporočilo `DEBUG` zavrže.

Povezane lekcije

  • Python · Lekcija 24 · Srednja · Različica: 3

Viri