Logging

Logging

Structured logging with debug, info, warn, and error levels.

Loading

local logger = require("logger")

Log Levels

Debug

logger:debug("message", {key = "value"})

Parameter	Type	Description
message	string	Log message
fields	table?	Contextual key-value pairs

Info

logger:info("message", {key = "value"})

Parameter	Type	Description
message	string	Log message
fields	table?	Contextual key-value pairs

Warn

logger:warn("message", {key = "value"})

Parameter	Type	Description
message	string	Log message
fields	table?	Contextual key-value pairs

Error

logger:error("message", {key = "value"})

Parameter	Type	Description
message	string	Log message
fields	table?	Contextual key-value pairs

Logger Customization

With Fields

Create a child logger with persistent fields.

local child = logger:with({request_id = id})
child:info("message")

Parameter	Type	Description
fields	table	Fields to attach to all logs

Returns: Logger

Named Logger

Create a named child logger.

local named = logger:named("auth")
named:info("message")

Parameter	Type	Description
name	string	Logger name

Returns: Logger

Errors

Condition	Kind	Retryable
Empty name string	errors.INVALID	no

See Error Handling for working with errors.