Go Academy · Lezione

Handler di slog

Handler di testo e JSON

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

Sono gli handler a decidere il formato

In slog, un Logger chiama un Handler per formattare e scrivere ogni record. Sostituendo l'handler si cambia il formato dell'output senza modificare le chiamate di logging.

TextHandler

slog.NewTextHandler scrive righe key=value facili da leggere per le persone. È adatto allo sviluppo locale e ai terminali.

package main

import (
    "log/slog"
    "os"
)

func main() {
    h := slog.NewTextHandler(os.Stdout, nil)
    logger := slog.New(h)
    logger.Info("hello", "env", "dev")
}

JSONHandler

slog.NewJSONHandler emette un oggetto JSON per riga. È ideale per le pipeline dei log di produzione.

package main

import (
    "log/slog"
    "os"
)

func main() {
    h := slog.NewJSONHandler(os.Stdout, nil)
    logger := slog.New(h)
    logger.Info("hello", "env", "prod")
}

Creazione di un Logger

slog.New(handler) racchiude un handler in un Logger. Su quell'istanza si chiamano logger.Info, logger.Error e così via.

logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))

HandlerOptions

Il secondo argomento del costruttore di un handler è *slog.HandlerOptions. Passi nil per usare i valori predefiniti, oppure configuri il livello e la posizione nel codice sorgente.

opts := &slog.HandlerOptions{
    Level:     slog.LevelDebug,
    AddSource: true,
}
h := slog.NewJSONHandler(os.Stdout, opts)

Scrittura in un file o in un buffer

Gli handler accettano qualsiasi io.Writer. È possibile registrare i log in un file, in un buffer per i test oppure nell'output standard. Questo disaccoppiamento è un elemento fondamentale del design di slog.

f, _ := os.Create("app.log")
logger := slog.New(slog.NewJSONHandler(f, nil))

Impostazione del Logger predefinito

slog.SetDefault(logger) fa sì che le funzioni a livello di package (slog.Info ecc.) usino il Suo handler. Lo imposti una sola volta all'avvio.

slog.SetDefault(slog.New(slog.NewJSONHandler(os.Stdout, nil)))
slog.Info("now JSON by default")

Output testuale e JSON

La stessa chiamata, due formati:

Testo: time=... level=INFO msg=hello env=dev
JSON: {"time":"...","level":"INFO","msg":"hello","env":"dev"}

Scelta dell'handler

Regola generale:

Locale/sviluppo: TextHandler, più leggibile
Produzione/aggregato: JSONHandler, più facile da analizzare

Decida tramite una variabile d'ambiente, così lo stesso binario può adattarsi.

Scrittura di una configurazione riutilizzabile

Centralizzi la creazione del logger, così l'intera applicazione condivide un'unica configurazione.

func newLogger(prod bool) *slog.Logger {
    if prod {
        return slog.New(slog.NewJSONHandler(os.Stdout, nil))
    }
    return slog.New(slog.NewTextHandler(os.Stdout, nil))
}

Esempio eseguibile: cambio di handler

Questo programma registra lo stesso evento tramite entrambi gli handler, così è possibile confrontare i formati.

package main

import (
    "log/slog"
    "os"
)

func main() {
    text := slog.New(slog.NewTextHandler(os.Stdout, nil))
    js := slog.New(slog.NewJSONHandler(os.Stdout, nil))
    text.Info("login", "user", "ada")
    js.Info("login", "user", "ada")
}

Verifica rapida

Metta alla prova la propria comprensione degli handler di slog.

Riepilogo

Ha imparato a conoscere gli handler di slog:

Gli handler formattano e scrivono i record; il Logger li chiama
NewTextHandler per le persone, NewJSONHandler per le macchine
Gli handler accettano qualsiasi io.Writer e *HandlerOptions
slog.SetDefault collega le funzioni a livello di package

Domande Frequenti

La lezione «Handler di slog» è gratuita?

Sì — il testo completo di «Handler di slog» è 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 di slog»?

Handler di testo e JSON 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 2 di 4.

Quanto tempo richiede la lezione «Handler di slog»?

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