Python Academy · Lezione

Handler, formatter e filtri

Indirizzi l'output dei log verso file, stream e destinazioni personalizzate.

Handler, formatter e filtri è una lezione Python Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Python Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Python Academy include 4 lezioni in totale.

Gli handler instradano i record di log

Un handler invia i record di log a una destinazione: console, file, endpoint HTTP e così via. Un logger può avere più handler.

import logging

logger = logging.getLogger("myapp")
logger.setLevel(logging.DEBUG)

sh = logging.StreamHandler()
logger.addHandler(sh)

logger.info("Goes to console")

StreamHandler

StreamHandler scrive in uno stream (per impostazione predefinita sys.stderr). Passi sys.stdout per inviare l'output a stdout.

import logging, sys

logger = logging.getLogger("out")
handler = logging.StreamHandler(sys.stdout)
logger.addHandler(handler)
logger.warning("printed to stdout")

FileHandler

FileHandler aggiunge i record a un file. Utilizzi mode="w" per sovrascriverlo a ogni esecuzione.

import logging

logging.basicConfig(
    filename="app.log",
    filemode="a",
    level=logging.INFO,
    format="%(asctime)s %(levelname)s %(message)s"
)
logging.info("Persisted to disk")

RotatingFileHandler

Ruota automaticamente i file di log quando superano un limite di dimensione, mantenendo N file di backup.

from logging.handlers import RotatingFileHandler
import logging

handler = RotatingFileHandler(
    "app.log", maxBytes=1_000_000, backupCount=5
)
logging.getLogger().addHandler(handler)

TimedRotatingFileHandler

Ruota i file di log secondo una pianificazione temporale, giornaliera, settimanale o oraria, ed è ideale per i servizi a esecuzione prolungata.

from logging.handlers import TimedRotatingFileHandler
import logging

handler = TimedRotatingFileHandler(
    "app.log", when="midnight", backupCount=7
)
logging.getLogger().addHandler(handler)

Formatter

Un Formatter controlla il layout testuale di ogni record di log. Lo colleghi a un handler con handler.setFormatter().

import logging

fmt = logging.Formatter(
    fmt="%(asctime)s %(levelname)-8s %(name)s — %(message)s",
    datefmt="%Y-%m-%dT%H:%M:%S"
)
handler = logging.StreamHandler()
handler.setFormatter(fmt)
logging.getLogger().addHandler(handler)

Filtraggio a livello di handler

Ogni handler ha il proprio livello. Un record deve superare sia il livello del logger sia quello dell'handler per essere emesso.

import logging

logger = logging.getLogger("app")
logger.setLevel(logging.DEBUG)   # logger passes DEBUG+

err_handler = logging.FileHandler("errors.log")
err_handler.setLevel(logging.ERROR)  # only ERROR+
logger.addHandler(err_handler)

Filtri personalizzati

Estenda logging.Filter e esegua l'override di filter(record) per accettare o rifiutare i record in base a qualsiasi criterio.

import logging

class SensitiveFilter(logging.Filter):
    def filter(self, record):
        return "password" not in record.getMessage().lower()

handler = logging.StreamHandler()
handler.addFilter(SensitiveFilter())
logging.getLogger().addHandler(handler)

Aggiungere campi extra con un filtro

I filtri possono anche modificare il record per iniettare campi aggiuntivi, ad esempio l'ID di una richiesta, prima della formattazione.

import logging

class RequestIDFilter(logging.Filter):
    def __init__(self, request_id):
        self.request_id = request_id
    def filter(self, record):
        record.request_id = self.request_id
        return True

# fmt: "%(request_id)s %(message)s"

Più handler per un logger

Aggiunga diversi handler per inviare simultaneamente gli stessi record di log a più destinazioni.

import logging

logger = logging.getLogger("multi")
logger.addHandler(logging.StreamHandler())             # console
logger.addHandler(logging.FileHandler("audit.log"))   # file
logger.setLevel(logging.INFO)
logger.info("Both destinations receive this")

Disabilitare la propagazione

Imposti logger.propagate = False per impedire ai record di risalire fino al logger root ed essere registrati due volte.

import logging

logger = logging.getLogger("mylib")
logger.propagate = False   # stays here, does not reach root
logger.addHandler(logging.StreamHandler())

Verifica rapida

Quale metodo collega un Formatter a un Handler?

Riepilogo

Gli handler instradano i record, i formatter ne definiscono lo stile e i filtri li lasciano passare o li bloccano selettivamente. Utilizzi RotatingFileHandler per i log con limite di dimensione e TimedRotatingFileHandler per la rotazione basata sulla data.

Domande Frequenti

La lezione «Handler, formatter e filtri» è gratuita?

Sì — il testo completo di «Handler, formatter e filtri» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Python Academy, passa a CoddyKit PRO. Il corso Python Academy include 4 lezioni in totale.

Cosa imparerò in «Handler, formatter e filtri»?

Indirizzi l'output dei log verso file, stream e destinazioni personalizzate. Eserciti Python Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Python Academy?

Non è richiesta alcuna esperienza precedente. Python Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.

Quanto tempo richiede la lezione «Handler, formatter e filtri»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Python Academy?

Sì. Ogni lezione Python Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Python Academy