6.28.5 Oggetti LogRecord

Le istanze LogRecord vengono create ogni volta che esiste qualcosa da loggare. Esse contengono tutte le informazioni pertinenti agli eventi che devono essere loggati. Le principali informazioni che vengono passate sono msg e args, che vengono combinate usando msg % args per creare un campo messaggio nel record. Il record include anche informazioni su quando il record stato creato, la riga sorgente da cui la chiamata di logging stata fatta, ed ogni informazione sulle eccezioni da registrare.

LogRecord non ha metodi: solo un deposito di informazioni circa l'evento di logging. La sola ragione del fatto che si tratta di una classe piuttosto che di un dizionario per facilitarne l'estensione.

class LogRecord( name, lvl, pathname, lineno, msg, args, exc_info)
Restituisce una istanza di LogRecord inizializzata con interessanti informazioni. name il nome del logger; lvl il livello numerico; pathname il percorso dei nomi assoluto del file sorgente dal quale stata effettuata la chiamata; lineno il numero di riga del file dove la chiamata di logging viene rinvenuta; msg il messaggio fornito dall'utente (una stringa di formato); args la tupla in cui, insieme a msg, viene costruito il messaggio utente; infine exc_info la tupla di eccezione ottenuta attraverso la chiamata sys.exc_info() (o None, se nessuna informazione di eccezione disponibile).

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.