CKTIS / Python
Registrare eventi con Logger.debug, info, warning ed error
Scegli il metodo di un logger con nome in base alla gravità dell’evento e scopri come le impostazioni del logger e dei gestori determinano quali messaggi compaiono.
Versione: Python 3.12
Sintassi
logger = logging.getLogger(name)
logger.debug(msg, *args, **kwargs)
logger.info(msg, *args, **kwargs)
logger.warning(msg, *args, **kwargs)
logger.error(msg, *args, **kwargs)In Python 3.12, ottieni un logger con nome tramite logging.getLogger(name), di solito logging.getLogger(__name__) in un modulo. Chiama debug, info, warning ed error sull’istanza di Logger restituita. Richiedere lo stesso nome restituisce la stessa istanza. Le funzioni del modulo, come logging.info(), usano invece il logger radice e chiamano basicConfig() se non ha gestori. I metodi di istanza non configurano automaticamente il logger radice.
In ordine crescente di gravità, usa debug() per i dettagli diagnostici (DEBUG), info() per gli eventi ordinari (INFO), warning() per un problema possibile o imprevisto che non impedisce al programma di continuare (WARNING) ed error() quando un’operazione non è riuscita (ERROR). Usa warning() anziché il deprecato warn(). Registrare un’eccezione al livello ERROR non la solleva di nuovo. La chiamata a error() può però sollevare un’eccezione, per esempio un KeyError se extra tenta di sovrascrivere un campo riservato di un LogRecord.
Tutti e quattro i metodi accettano msg, *args, **kwargs. Passa i valori separatamente, come in logger.debug("Items scanned: %d", 3): la sostituzione tramite % avviene durante la formattazione del messaggio. Senza argomenti posizionali dopo msg non avviene alcuna sostituzione. Le opzioni con nome sono exc_info (dettagli dell’eccezione), stack_info (stack delle chiamate corrente), stacklevel (posizione della chiamata registrata) ed extra (campi personalizzati del record).
Il livello effettivo del logger fa da soglia: INFO scarta DEBUG. Con NOTSET, un logger con nome cerca un livello nei suoi antenati; il livello predefinito della radice è WARNING. I gestori possono applicare soglie e filtri propri. Quando un record viene propagato ai gestori degli antenati, i livelli e i filtri di quei logger non vengono ricontrollati.
Esempi
import logging
import sys
logging.basicConfig(
level=logging.DEBUG,
stream=sys.stdout,
format="%(levelname)s %(name)s: %(message)s",
)
logger = logging.getLogger("inventory")
logger.debug("Items scanned: %d", 3)
logger.info("Inventory loaded")
logger.warning("Stock is low")
logger.error("Could not save inventory")
logger.setLevel(logging.INFO)
logger.debug("This line is filtered out")Risultato
DEBUG inventory: Items scanned: 3 INFO inventory: Inventory loaded WARNING inventory: Stock is low ERROR inventory: Could not save inventory
Esegui lo script in un nuovo processo Python 3.12. `basicConfig()` imposta il livello della radice a `DEBUG` e indirizza l’output a `sys.stdout`. Compaiono quattro righe; dopo `logger.setLevel(logging.INFO)`, l’ultimo messaggio `DEBUG` viene scartato.
Lezioni correlate
- Python · Lezione 24 · Intermedio · Versione: 3