Go-Spring :: Log 是一个高性能、可扩展的日志处理库，专为 Go 语言设计。它提供了灵活的日志记录功能，支持结构化日志、 上下文字段提取、多级日志配置以及多种输出方式，适用于各种服务端应用场景。

特性

• 多级日志支持：提供 Trace, Debug, Info, Warn, Error, Panic, Fatal 等日志级别，满足不同场景下的调试和监控需求。

• 结构化日志：支持以结构化的方式记录日志字段（如 trace_id, span_id），便于日志分析系统解析。

• 上下文支持：通过 context.Context 提取额外信息（如请求 ID、用户 ID）并自动附加到日志中。

• 标签系统：使用标签（Tag）机制区分不同模块或业务线的日志。

• 插件机制：

  • Appender：支持多种日志输出方式，包括控制台输出（Console）、文件写入（File）等。

  • Layout：提供文本格式（Text）和 JSON 格式（JSON）两种日志布局方式。

  • Logger：支持同步和异步日志记录器，异步记录器可防止日志写入阻塞主线程。

• 性能优化：提供缓冲区管理、事件池化（Event Pooling）以减少内存分配开销。

• 日志刷新：支持从配置文件动态刷新日志设置，方便运行时调整日志行为。

• 测试完备：所有核心模块均配有单元测试，确保稳定性和可靠性。

安装

go get github.com/go-spring/log

快速开始

以下是一个简单的示例，展示如何使用 Go-Spring :: Log 记录日志：

package main
import (	"context"
	"github.com/go-spring/log")
func main() {	// 设置上下文字段提取函数	log.FieldsFromContext = func(ctx context.Context) []log.Field {		return []log.Field{			log.String("trace_id", "0a882193682db71edd48044db54cae88"),			log.String("span_id", "50ef0724418c0a66"),		}	}
	// 加载配置文件	err := log.RefreshFile("log.xml")	if err != nil {		panic(err)	}
	ctx := context.Background()
	// 记录日志	log.Infof(ctx, log.TagDef, "This is an info message")	log.Errorf(ctx, log.TagBiz, "This is an error message")}

配置说明

Go-Spring :: Log 支持通过 XML 配置文件定义日志行为，例如：​​​​​​​

<?xml version="1.0" encoding="UTF-8"?><Configuration>    <Properties>        <Property name="LayoutBufferSize">100KB</Property>    </Properties>    <Appenders>        <Console name="console">            <JSONLayout bufferSize="${LayoutBufferSize}"/>        </Console>    </Appenders>    <Loggers>        <Root level="warn">            <AppenderRef ref="console"/>        </Root>        <Logger name="logger" level="info" tags="_com_request_*">            <AppenderRef ref="console"/>        </Logger>    </Loggers></Configuration>

插件开发

Go-Spring :: Log 提供了丰富的插件接口，开发者可以轻松实现自定义的 Appender、Layout 和 Logger。

许可证

Go-Spring :: Log 使用 Apache License 2.0 许可证发布。