CKTIS / Python
Impostare la soglia di un logger con nome tramite setLevel()
Imposta un logger con nome su `logging.INFO`: `DEBUG` viene scartato, mentre `INFO` e i livelli superiori superano la soglia del logger. L’handler decide ancora cosa va in output.
Versione: Python 3.12
Sintassi
logger = logging.getLogger(name)
logger.setLevel(level) # e.g. logging.INFO or "INFO"Il metodo di istanza logging.Logger.setLevel imposta la soglia del logger su cui lo invochi. In Python 3.12, logging.getLogger("root") restituisce il logger radice, quindi invocare setLevel() su quel logger ne imposta la soglia. Una nuova ricerca con lo stesso nome restituisce lo stesso oggetto. Passa una costante intera come logging.INFO oppure un nome di livello come "INFO". Con questa soglia, DEBUG viene scartato; INFO, WARNING, ERROR e CRITICAL superano il controllo del livello del logger.
Un nuovo logger diverso da quello radice parte da logging.NOTSET. La sua soglia effettiva è quindi quella dell’antenato più vicino con un livello diverso da NOTSET. Se tutti i suoi antenati, incluso il logger radice, sono anch’essi al livello NOTSET, il suo livello effettivo è NOTSET. Il logger radice è impostato su WARNING per impostazione predefinita. Usa logger.getEffectiveLevel() per consultare la soglia effettiva.
setLevel() non aggiunge un handler né sceglie una destinazione. Ogni handler ha la propria soglia (Handler.setLevel) e può applicare filtri: un record accettato dal logger potrebbe quindi non produrre alcun output. Durante la propagazione, i record passano direttamente agli handler degli antenati senza ricontrollare livelli o filtri di quei logger. logger.propagate = False interrompe l’inoltro agli antenati.
Esempi
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")Risultato
INFO: Order accepted WARNING: Receipt delayed
L’handler scrive su `sys.stdout` e il suo livello predefinito `NOTSET` non scarta i record in base alla gravità. Con la propagazione disattivata, in un nuovo processo il logger scarta `DEBUG`, mentre `INFO` e `WARNING` compaiono una volta ciascuno.
Lezioni correlate
- Python · Lezione 27 · Avanzato · Versione: 5
- Python · Lezione 24 · Intermedio · Versione: 3