Go Academy · leksjon

Egendefinerte håndterere

Bygg egen loggutdata

Leksjon 4 av 413 trinn

Egendefinerte håndterere er en gratis leksjon i Go Academy på CoddyKit. Dette er leksjon 4 av 4. Du kan lese valgfritt 3 leksjoner fra denne læringsstien gratis i sin helhet – deretter låser CoddyKit PRO opp alle leksjoner, samt praktisk øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i Go Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i Go Academy inneholder totalt 4 leksjoner.

Når innebygde behandlere ikke er nok

Tekst- og JSON-behandlere dekker de fleste behov, men noen ganger ønsker du et tilpasset resultat: fargelagte terminaler, sending til et målesystem eller sladding av hemmeligheter. Da bygger du en custom Handler.

Handler-grensesnittet

En handler implementerer fire metoder:

  • 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 styrer filtreringen

Enabled kalles før en post bygges. Hvis du returnerer false, kan slog hoppe over hele arbeidet, så bruk metoden til nivåkontroller.

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

Handle utfører arbeidet

Handle mottar en slog.Record med tidspunkt, nivå, melding og attributter. Du kan formatere og skrive den akkurat slik du ønsker.

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

Iterere over attributter

En Record gir tilgang til attributtene sine gjennom r.Attrs, som kaller funksjonen din for hvert attributt.

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

WithAttrs og WithGroup

Disse returnerer en kopi av handleren din med forhåndsdefinerte attributter eller et gruppeprefiks. De støtter logger.With og slog.Group. En minimal handler kan lagre og spille dem av på nytt, eller returnere seg selv for læringens skyld.

Pakke inn i stedet for å bygge

Ofte trenger du ikke en fullstendig handler. Pakk heller inn en eksisterende handler og overstyr bare den aktuelle oppførselen, for eksempel ved å legge til et konstant attributt eller sladde nøkler.

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)
}

Bruksområde: Sladding

En sladdende handler kan lete gjennom attributter etter sensitive nøkler som password eller token og erstatte verdien før den videresender til en JSON-handler.

Bruksområde: Ruting

En tilpasset handler kan rute etter nivå: sende Error-logger til stderr og en webhook for varsling, mens Info går til stdout. Da holdes rutingslogikken borte fra hvert enkelt kallsted.

Ytelsesmerknader

Handle kan kjøre i ytelseskritiske kodebaner. Unngå allokeringer, utfør nivåkontroller i Enabled, og bruk buffere på nytt. Standardbehandlerne bruker derfor en bufferpool internt.

Kjørbart: En minimal custom Handler

Dette selvstendige programmet definerer en liten handler som skriver ut nivå, melding og attributter, og logger deretter gjennom den.

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)
}

Hurtigsjekk

Test forståelsen din av tilpassede behandlere.

Oppsummering

Du har lært å bygge tilpassede behandlere:

  • Implementer Enabled, Handle, WithAttrs og WithGroup
  • Utfør nivåkontroller i Enabled av hensyn til ytelsen
  • Iterer over attributter med r.Attrs
  • Det er ofte enklere å pakke inn en eksisterende handler enn å bygge en fra grunnen av
Gratis å komme i gang

Lær deg Go med en AI-veileder – gratis

Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.

Kurs
51
Leksjoner
203

Ofte stilte spørsmål

Er leksjonen «Egendefinerte håndterere» gratis?

Ja – du kan lese valgfritt 3 av leksjonene i læringsstien Go Academy, inkludert «Egendefinerte håndterere», gratis i sin helhet her på nettet. Deretter låser CoddyKit PRO opp alle leksjoner, samt interaktiv øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Kurset i Go Academy inneholder totalt 4 leksjoner.

Hva lærer jeg i «Egendefinerte håndterere»?

Bygg egen loggutdata Du øver på Go Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.

Trenger jeg erfaring for å begynne med Go Academy?

Ingen tidligere erfaring er nødvendig. Go Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 4 av 4.

Hvor lang tid tar leksjonen «Egendefinerte håndterere»?

De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.

Kan jeg skrive og kjøre kode i denne Go Academy-leksjonen?

Ja. Alle Go Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.

Alle leksjonene i dette kurset

  1. Hvorfor strukturerte logger
  2. slog-håndterere
  3. Loggnivåer og attributter
  4. Egendefinerte håndterere
← Tilbake til Go Academy