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