Come configurare un logger con Python

Luca Terribili

Autore

Pubblicato 25 mag 2024Aggiornamento: 17 lug 2026

Il logging è un elemento fondamentale per la gestione degli errori e delle notifiche all'interno di un'applicazione Python.

Il logging è una tecnica di debugging che consiste nell'iscrivere informazioni relative alla gestione degli errori e delle notifiche all'interno di un'applicazione. In Python, il modulo logging fornisce una serie di funzionalità per configurare e utilizzare i loggers.

Questo importantissimo componente non solo aiuta a tracciare e risolvere i bug, ma è anche essenziale per monitorare lo stato di salute di un'applicazione in produzione. Esso permette di raccogliere dati su eventi specifici, segnalare condizioni anomale, e offrire una cronologia dettagliata delle operazioni eseguite.

Un sistema di logging ben configurato consente di ottenere informazioni dettagliate e di vario livello di gravità, come errori critici, avvertimenti, informazioni e messaggi di debug. Questo è particolarmente utile in contesti di sviluppo e produzione dove la tracciabilità e l'analisi degli eventi sono cruciali per mantenere un alto livello di affidabilità e performance dell'applicazione.

Nel corso di questo articolo, vedremo come iniziare con il modulo logging, esplorando i suoi componenti principali come logger, handler, formatter e filter. Inoltre, esamineremo il modulo logconfig per configurare i loggers utilizzando file di configurazione o dizionari. Questi strumenti ci permetteranno di creare un sistema di logging flessibile e potente, adattabile a diverse esigenze applicative.

Configurazione del logger

Per configurare un logger con Python, è necessario importare il modulo logging e creare un oggetto Logger. Il seguente esempio mostra come configurare un logger di base:

import logging

# Creiamo un logger
logger = logging.getLogger('my_logger')

# Impostiamo il livello di loggaggio (INFO, WARNING, ERROR, CRITICAL)
logger.setLevel(logging.INFO)

# Configuriamo il formatter del logger
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
logger.setFormatter(formatter)

# Creiamo un file handler per scrivere i log nel file
file_handler = logging.FileHandler('my_logger.log')
file_handler.setLevel(logging.INFO)
file_handler.setFormatter(formatter)
logger.addHandler(file_handler)

# Possiamo anche configurare un console handler per visualizzare i log in tempo reale
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO)
console_handler.setFormatter(formatter)
logger.addHandler(console_handler)

Loading...

In questo esempio, creiamo un logger con il nome my\_logger e impostiamo il livello di loggaggio su INFO. Configuriamo poi il formatter del logger per includere informazioni come l'ora, il nome del logger, il livello di loggaggio e il messaggio. Creiamo infine due handler: un file handler per scrivere i log nel file e un console handler per visualizzare i log in tempo reale.

Utilizzo del logger

Una volta configurato il logger, possiamo utilizzarlo per loggare le informazioni all'interno della nostra applicazione. Ad esempio:

logger.info('Start processing')
# ... processo ...
logger.error('Errore durante il processing')
# ... processo ...

Loading...

In questo esempio, usiamo il logger per loggare due messaggi: uno INFO che indica l'inizio del processo e uno ERROR che indica un errore durante il processo.

Configurazione avanzata

Il modulo logging fornisce diverse opzioni di configurazione avanzate. Ad esempio, possiamo impostare il formato dei log utilizzando il metodo setFormatString. Possiamo anche configurare i filter del logger per selezionare specificamente quali log vengono scritti.

Configurazione con file di configurazione

In alcuni casi, potremmo voler configurare il logger attraverso un file di configurazione. Il modulo logconfig fornisce questa possibilità. Ad esempio:

import logging
from logging.config import dictConfig

# Carichiamo la configurazione dal file
config = {
    'version': 1,
    'formatters': {
        'default': {
            'format': '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
        }
    },
    'handlers': {
        'file_handler': {
            'class': 'logging.FileHandler',
            'filename': 'my_logger.log',
            'level': 'INFO',
            'formatter': 'default'
        }
    },
    'loggers': {
        'my_logger': {
            'level': 'INFO',
            'handlers': ['file_handler']
        }
    }
}

# Applichiamo la configurazione al logger
dictConfig(config)

# Creiamo il logger
logger = logging.getLogger('my_logger')

Loading...

In questo esempio, carichiamo la configurazione del logger dal file e applichiamo poi la configurazione all'oggetto Logger.

Conclusione

Il logging è un elemento fondamentale per la gestione degli errori e delle notifiche all'interno di un'applicazione Python. Il modulo logging fornisce una serie di funzionalità per configurare e utilizzare i loggers, mentre il modulo logconfig consente di configurare il logger attraverso un file di configurazione. In questo articolo, abbiamo esplorato come configurare un logger con Python utilizzando i moduli standard logging e logconfig. Speriamo che queste informazioni siano state utili per aiutarti a configurare il tuo logger in Python.