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