0Pricing
Go Academy · Leçon

Gestionnaires personnalisés

Créer votre propre sortie de journaux

Gestionnaires personnalisés est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.

Quand les gestionnaires intégrés ne suffisent pas

Les gestionnaires texte et JSON couvrent la plupart des besoins, mais vous pouvez parfois vouloir une sortie personnalisée : des terminaux en couleur, l’envoi vers un système de métriques ou le masquage de secrets. Vous créez alors un gestionnaire personnalisé.

L’interface du gestionnaire

Un gestionnaire implémente quatre méthodes :

  • 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 contrôle le filtrage

Enabled est appelé avant la création d’un enregistrement. Renvoyer false permet à slog d’éviter entièrement le travail ; utilisez-le donc pour vérifier les niveaux.

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

Handle effectue le travail

Handle reçoit un slog.Record contenant l’heure, le niveau, le message et les attributs. Vous le formatez et l’écrivez comme vous le souhaitez.

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

Parcourir les attributs

Un enregistrement expose ses attributs par l’intermédiaire de r.Attrs, qui appelle votre fonction pour chacun d’eux.

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

WithAttrs et WithGroup

Ces fonctions renvoient une copie de votre gestionnaire contenant des attributs prédéfinis ou un préfixe de groupe. Elles prennent en charge logger.With et slog.Group. Un gestionnaire minimal peut les stocker et les rejouer ou, pour apprendre, renvoyer sa propre instance.

Envelopper plutôt que créer

Souvent, vous n’avez pas besoin d’un gestionnaire complet : enveloppez-en un existant et ne redéfinissez que le comportement souhaité, par exemple l’ajout d’un attribut constant ou le masquage de clés.

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

Cas d’utilisation : masquage

Un gestionnaire de masquage peut rechercher des clés sensibles comme password ou token dans les attributs et remplacer leur valeur avant de déléguer le traitement à un gestionnaire JSON.

Cas d’utilisation : routage

Un gestionnaire personnalisé peut router les journaux selon leur niveau : envoyer les journaux Error vers la sortie d’erreur et un service Web d’alerte, tandis que Info est envoyé vers la sortie standard. La logique de routage reste ainsi en dehors de chaque point d’appel.

Remarques sur les performances

Handle peut s’exécuter dans des chemins critiques. Évitez les allocations, effectuez les vérifications de niveau dans Enabled et réutilisez les tampons. Les gestionnaires standard utilisent en interne un tampon mutualisé pour cette raison.

Exécutable : un gestionnaire personnalisé minimal

Ce programme autonome définit un petit gestionnaire qui affiche le niveau, le message et les attributs, puis journalise un événement avec celui-ci.

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

Vérification rapide

Vérifiez votre compréhension des gestionnaires personnalisés.

Récapitulatif

Vous avez appris à créer des gestionnaires personnalisés :

  • Implémentez Enabled, Handle, WithAttrs et WithGroup
  • Effectuez les vérifications de niveau dans Enabled pour de meilleures performances
  • Parcourez les attributs avec r.Attrs
  • Il est souvent plus facile d’envelopper un gestionnaire existant que d’en créer un depuis zéro

Questions Fréquemment Posées

La leçon « Gestionnaires personnalisés » est-elle gratuite ?

Oui — le texte complet de « Gestionnaires personnalisés » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Gestionnaires personnalisés » ?

Créer votre propre sortie de journaux Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Go Academy ?

Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Gestionnaires personnalisés » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?

Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Pourquoi utiliser des journaux structurés
  2. Gestionnaires slog
  3. Niveaux et attributs des journaux
  4. Gestionnaires personnalisés
← Retour à Go Academy