Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

Pripojenie obsluhy logovania a zastavenie propagácie

Pomocou `addHandler()` pripojte obsluhu ku konkrétnemu loggeru a nastavením `propagate = False` zabráňte odovzdávaniu záznamov obsluhám nadradených loggerov vrátane koreňového.

Verzia: Python 3.12

Syntax

logger.addHandler(hdlr)
logger.propagate = False

logging.Logger.addHandler pripojí existujúci objekt obsluhy ku konkrétnemu loggeru. Logger získajte pomocou logging.getLogger(name) a metóde logger.addHandler(hdlr) odovzdajte napríklad inštanciu logging.StreamHandler, nie samotnú triedu. Obsluha určuje cieľ výstupu a jej formátovač určuje podobu textu. Ak chcete obsluhu odpojiť, zavolajte logger.removeHandler(hdlr) namiesto priamej úpravy logger.handlers.

Logger, v ktorom záznam vzniká, najprv uplatní svoju efektívnu úroveň a vlastné filtre. Prijatý záznam ponúkne miestnym obsluhám a pri predvolenom propagate = True aj obsluhám postupne vyššie postavených loggerov, pokiaľ sa propagácia cestou nezastaví. Úrovne ani filtre nadradených loggerov sa pri odovzdávaní nekontrolujú, ale každá obsluha naďalej uplatňuje vlastný prah a vlastné filtre.

logger.propagate = False zastaví odovzdávanie vyššie po tom, čo miestne obsluhy dostali možnosť záznam spracovať. Nevypne logger ani nezmení nastavenie koreňového loggera: žiadna obsluha vyššie v tejto vetve záznam nedostane. Ak miestne a nadradené obsluhy zapisujú do rovnakého cieľa, vo výstupe sa môžu objaviť zdanlivé duplicity. Ak stačí spoločný cieľ, pripojte obsluhu len k vhodnému nadradenému loggeru a nechajte propagáciu zapnutú.

Príklady

import logging
import sys

logging.basicConfig(
    level=logging.WARNING,
    stream=sys.stdout,
    format="root: %(message)s",
)

logger = logging.getLogger("cktis.demo")
logger.setLevel(logging.INFO)
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("local: %(message)s"))
logger.addHandler(handler)

logger.info("first")
logger.propagate = False
logger.info("second")

Výsledok

local: first
root: first
local: second

Spustite skript v novom procese Pythonu 3.12. `first` sa zobrazí dvakrát, s `local:` a s `root:`. Úroveň `WARNING` koreňového loggera nezablokuje odovzdaný záznam úrovne `INFO`, pretože smeruje priamo do jeho obsluhy. Po vypnutí propagácie sa `second` zobrazí len s `local:`.

Súvisiace lekcie

  • Python · Lekcia 24 · Stredne pokročilá · Verzia: 3

Zdroje