Documentation
¶
Overview ¶
Package log 提供共享的基于 Zap 的日志 add-in。
可通过 L 和 S 从 add-in provider 中获取 Logger 或 SugaredLogger，并通过 With 自定义基础日志器。
Index ¶
- Variables
- func JSON(key string, v any) zap.Field
- func JSONRawByteString(key string, v []byte) zap.Field
- func JSONRawString(key string, v string) zap.Field
- func JSONRawStringer(key string, v fmt.Stringer) zap.Field
- func L(provider extension.AddInProvider) *zap.Logger
- func S(provider extension.AddInProvider) *zap.SugaredLogger
- type ILogger
- type LoggerOptions
Constants ¶
This section is empty.
Variables ¶
View Source
var ( // AddIn 是可安装到 service 或 runtime 的日志 add-in 入口。 AddIn = define.AddIn(newLogger) )
View Source
var With _Option
With 提供日志 add-in 的 Option 构造方法。
Functions ¶
func JSONRawByteString ¶ added in v0.3.68
JSONRawByteString 将 v 作为未经校验的原始 JSON 写入字段。
func JSONRawString ¶ added in v0.3.68
JSONRawString 将 v 作为未经校验的原始 JSON 写入字段。
func JSONRawStringer ¶ added in v0.3.68
JSONRawStringer 创建一个延迟调用 String 的原始 JSON 字段。 String 的返回值必须是有效 JSON。
func L ¶ added in v0.3.68
func L(provider extension.AddInProvider) *zap.Logger
L 返回 provider 上安装的结构化日志器；日志 add-in 未安装时会 panic。
func S ¶ added in v0.3.68
func S(provider extension.AddInProvider) *zap.SugaredLogger
S 返回 provider 上安装的 SugaredLogger；日志 add-in 未安装时会 panic。
Types ¶
type ILogger ¶
type ILogger interface {
// Logger 返回带当前 service 或 runtime 字段的结构化日志器。
Logger() *zap.Logger
// SugaredLogger 返回与 Logger 共享底层 Core 的 SugaredLogger。
SugaredLogger() *zap.SugaredLogger
}
ILogger 提供结构化及糖化的 Zap 日志器。
type LoggerOptions ¶ added in v0.3.68
LoggerOptions 配置日志 add-in 使用的基础 Zap 日志器。
Source Files
Click to show internal directories.
Click to hide internal directories.