60 lines
5.0 KiB
Markdown
60 lines
5.0 KiB
Markdown
# Changelog
|
||
|
||
## [1.1.3] - 2026-05-05
|
||
- **自动化增强**:
|
||
- 引入 `StackTraceable` 接口，`Log(entry)` 现在支持自动补全调用栈（当字段为空时）。
|
||
- `WarningLog` 和 `ErrorLog` 默认集成自动补全契约，外部业务无需再手动调用堆栈捕获函数。
|
||
- **架构收敛**: 撤销 `GetCallStacks` 导出，将堆栈逻辑完全封装在基础设施层。
|
||
- **清理**: 移除 `extra.go` 中过时的示例注释。
|
||
- **架构解耦**:
|
||
- 正式移除 `log` 包对数据库日志（`DB` 方法及 `DBLog` 结构）的内置支持，推动“日志格式随业务走”的架构对齐。
|
||
- 导出 `GetCallStacks` 方法，支持外部包捕获符合截断配置的调用栈。
|
||
- **内部优化**:
|
||
- `fillBase` 回归私有，强化 `Log(entry)` 的自动填充契约，降低外部摩擦。
|
||
- **体验对齐**:
|
||
- 修复 `viewer.go` 中空错误字符串导致日志类型被跳过显示的 Bug。
|
||
- `Log` 方法集成 `fillBase` 自动补全逻辑，对于直接调用 `Log(entry)` 的自定义日志类型，若未设置时间戳则自动填充元数据，无需手动干预。
|
||
- **生态同步**: 依赖 `config` 升级至 v1.0.5。
|
||
|
||
## [1.1.0] - 2026-05-05
|
||
- **性能质变**:
|
||
- `GetEntry` 改为泛型实现 `GetEntry[T]()`，消除 `reflect.Type` 传参及运行时类型断言。
|
||
- 主路径零反射：增强 `LogEntry` 接口，支持通过 `GetBaseLog()` 直接获取 `BaseLog` 指针，填充基础字段耗时降至 $O(1)$。
|
||
- 极速时间戳：`LogTime` 改为 `int64` (纳秒)，完全消除了日志写入时的 `time.Format` 开销。
|
||
- `FileWriter` 重构：采用单协程 `bufio` 无锁写入架构，支持 64KB 缓冲区与高性能文件轮转。
|
||
- **架构加固**:
|
||
- 引入 `logPayload` 路由包裹，彻底解决多 Logger 实例异步写入时的“串话”漏洞。
|
||
- 修复同步 Fallback 模式下的线程安全隐患。
|
||
- **扩展恢复**: 重新启用 `extra.go` 中的标准日志结构（Request, DB, Task, Monitor, Statistic），并完成泛型化适配。
|
||
- **可视化优化**: 重构 `Viewable` 逻辑，基于 `strings.Builder` 和 `cast` 包优化 JSON 解析，渲染速度提升 2-3 倍。
|
||
|
||
## [1.0.3] - 2026-05-05
|
||
- **接口规范化**: 重构 `Logger.Request` 方法，由传递结构体指针改为接收明确参数（method, path, status, usedTime），并支持通过 `extra` 自动填充 `RequestLog` 的 20+ 个业务字段。
|
||
- **架构解耦**: 将 `extra.go` 中的所有预定义日志结构及其快捷方法注释掉。仅作为示例供应用端参考实现，推动“应用自维护日志结构”的标准规范。
|
||
- **类型安全性**: 强化 `Logger.Log` 方法约束，仅接受实现 `LogEntry` 接口（通常继承自 `BaseLog`）的类型，不再支持任意 `any` 格式。
|
||
- **文档完善**: `README.md` 新增“自定义日志扩展”指南，明确了 `BaseLog` 继承、`GetEntry` 对象池获取及 `Log` 发送的完整闭环。
|
||
- **测试对齐**: 更新所有测试用例与基准测试，演示如何在应用端定义和使用自定义日志结构。
|
||
|
||
## [1.0.2] - 2026-05-04
|
||
- **设计优化**: 引入 `ResetLogEntry` 自动化重置机制，基于反射和缓存实现日志对象字段的自动初始化与清空（Map/Slice 默认容量 8）。
|
||
- **接口精简**: 简化 `LogEntry` 接口为标记接口，移除了冗余的 `Base()` 和 `Reset()` 手动实现。
|
||
- **扩展性增强**: `Task`, `Monitor`, `Statistic`, `DB` 等快捷方法全面支持变长 `extra ...any` 参数，并集成 `cast.ToMap` 自动转换。
|
||
- **构建修复**: 修复了 `convert` 模块对 `cast` 新 API 的兼容性问题。
|
||
|
||
## [1.0.1] - 2026-05-04
|
||
- **结构增强**: `DBLog` 结构体新增 `Error` 和 `CallStacks` 字段，提升数据库错误诊断效率。
|
||
- **DB 方法重构**: `Logger.DB` 方法支持可选错误参数，自动处理 `dbError` 类型并记录调用栈。
|
||
- **扩展日志支持**: 新增 `TaskLog`, `MonitorLog`, `StatisticLog` 标准结构及其 `Logger` 快捷方法，置于 `extra.go`。
|
||
- **RequestLog 封装**: `Logger` 新增 `Request` 方法，简化请求日志记录流程。
|
||
- **调用栈优化**: 优化 `getCallStacks` 逻辑，确保能正确捕获业务代码和测试代码的调用位置，同时过滤掉日志库内部帧。
|
||
|
||
## [1.0.0] - 2026-05-02
|
||
- **初始版本**: 由 `ssgo/log` 迁移并基于 `apigo.cc/go` 标准重构。
|
||
- **高性能引擎**: 引入 `LogEntry` 池化与 `sync.Pool` 复用，支持零分配日志对象。
|
||
- **异步写入**: 实现基于 Channel 的非阻塞异步写入引擎，将 IO 压力从主路径完全剥离。
|
||
- **批量刷盘**: `FileWriter` 引入 `bufio.Writer` 缓冲，`ESWriter` 优化 Bulk 请求构造，大幅提升 IO 吞吐量。
|
||
- **灵活格式**: 引入 `Formatter` 接口，支持 JSON 与文本等自定义格式。
|
||
- **增强视图**: 内置 `ConsoleWriter` 与增强型 `Viewer`，支持 `RequestLog` 高亮显示与状态码变色。
|
||
- **字段规范**: 统一字段 Key 为小写，确保跨平台解析一致性。
|
||
- **安全性**: 集成高性能字段脱敏能力，并提供幂等停机与 Panic 恢复机制。
|