日志

支持 debug、info、warn 和 error 级别的结构化日志。

加载

local logger = require("logger")

日志级别

Debug

logger:debug("message", {key = "value"})
参数 类型 描述
message string 日志消息
fields table? 上下文键值对

Info

logger:info("message", {key = "value"})
参数 类型 描述
message string 日志消息
fields table? 上下文键值对

Warn

logger:warn("message", {key = "value"})
参数 类型 描述
message string 日志消息
fields table? 上下文键值对

Error

logger:error("message", {key = "value"})
参数 类型 描述
message string 日志消息
fields table? 上下文键值对

日志器自定义

附加字段

创建带持久字段的子日志器。

local child = logger:with({request_id = id})
child:info("message")
参数 类型 描述
fields table 附加到所有日志的字段

返回: Logger

命名日志器

创建命名的子日志器。

local named = logger:named("auth")
named:info("message")
参数 类型 描述
name string 日志器名称

返回: Logger

错误

logger:named("") 会抛出 Lua 参数错误(name cannot be empty),而不是返回错误值。日志方法不返回任何内容。

错误处理请参阅 错误处理