CKTIS / Python
Bilježenje događaja metodama Logger.debug, info, warning i error
Odaberite metodu imenovanog zapisivača prema ozbiljnosti događaja i provjerite kako zapisivač i rukovatelji određuju koje se poruke prikazuju.
Verzija: 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)U Pythonu 3.12 dohvatite imenovani zapisivač pozivom logging.getLogger(name), u modulu obično pozivom logging.getLogger(__name__). Pozovite debug, info, warning i error na vraćenoj instanci klase Logger. Za isto ime ponovno dobivate istu instancu. Funkcije modula, poput logging.info(), umjesto toga koriste korijenski zapisivač i pozivaju basicConfig() ako nema rukovatelja. Metode instance ne konfiguriraju automatski korijenski zapisivač.
Od manje prema većoj ozbiljnosti upotrijebite debug() za dijagnostičke pojedinosti (DEBUG), info() za redovite događaje (INFO), warning() za mogući ili neočekivani problem uz koji program može nastaviti raditi (WARNING) i error() kad operacija nije uspjela (ERROR). Upotrebljavajte warning() umjesto zastarjelog warn(). Bilježenje iznimke na razini ERROR ne podiže tu iznimku ponovno. Sam poziv metode error() ipak može podići iznimku, primjerice KeyError ako extra pokuša prepisati rezervirano polje objekta LogRecord.
Sve četiri metode prihvaćaju msg, *args, **kwargs. Vrijednosti proslijedite odvojeno, kao u logger.debug("Items scanned: %d", 3): umeću se operatorom % pri oblikovanju poruke. Bez pozicijskih argumenata nakon msg nema umetanja. Opcije s ključnim riječima su exc_info (pojedinosti o iznimci), stack_info (trenutačni stog poziva), stacklevel (mjesto poziva koje se bilježi) i extra (prilagođena polja zapisa).
Efektivna razina zapisivača služi kao prag: INFO odbacuje DEBUG. Uz NOTSET imenovani zapisivač traži razinu kod svojih predaka; zadana je razina korijenskog zapisivača WARNING. Rukovatelji mogu primijeniti vlastite pragove i filtre. Kad se zapis proslijedi rukovateljima predaka, razine i filtri tih nadređenih zapisivača ne provjeravaju se ponovno.
Primjeri
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
Pokrenite skriptu u novom procesu Pythona 3.12. `basicConfig()` postavlja razinu korijenskog zapisivača na `DEBUG` i šalje izlaz na `sys.stdout`. Ispisuju se četiri retka; nakon `logger.setLevel(logging.INFO)` posljednja se poruka `DEBUG` odbacuje.
Povezane lekcije
- Python · Lekcija 24 · Srednje · Verzija: 3