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

CKTIS / Python

LoggerAdapter.error(): логване на грешки с контекст за екипа

В Python 3.12 използвай `LoggerAdapter.error()`, за да записваш съобщения с ниво `ERROR` и поле `team`, без да подаваш полето при всяко извикване.

Версия: Python 3.12

Синтаксис

adapter = logging.LoggerAdapter(logger, extra={"team": team})
adapter.error(msg, *args, **kwargs)

Създай адаптера с logging.LoggerAdapter(logger, extra={"team": "platform"}). adapter.error() записва съобщения с ниво ERROR чрез подадения обект Logger, за разлика от функцията на модула logging.error(), която използва кореновия логер. Адаптерът няма собствен праг: настройките на логера и неговите обработчици определят дали записът ще бъде изведен.

Използвай adapter.error(), за да съобщиш за неуспех. Самото извикване не повдига изключение и по подразбиране не включва проследяване на стека. В блок except използвай adapter.exception(...) или adapter.error(..., exc_info=True), за да включиш обработваното изключение.

В Python 3.12 стандартната реализация на process() заменя подадения при конкретното извикване extra с контекста от конструктора, вместо да ги обединява. Полето team става атрибут на LogRecord; форматиращият обект го показва чрез %(team)s. Избягвай имена на вградени атрибути като levelname. Ако форматът изисква team, но полето липсва в записа, форматирането се проваля, освен ако не е зададена стойност по подразбиране.

Примери

import logging
import sys

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

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

adapter = logging.LoggerAdapter(logger, extra={"team": "platform"})
adapter.info("Deployment started for %s", "api")
adapter.warning("Health check is slow")
adapter.error("Deployment failed")

Резултат

INFO [platform] Deployment started for api
WARNING [platform] Health check is slow
ERROR [platform] Deployment failed

Изпълни кода като самостоятелен скрипт. Прагът `INFO` пропуска и трите записа, а `StreamHandler` ги записва на стандартния изход. `propagate = False` предотвратява препращането им към обработчиците на логерите по-нагоре в йерархията.

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

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

Източници