Go Academy · Lezione

Livelli e attributi dei log

Aggiungere contesto ai log

Livelli e attributi dei log è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 3 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.

Aggiunta del contesto ai log

Un messaggio isolato indica che cosa è successo; gli attributi forniscono i dettagli che rendono i log utili: quale utente, quale richiesta, quanto tempo ha richiesto.

I quattro livelli

I livelli di slog, dal meno al più grave:

Debug (-4)
Info (0)
Warn (4)
Error (8)

I livelli sono numeri interi, quindi è possibile definirne di personalizzati intermedi.

Filtraggio per livello

Imposti un livello minimo in HandlerOptions. I record al di sotto di tale livello vengono scartati con un costo minimo.

package main

import (
    "log/slog"
    "os"
)

func main() {
    opts := &slog.HandlerOptions{Level: slog.LevelWarn}
    logger := slog.New(slog.NewTextHandler(os.Stdout, opts))
    logger.Info("ignored")
    logger.Warn("shown")
}

Attributi tipizzati

Oltre ai comuni argomenti chiave-valore, slog offre costruttori tipizzati che riducono gli errori e sono più veloci:

slog.String("k", v)
slog.Int("k", v)
slog.Bool("k", v)
slog.Duration("k", d)

slog.Info("done", slog.String("phase", "build"), slog.Int("files", 12))

Perché usare attributi tipizzati

Gli attributi tipizzati rilevano a compile time il bug del "numero dispari di argomenti" e consentono all'handler di evitare la reflection. Li preferisca nei percorsi più utilizzati.

Raggruppamento degli attributi

slog.Group annida i campi correlati sotto un'unica chiave.

slog.Info("req",
    slog.Group("http",
        slog.String("method", "GET"),
        slog.Int("status", 200),
    ),
)

Logger.With per il contesto condiviso

logger.With(...) restituisce un logger figlio che aggiunge gli stessi attributi a ogni messaggio. È perfetto per un ID di richiesta.

reqLog := logger.With("requestID", "abc-123")
reqLog.Info("started")
reqLog.Info("finished")

Logging con contesto

Le varianti *Context, ad esempio InfoContext, trasportano un context.Context, consentendo agli handler di estrarre gli ID di trace.

slog.InfoContext(ctx, "handling", "path", "/api")

Livelli dinamici

Usi un slog.LevelVar per modificare il livello durante l'esecuzione, ad esempio aumentandolo a Debug durante l'analisi di un incidente, senza riavviare l'applicazione.

var lvl slog.LevelVar
lvl.Set(slog.LevelInfo)
h := slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{Level: &lvl})
// later: lvl.Set(slog.LevelDebug)

Errori come attributi

Associ gli errori come attributi, così possono essere interrogati, invece di concatenarli al messaggio.

slog.Error("save failed", slog.String("err", err.Error()), slog.Int("retry", 2))

Esempio eseguibile: livelli e With

Questo programma filtra per livello e usa un logger figlio con un contesto condiviso.

package main

import (
    "log/slog"
    "os"
)

func main() {
    opts := &slog.HandlerOptions{Level: slog.LevelInfo}
    base := slog.New(slog.NewTextHandler(os.Stdout, opts))
    req := base.With("requestID", "r-7")
    req.Debug("hidden")
    req.Info("processing", slog.Int("items", 3))
}

Verifica rapida

Metta alla prova la propria comprensione dei livelli e degli attributi.

Riepilogo

Ha imparato a usare livelli e attributi:

Quattro livelli integrati; filtri con HandlerOptions.Level
Gli attributi tipizzati (slog.String, slog.Int) sono più sicuri e veloci
slog.Group annida i campi; logger.With condivide il contesto
LevelVar consente di modificare i livelli durante l'esecuzione

Domande Frequenti

La lezione «Livelli e attributi dei log» è gratuita?

Sì — il testo completo di «Livelli e attributi dei log» è 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 «Livelli e attributi dei log»?

Aggiungere contesto ai 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 3 di 4.

Quanto tempo richiede la lezione «Livelli e attributi dei log»?

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