Go-Spring :: Log 是一个高性能、可扩展的日志处理库,专为 Go 语言设计。它提供了灵活的日志记录功能,支持结构化日志、 上下文字段提取、多级日志配置以及多种输出方式,适用于各种服务端应用场景。
特性
-
多级日志支持:提供 Trace, Debug, Info, Warn, Error, Panic, Fatal 等日志级别,满足不同场景下的调试和监控需求。
-
上下文支持:通过
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 许可证发布。




还没有评论,来说两句吧...