Golang多目标可定制日志系统插件库xlog使用指南

xlog是一个功能强大的Golang日志库，支持多种日志输出目标、日志级别控制和插件化架构。下面我将详细介绍如何使用xlog实现多目标可定制的日志系统。

1. 安装xlog

首先安装xlog库：

go get github.com/rs/xlog

2. 基本使用

package main

import (
	"github.com/rs/xlog"
)

func main() {
	// 创建默认配置的logger
	logger := xlog.New(xlog.Config{
		Level: xlog.LevelInfo, // 设置日志级别
	})
	
	// 输出不同级别的日志
	logger.Debug("调试信息")  // 不会输出，因为级别高于Debug
	logger.Info("普通信息")   // 会输出
	logger.Warn("警告信息")   // 会输出
	logger.Error("错误信息")  // 会输出
}

3. 多目标输出配置

xlog支持同时输出到控制台、文件和网络等多种目标：

package main

import (
	"os"
	
	"github.com/rs/xlog"
)

func main() {
	// 创建多目标logger
	logger := xlog.New(xlog.Config{
		Level: xlog.LevelDebug,
		Output: xlog.MultiOutput(
			// 输出到控制台
			xlog.NewConsoleOutput(),
			// 输出到文件
			xlog.NewOutput(&xlog.OutputFileConfig{
				Filename: "app.log",
				FileMode: os.FileMode(0644),
			}),
		),
	})
	
	logger.Info("这条日志会同时输出到控制台和文件")
}

4. 自定义日志格式

package main

import (
	"time"
	
	"github.com/rs/xlog"
)

func main() {
	logger := xlog.New(xlog.Config{
		Level: xlog.LevelInfo,
		Output: xlog.NewConsoleOutputWithFormatter(func(config xlog.FormatterConfig, entry *xlog.Entry) []byte {
			// 自定义日志格式
			return []byte(time.Now().Format("2006-01-02 15:04:05") + 
				" [" + entry.Level.String() + "] " + 
				entry.Message + "\n")
		}),
	})
	
	logger.Info("自定义格式的日志消息")
}

5. 插件扩展

xlog支持通过插件扩展功能，例如添加字段、过滤日志等：

package main

import (
	"github.com/rs/xlog"
)

// 自定义插件示例
type myPlugin struct{}

func (p *myPlugin) HandleLog(entry *xlog.Entry) {
	// 为每条日志添加固定字段
	entry.Fields = append(entry.Fields, xlog.F{"app": "myapp"})
}

func main() {
	logger := xlog.New(xlog.Config{
		Level: xlog.LevelInfo,
		Output: xlog.NewConsoleOutput(),
	})
	
	// 添加插件
	logger.AddPlugins(&myPlugin{})
	
	logger.Info("这条日志会包含app=myapp字段")
}

6. 高级配置

package main

import (
	"os"
	
	"github.com/rs/xlog"
)

func main() {
	// 更复杂的配置示例
	logger := xlog.New(xlog.Config{
		Level: xlog.LevelDebug,
		Fields: xlog.F{
			"version": "1.0.0",
			"env":     os.Getenv("APP_ENV"),
		},
		Output: xlog.MultiOutput(
			xlog.NewConsoleOutput(),
			xlog.NewOutput(&xlog.OutputFileConfig{
				Filename: "error.log",
				FileMode: os.FileMode(0644),
				Filter: func(entry *xlog.Entry) bool {
					// 只记录错误级别以上的日志到文件
					return entry.Level >= xlog.LevelError
				},
			}),
		),
	})
	
	// 使用带字段的日志
	logger.WithField("user_id", 123).Info("用户登录")
	logger.WithFields(xlog.F{
		"ip": "192.168.1.1",
		"ua": "Mozilla/5.0",
	}).Warn("可疑访问")
}

7. 最佳实践

1. 全局logger：在大型应用中，可以创建一个全局logger实例供整个应用使用

package main

import (
	"github.com/rs/xlog"
)

var logger = xlog.New(xlog.Config{
	Level: xlog.LevelInfo,
	Output: xlog.NewConsoleOutput(),
})

func main() {
	logger.Info("使用全局logger")
}

1. 上下文logger：为特定请求创建带上下文的logger

func handleRequest(req *http.Request) {
	reqLogger := logger.WithFields(xlog.F{
		"request_id": req.Header.Get("X-Request-ID"),
		"path":       req.URL.Path,
	})
	
	reqLogger.Info("处理请求")
}

xlog提供了强大的日志功能，通过灵活的配置和插件机制，可以满足各种复杂的日志需求。建议根据实际项目需求选择合适的日志级别、输出目标和格式。