DD
DD（源码注释中读作 "data-driven" 或 "distributed debugger"）是 CyberGo 组织推出的高性能结构化日志库，提供线程安全的日志记录、灵活的输出目标配置和全面的安全防护。
特性
- 结构化日志 -- 支持类型安全的字段记录，可选 JSON 格式输出
- 多输出目标 -- 同时输出到控制台、文件、自定义
io.Writer - 文件轮换 -- 按大小自动轮换，支持备份数量限制和时间保留策略
- 敏感数据过滤 -- 内置正则模式，自动脱敏密码、密钥、Token 等敏感信息
- 字段验证 -- 字段键命名约定校验（snake_case/camelCase 等）与 Log4Shell 注入防护
- 审计日志 -- 异步审计事件记录，支持 HMAC 完整性签名与序列号
- 钩子系统 -- BeforeLog、AfterLog、OnRotate 等生命周期钩子
- 上下文集成 -- 提供 TraceID/SpanID/RequestID 的 context 工具与 ContextExtractor 扩展点（日志方法不接收 ctx，需通过 WithFields 传入字段）
- 日志采样 -- 高吞吐场景下可选的日志采样策略
- 低分配优化 -- 热路径最小化内存分配，性能卓越
安装
bash
go get github.com/cybergodev/dd快速开始
go
package main
import (
"time"
"github.com/cybergodev/dd"
)
func main() {
// 使用默认日志记录器
dd.Info("服务启动")
// 结构化日志
dd.InfoWith("请求处理完成",
dd.String("method", "GET"),
dd.Int("status", 200),
dd.Duration("elapsed", 150*time.Millisecond),
)
// 创建自定义日志记录器
logger, _ := dd.New(dd.DefaultConfig())
defer logger.Close()
logger.Info("自定义日志记录器已创建")
}模块导航
| 模块 | 说明 |
|---|---|
| 核心概念 | Logger 体系、处理管道、接口层次 |
| 配置详解 | Config 结构体、预设方案、输出目标 |
| 结构化日志 | 字段构造器、链式调用 |
| 文件输出与轮换 | FileWriter、BufferedWriter |
| 日志采样 | 高吞吐场景日志降量策略 |
| 钩子系统 | 生命周期钩子扩展 |
| 错误处理 | 结构化错误、哨兵错误、errors.Is |
| 敏感数据过滤 | 自动脱敏、安全等级 |
| 字段验证 | 命名约定校验、Log4Shell 防护 |
| 审计日志 | 异步审计事件、完整性签名 |
| 分布式追踪集成 | TraceID/SpanID/RequestID |
| 迁移指南 | 从 log/slog/zap/logrus 迁移 |