Skip to content

API 参考

DD 日志库提供丰富的 API 接口,按功能模块组织如下:

核心组件

模块说明文档
包函数全局日志函数、便捷构造器包函数
Logger核心日志记录器及其方法Logger
LoggerEntry预设字段的日志 EntryLoggerEntry
Config配置结构体和预设配置配置
接口CoreLogger、LogProvider 等接口接口定义

输出与写入

模块说明文档
WritersFileWriter、BufferedWriter、MultiWriter输出目标
上下文Context 集成和 ContextExtractor上下文集成

扩展功能

模块说明文档
Fields结构化字段构造器(20+ 类型)结构化字段
Hooks生命周期钩子系统钩子系统
Security敏感数据过滤和安全配置安全过滤
Audit审计日志和审计事件审计日志
Integrity日志完整性签名和验证完整性签名

辅助工具

模块说明文档
Debug VisualPrint/JSON/Text/Exit 调试函数调试输出
Recorder测试辅助日志记录器测试辅助
Constants日志级别、格式、错误码常量与错误

快速定位

go
// 基础使用
dd.Info("message")                        // → 包函数
dd.InfoWith("msg", dd.String("k", "v"))   // → 包函数 + Fields

// 创建自定义日志记录器
logger, _ := dd.New(dd.DefaultConfig())    // → 包函数 + Config
logger.WithFields(fields).Info("msg")      // → Logger + Entry

// 文件输出
fw, _ := dd.NewFileWriter("logs/app.log", dd.DefaultFileWriterConfig())  // → Writers

// 安全
sec := dd.DefaultSecurityConfig()          // → Security
audit, _ := dd.NewAuditLogger(dd.DefaultAuditConfig())  // → Audit

下一步