Go Academy · Lezione

Handler personalizzati

Creare il proprio output di log

Lezione 4 di 413 passaggi

Handler personalizzati è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 4 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 Go Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Go Academy include 4 lezioni in totale.

Quando gli handler integrati non bastano

Gli handler testuali e JSON coprono la maggior parte delle esigenze, ma a volte si desidera un output personalizzato: terminali a colori, invio a un sistema di metriche oppure oscuramento dei segreti. In questi casi si costruisce un handler personalizzato.

L'interfaccia Handler

Un handler implementa quattro metodi:

Enabled(ctx, level) bool
Handle(ctx, record) error
WithAttrs(attrs) Handler
WithGroup(name) Handler

type Handler interface {
    Enabled(context.Context, slog.Level) bool
    Handle(context.Context, slog.Record) error
    WithAttrs(attrs []slog.Attr) slog.Handler
    WithGroup(name string) slog.Handler
}

Enabled controlla il filtraggio

Enabled viene chiamato prima di costruire un record. Restituire false consente a slog di evitare completamente il lavoro, quindi lo usi per i controlli del livello.

func (h *MyHandler) Enabled(_ context.Context, l slog.Level) bool {
    return l >= slog.LevelInfo
}

Handle esegue il lavoro

Handle riceve uno slog.Record con ora, livello, messaggio e attributi. È possibile formattarlo e scriverlo nel modo preferito.

func (h *MyHandler) Handle(_ context.Context, r slog.Record) error {
    fmt.Printf("[%s] %s\n", r.Level, r.Message)
    return nil
}

Iterazione sugli attributi

Un Record espone i propri attributi tramite r.Attrs, che chiama la funzione fornita per ciascun attributo.

r.Attrs(func(a slog.Attr) bool {
    fmt.Printf("  %s=%v\n", a.Key, a.Value)
    return true // keep going
})

WithAttrs e WithGroup

Restituiscono una copia dell'handler che contiene attributi preimpostati o un prefisso di gruppo. Supportano logger.With e slog.Group. Un handler minimale può memorizzarli e riprodurli oppure, a fini didattici, restituire sé stesso.

Usare un wrapper invece di costruire

Spesso non è necessario un handler completo: è possibile avvolgerne uno esistente e sovrascrivere solo il comportamento necessario, ad esempio aggiungendo un attributo costante o oscurando alcune chiavi.

type RedactHandler struct{ slog.Handler }

func (h RedactHandler) Handle(ctx context.Context, r slog.Record) error {
    // mutate r here, then delegate
    return h.Handler.Handle(ctx, r)
}

Caso d'uso: redazione

Un handler che oscura i dati può cercare negli attributi chiavi sensibili come password o token e sostituirne il valore prima di delegare a un handler JSON.

Caso d'uso: routing

Un handler personalizzato può instradare i log in base al livello: inviare i log Error a stderr e a un webhook per gli avvisi, mentre Info viene inviato a stdout. In questo modo la logica di instradamento non deve essere ripetuta in ogni punto del codice.

Note sulle prestazioni

Handle può essere eseguito in percorsi molto utilizzati. Eviti le allocazioni, esegua i controlli del livello in Enabled e riutilizzi i buffer. Per questo motivo gli handler standard usano internamente un buffer gestito da un pool.

Esempio eseguibile: un handler personalizzato minimale

Questo programma autonomo definisce un piccolo handler che stampa livello, messaggio e attributi, quindi registra un log tramite esso.

package main

import (
    "context"
    "fmt"
    "log/slog"
)

type Mini struct{}

func (Mini) Enabled(context.Context, slog.Level) bool { return true }
func (Mini) WithAttrs(a []slog.Attr) slog.Handler   { return Mini{} }
func (Mini) WithGroup(string) slog.Handler          { return Mini{} }
func (Mini) Handle(_ context.Context, r slog.Record) error {
    fmt.Printf("%s: %s", r.Level, r.Message)
    r.Attrs(func(a slog.Attr) bool {
        fmt.Printf(" %s=%v", a.Key, a.Value)
        return true
    })
    fmt.Println()
    return nil
}

func main() {
    l := slog.New(Mini{})
    l.Info("hello", "user", "ada", "id", 7)
}

Verifica rapida

Metta alla prova la propria comprensione degli handler personalizzati.

Rispondi nella lezione interattiva

Riepilogo

Ha imparato a costruire handler personalizzati:

Implementi Enabled, Handle, WithAttrs, WithGroup
Esegua i controlli del livello in Enabled per ottenere buone prestazioni
Iteri sugli attributi con r.Attrs
Spesso è più semplice avvolgere un handler esistente invece di costruirne uno da zero

Gratis per iniziare

Impara Go con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi: 51
Lezioni: 203

Inizia a imparare gratis Visualizza il corso completo

Domande Frequenti

La lezione «Handler personalizzati» è gratuita?

Sì — il testo completo di «Handler personalizzati» è 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 Go Academy, passa a CoddyKit PRO. Il corso Go Academy include 4 lezioni in totale.

Cosa imparerò in «Handler personalizzati»?

Creare il proprio output di log Eserciti Go 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 Go Academy?

Non è richiesta alcuna esperienza precedente. Go 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 4 di 4.

Quanto tempo richiede la lezione «Handler personalizzati»?

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 Go Academy?

Sì. Ogni lezione Go 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 Go Academy