日志
支持 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),而不是返回错误值。日志方法不返回任何内容。
错误处理请参阅 错误处理。