El Projecte | Sobre nosaltres | Contribuir | Donacions | Llicència
HOME Els meus cursos Finalitzats
◄ Anterior
◄

Registre

Següent ►
►

El registre (logging) és una part essencial del desenvolupament de programari, ja que permet als desenvolupadors monitoritzar i depurar aplicacions en temps real. En aquest tema, aprendrem com implementar el registre en aplicacions Go utilitzant la biblioteca estàndard log i altres biblioteques populars com logrus i zap.

Continguts

  1. Introducció al Registre
  2. Ús de la Biblioteca Estàndard log
  3. Biblioteques de Registre Populars
  4. Consells i Millors Pràctiques
  5. Exercicis Pràctics

Introducció al Registre

El registre és el procés de gravar missatges de text que descriuen el comportament d'una aplicació. Aquests missatges poden incloure informació sobre errors, advertències, informació de depuració i altres esdeveniments importants.

Beneficis del Registre

  • Depuració: Ajudar a identificar i solucionar errors.
  • Monitorització: Permetre la supervisió del rendiment i l'estat de l'aplicació.
  • Auditoria: Proporcionar un registre d'esdeveniments per a la revisió posterior.

Ús de la Biblioteca Estàndard log

Go inclou una biblioteca estàndard per al registre anomenada log. Aquesta biblioteca és senzilla d'utilitzar i proporciona funcionalitats bàsiques per al registre.

Exemple Bàsic

package main

import (
    "log"
    "os"
)

func main() {
    // Configurar el registre per escriure a un fitxer
    file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    if err != nil {
        log.Fatal(err)
    }
    log.SetOutput(file)

    // Escriure missatges de registre
    log.Println("Aquest és un missatge informatiu.")
    log.Println("Aquest és un altre missatge informatiu.")
}

Explicació del Codi

  1. Importació del Paquet log: Importem el paquet log per utilitzar les seves funcions.
  2. Configuració del Fitxer de Registre: Obrim un fitxer app.log per escriure els missatges de registre.
  3. Configuració de la Sortida del Registre: Utilitzem log.SetOutput(file) per redirigir la sortida del registre al fitxer.
  4. Escriure Missatges de Registre: Utilitzem log.Println per escriure missatges de registre.

Biblioteques de Registre Populars

Tot i que la biblioteca estàndard log és útil, hi ha biblioteques de tercers que ofereixen funcionalitats més avançades. A continuació, veurem dues de les biblioteques de registre més populars: logrus i zap.

Logrus

Logrus és una biblioteca de registre estructurat que proporciona més flexibilitat i funcionalitats avançades.

Instal·lació

go get github.com/sirupsen/logrus

Exemple Bàsic

package main

import (
    log "github.com/sirupsen/logrus"
)

func main() {
    // Configurar el format del registre
    log.SetFormatter(&log.JSONFormatter{})

    // Escriure missatges de registre
    log.WithFields(log.Fields{
        "event": "event_name",
        "topic": "topic_name",
    }).Info("Aquest és un missatge informatiu amb camps.")
}

Zap

Zap és una biblioteca de registre altament performant i estructurat, desenvolupada per Uber.

Instal·lació

go get go.uber.org/zap

Exemple Bàsic

package main

import (
    "go.uber.org/zap"
)

func main() {
    // Crear un logger
    logger, _ := zap.NewProduction()
    defer logger.Sync() // Assegurar-se que els búfers es buiden

    // Escriure missatges de registre
    logger.Info("Aquest és un missatge informatiu.",
        zap.String("event", "event_name"),
        zap.String("topic", "topic_name"),
    )
}

Consells i Millors Pràctiques

  • Nivells de Registre: Utilitza nivells de registre (info, warning, error) per categoritzar els missatges.
  • Registre Estructurat: Utilitza registres estructurats per facilitar l'anàlisi automàtica.
  • Rotació de Fitxers: Implementa la rotació de fitxers per evitar que els fitxers de registre creixin massa.
  • Seguretat: Assegura't de no registrar informació sensible.

Exercicis Pràctics

Exercici 1: Configuració Bàsica del Registre

  1. Crea un fitxer main.go.
  2. Configura el registre utilitzant la biblioteca estàndard log per escriure a un fitxer.
  3. Escriu missatges de registre amb diferents nivells (info, warning, error).

Exercici 2: Ús de Logrus

  1. Instal·la la biblioteca logrus.
  2. Configura logrus per escriure registres en format JSON.
  3. Escriu missatges de registre amb camps addicionals.

Exercici 3: Ús de Zap

  1. Instal·la la biblioteca zap.
  2. Configura zap per escriure registres en format JSON.
  3. Escriu missatges de registre amb camps addicionals.

Solucions

Solució a l'Exercici 1

package main

import (
    "log"
    "os"
)

func main() {
    file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    if err != nil {
        log.Fatal(err)
    }
    log.SetOutput(file)

    log.Println("INFO: Aquest és un missatge informatiu.")
    log.Println("WARNING: Aquest és un missatge d'advertència.")
    log.Println("ERROR: Aquest és un missatge d'error.")
}

Solució a l'Exercici 2

package main

import (
    log "github.com/sirupsen/logrus"
)

func main() {
    log.SetFormatter(&log.JSONFormatter{})

    log.WithFields(log.Fields{
        "event": "event_name",
        "topic": "topic_name",
    }).Info("Aquest és un missatge informatiu amb camps.")
}

Solució a l'Exercici 3

package main

import (
    "go.uber.org/zap"
)

func main() {
    logger, _ := zap.NewProduction()
    defer logger.Sync()

    logger.Info("Aquest és un missatge informatiu.",
        zap.String("event", "event_name"),
        zap.String("topic", "topic_name"),
    )
}

Conclusió

En aquesta secció, hem après la importància del registre en el desenvolupament de programari i com implementar-lo en aplicacions Go utilitzant la biblioteca estàndard log i altres biblioteques populars com logrus i zap. També hem vist consells i millors pràctiques per a un registre efectiu. Amb aquests coneixements, estàs preparat per monitoritzar i depurar les teves aplicacions de manera més eficient.

◄ Anterior
◄
Següent ►
►
El Projecte | Sobre nosaltres | Contribuir | Donacions | Llicència
© Copyright 2024. Tots els drets reservats