База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

Записване на събития с Logger.debug, info, warning и error

Изберете метод на именуван логър според сериозността на събитието и вижте как настройките на логъра и обработчиците определят кои съобщения се извеждат.

Версия: Python 3.12

Синтаксис

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

В Python 3.12 вземете именуван логър чрез logging.getLogger(name), обикновено logging.getLogger(__name__) в модул. Извикайте debug, info, warning и error върху върнатата инстанция на Logger. Повторното подаване на същото име връща същата инстанция. Функциите на модула, като logging.info(), използват кореновия логър и извикват basicConfig(), ако той няма обработчици. Методите на инстанцията не конфигурират автоматично кореновия логър.

Във възходящ ред по сериозност използвайте debug() за диагностични подробности (DEBUG), info() за обичайни събития (INFO), warning() за възможен или неочакван проблем, при който програмата може да продължи (WARNING), и error() при неуспешна операция (ERROR). Използвайте warning() вместо остарелия warn(). Записването на изключение на ниво ERROR не повдига същото изключение отново. Самото извикване на error() обаче може да повдигне изключение, например KeyError, ако чрез extra се направи опит за презаписване на запазено поле на обект LogRecord.

И четирите метода приемат msg, *args, **kwargs. Подавайте стойностите отделно, както в logger.debug("Items scanned: %d", 3): те се заместват чрез % при форматиране на съобщението. Без позиционни аргументи след msg няма заместване. Именуваните опции са exc_info (данни за изключение), stack_info (текущ стек на извикванията), stacklevel (кое място на извикване се записва) и extra (потребителски полета на записа).

Ефективното ниво на логъра е праг: INFO отхвърля DEBUG. При NOTSET именуваният логър търси ниво в предшествениците си; нивото по подразбиране на кореновия логър е WARNING. Обработчиците могат да прилагат собствени прагове и филтри. Когато записът се предава към обработчиците на предшествениците, нивата и филтрите на самите логъри предшественици не се проверяват повторно.

Примери

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

Резултат

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

Стартирайте скрипта в нов процес на Python 3.12. `basicConfig()` задава `DEBUG` като ниво на кореновия логър и насочва изхода към `sys.stdout`. Извеждат се четири реда; след `logger.setLevel(logging.INFO)` последното съобщение `DEBUG` се отхвърля.

Свързани уроци

  • Python · Урок 24 · Средно · Версия: 3

Източници