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

CKTIS / Python

Задаване на прага на именуван логър със setLevel()

Задай `logging.INFO` на именуван логър: `DEBUG` се отхвърля, а `INFO` и по-високите нива преминават проверката на логъра. Обработчикът все още определя какво се извежда.

Версия: Python 3.12

Синтаксис

logger = logging.getLogger(name)
logger.setLevel(level)  # e.g. logging.INFO or "INFO"

Методът на екземпляра logging.Logger.setLevel задава прага на логъра, върху който го извикаш. В Python 3.12 logging.getLogger("root") връща кореновия логър, така че извикването на setLevel() върху него задава неговия праг. Повторното извикване със същото име връща същия обект. Подай целочислена константа като logging.INFO или име на ниво като "INFO". При този праг DEBUG се отхвърля, а INFO, WARNING, ERROR и CRITICAL преминават проверката за ниво на логъра.

Нов логър, който не е коренов, започва с ниво logging.NOTSET. Тогава неговият ефективен праг е нивото на най-близкия предшественик с ниво, различно от NOTSET. Ако всички предшественици, включително кореновият логър, също са с ниво NOTSET, ефективното ниво е NOTSET. Нивото по подразбиране на кореновия логър е WARNING. Можеш да провериш ефективния праг с logger.getEffectiveLevel().

setLevel() не добавя обработчик и не избира къде да се извеждат записите. Всеки обработчик има собствен праг (Handler.setLevel) и може да прилага филтри, така че приет от логъра запис може да не се изведе. При препращане записите отиват директно към обработчиците на предшествениците, без да се проверяват повторно нивата и филтрите на тези логъри. logger.propagate = False спира препращането към предшествениците.

Примери

import logging
import sys

logger = logging.getLogger("cktis.checkout")
logger.setLevel(logging.INFO)
logger.propagate = False

handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(levelname)s: %(message)s"))
logger.addHandler(handler)

logger.debug("Checking cart")
logger.info("Order accepted")
logger.warning("Receipt delayed")

Резултат

INFO: Order accepted
WARNING: Receipt delayed

Обработчикът пише в `sys.stdout`, а неговото ниво по подразбиране `NOTSET` не отхвърля записи според важността им. Препращането е изключено, затова в нов процес логърът отхвърля `DEBUG`, а `INFO` и `WARNING` се извеждат по веднъж.

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

  • Python · Урок 27 · Напреднало · Версия: 5
  • Python · Урок 24 · Средно · Версия: 3

Източници