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

CKTIS / Python

Beleženje opozoril s kontekstom ekipe z `LoggerAdapter`

Obdaj obstoječi zapisovalnik z `logging.LoggerAdapter` s poljem `team`, da imajo klici metod `info`, `warning` in `error` isti kontekst ekipe.

Različica: Python 3.12

Sintaksa

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

V Pythonu 3.12 logging.LoggerAdapter(logger, {"team": "Platform"}) ovije obstoječi zapisovalnik in mu posreduje klice s kontekstom ekipe. Uporabi adapter.warning(...) za zapis ravni WARNING, ko se zgodi kaj nepričakovanega ali ko grozi težava. adapter.info(...) beleži običajen potek (INFO), adapter.error(...) pa neuspešno opravilo (ERROR). Funkcije modula logging.info, logging.warning in logging.error pa uporabljajo korenski zapisovalnik in konteksta adapterja ne prejmejo samodejno.

Privzeta izvedba process() v Pythonu 3.12 sporočila ne spremeni in preslikavo iz konstruktorja posreduje kot extra. Če pri posameznem klicu adapterja podaš extra, ga ta nadomesti, ne združi s preslikavo iz konstruktorja. team postane atribut objekta LogRecord, zato ga Formatter lahko prikaže z %(team)s. Ključi v extra se ne smejo ujemati z rezerviranimi atributi zapisa.

Vsak zapis, ki ga obdela ta oblikovalnik, mora vsebovati team, sicer oblikovanje ne uspe. Ali se sporočilo izpiše, je še vedno odvisno od nastavitev zapisovalnika in obdelovalnika. V primeru prag INFO prepusti vse tri ravni.

Primeri

import logging
import sys

logger = logging.getLogger("ck tis.deployment".replace(" ", ""))
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, {"team": "Platform"})
adapter.info("Deployment started")
adapter.warning("Retrying health check")
adapter.error("Deployment failed")

Rezultat

INFO [Platform] Deployment started
WARNING [Platform] Retrying health check
ERROR [Platform] Deployment failed

Zaženi kodo kot samostojen skript v Pythonu 3.12. Obdelovalnik piše na standardni izhod, izklopljeno širjenje pa prepreči pošiljanje zapisov nadrejenim zapisovalnikom. Pričakovane so tri vrstice, vsaka z `[Platform]`.

Povezane lekcije

  • Python · Lekcija 27 · Napredna · Različica: 5

Viri