Go-Spring :: Log v0.0.1 发布，基于 Tag 路由的结构化日志库

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 许可证发布。