Socket appender
This appender can be used to send log requests through a socket. Socket appender relies on LuaSocket to do its job.Upon each log request a connection is opened, the message is sent and the connection is closed.
function logging.socket { hostname = string, port = number, [logPattern = string,] [logPatterns = { [logging.DEBUG = string,] [logging.INFO = string,] [logging.WARN = string,] [logging.ERROR = string,] [logging.FATAL = string,] },] [timestampPattern = string,] [logLevel = log-level-constant,] }
hostname
:
Hostname can be an IP address or a host name of the server where the log message will be sent.port
:
The port must be an integer number in the range [1..64K).logPatterns
:
A table with logPattern strings indexed by the log-levels. A logPattern specifies how the message is written.
If this parameter is omitted, a patterns table will be created with the parameterlogPattern
as the default value for each log-level. IflogPattern
also is omitted then each level will fall back to the current default setting, seelogging.defaultLogPatterns
.logPattern
:
This value will be used as the default value for each log-level that was omitted inlogPatterns
.timestampPattern
:
This is an optional parameter that can be used to specify a date/time formatting in the log message. Seelogging.date
for the format. The default is taken fromlogging.defaultTimestampPattern()
.logLevel
:
The initial log-level to set for the created logger.
Example
require"logging.socket" local logger = logging.socket { hostname = "localhost", port = 5000, } logger:info("logging.socket test") logger:debug("debugging...") logger:error("error!")