Golang 可配置多写入器日志记录插件库 Logo 使用指南

Logo 是一个轻量级的 Go 日志库，支持多写入器配置，可以将日志同时输出到控制台、文件、网络等多种目标。下面我将详细介绍如何使用 Logo 库。

安装 Logo

首先使用 go get 安装 Logo 库：

go get github.com/ebrianne/logo

基本使用

简单示例

package main

import (
	"github.com/ebrianne/logo"
)

func main() {
	// 创建一个默认的日志记录器（输出到控制台）
	logger := logo.New()

	// 记录不同级别的日志
	logger.Debug("This is a debug message")
	logger.Info("This is an info message")
	logger.Warn("This is a warning message")
	logger.Error("This is an error message")
}

配置多个写入器

package main

import (
	"github.com/ebrianne/logo"
	"os"
)

func main() {
	// 创建配置
	config := logo.Configuration{
		MinLevel: logo.Debug,
		Writers: []logo.WriterConfig{
			{
				Writer:    os.Stdout, // 控制台输出
				Formatter: logo.NewJSONFormatter(),
				Levels:    []logo.Level{logo.Debug, logo.Info, logo.Warn, logo.Error},
			},
			{
				Writer:    logo.NewFileWriter("app.log"), // 文件输出
				Formatter: logo.NewTextFormatter(),
				Levels:    []logo.Level{logo.Warn, logo.Error},
			},
		},
	}

	// 使用配置创建日志记录器
	logger := logo.NewWithConfig(config)

	// 记录日志
	logger.Debug("Debug message")
	logger.Info("Info message")
	logger.Warn("Warning message")
	logger.Error("Error message")
}

高级配置

自定义格式化

package main

import (
	"github.com/ebrianne/logo"
	"os"
)

func main() {
	// 自定义格式化函数
	customFormatter := func(level logo.Level, message string) string {
		return fmt.Sprintf("[%s] %s - %s\n", time.Now().Format("2006-01-02 15:04:05"), level.String(), message)
	}

	config := logo.Configuration{
		MinLevel: logo.Info,
		Writers: []logo.WriterConfig{
			{
				Writer: os.Stdout,
				Formatter: logo.FormatterFunc(customFormatter),
				Levels:    []logo.Level{logo.Info, logo.Warn, logo.Error},
			},
		},
	}

	logger := logo.NewWithConfig(config)
	logger.Info("Custom formatted message")
}

添加字段

package main

import (
	"github.com/ebrianne/logo"
)

func main() {
	logger := logo.New()
	
	// 添加字段到日志
	logger.WithFields(logo.Fields{
		"user_id": 123,
		"action":  "login",
	}).Info("User logged in")
}

动态修改日志级别

package main

import (
	"github.com/ebrianne/logo"
)

func main() {
	logger := logo.New()
	
	// 默认只记录Info及以上级别
	logger.Info("This will be logged")
	logger.Debug("This won't be logged")
	
	// 动态修改为Debug级别
	logger.SetMinLevel(logo.Debug)
	logger.Debug("Now this will be logged")
}

最佳实践

1. 生产环境配置：在生产环境中，建议将Debug日志写入文件而不输出到控制台

2. 错误处理：对于关键错误，可以配置额外的写入器发送到监控系统

3. 性能考虑：对于高频日志，考虑使用异步写入器

package main

import (
	"github.com/ebrianne/logo"
	"os"
)

func main() {
	config := logo.Configuration{
		MinLevel: logo.Info,
		Writers: []logo.WriterConfig{
			{
				Writer:    logo.NewAsyncWriter(os.Stdout), // 异步控制台输出
				Formatter: logo.NewJSONFormatter(),
				Levels:    []logo.Level{logo.Info, logo.Warn},
			},
			{
				Writer:    logo.NewFileWriter("errors.log"),
				Formatter: logo.NewTextFormatter(),
				Levels:    []logo.Level{logo.Error},
			},
		},
	}

	logger := logo.NewWithConfig(config)
	
	// 高频日志不会阻塞主程序
	for i := 0; i < 1000; i++ {
		logger.Info("Processing item", logo.Fields{"item": i})
	}
}

Logo 提供了灵活而强大的日志记录功能，通过合理配置可以满足各种日志需求，同时保持代码简洁和高效。