Skip to content

moteus/lua-log

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logging library for Lua 5.1/5.2

Build Status Build Status Licence


Usage

Write to roll file and to console

local LOG = require "log".new( -- maximum log level "trace", -- Writer require 'log.writer.list'.new( -- multi writers: require 'log.writer.console.color'.new(), -- * console color require 'log.writer.file.roll'.new( -- * roll files './logs', -- log dir 'events.log', -- current log name 10, -- count files 10*1024*1024 -- max file size in bytes ) ), -- Formatter require "log.formatter.concat".new() ) LOG.error("some", "error")

Write to file from separate thread

local LOG = require "log".new( require "log.writer.async.zmq".new( 'inproc://async.logger', function() -- calls from separate thread/Lua state return require 'log.writer.file.by_day'.new( './logs', 'events.log', 5000 ) end ) ) LOG.error("some error")

More complex example

local host = arg[1] or '127.0.0.1' local port = arg[2] or 514 -- this code run in separate thread. local InitWriter = [[  return require 'log.writer.list'.new( -- multi writers:  require 'log.writer.console.color'.new(), -- * console color  require 'log.writer.net.zmq'.new('%{zmq_cnn_host}'), -- * zmq pub socket  require "log.writer.format".new( -- * syslog over udp  require "log.logformat.syslog".new("user"),  require 'log.writer.net.udp'.new('%{udp_cnn_host}', %{udp_cnn_port})  )  ) ]] -- create async writer and run new work thread. -- communicate with work thread using zmq library local writer = require "log.writer.async.zmq".new( 'inproc://async.logger', InitWriter:gsub('%%{(.-)}', { zmq_cnn_host = 'tcp://' .. host .. ':' .. port; udp_cnn_host = host; udp_cnn_port = port; }) ) -- create new logger local LOG = require"log".new(writer) require "socket".sleep(0.5) -- net.zmq need time to connect LOG.fatal("can not allocate memory") LOG.error("file not found") LOG.warning("cache server is not started") LOG.info("new message is received") LOG.notice("message has 2 file") print("Press enter ...") io.flush() io.read()

Sendout logs to separate process/host

This example show how to send logs in 2 separate destination with 2 formats. Write to stdout as whell as to remote syslog server. In fact here no async on Lua side. Application write to network directly from main thread. But it is possible use one or more work threads that will do this.

-- Buld writer with 2 destinations local writer = require "log.writer.list".new( require "log.writer.format".new( -- explicit set logformat to stdout writer require "log.logformat.default".new(), require "log.writer.stdout".new() ), -- define network writer. -- This writer has no explicit format so it will -- use one defined for logger. require "log.writer.net.udp".new('127.0.0.1', 514) ) local function SYSLOG_NEW(level, ...) return require "log".new(level, writer, require "log.formatter.mix".new(), require "log.logformat.syslog".new(...) ) end local SYSLOG = { -- Define first syslog logger with some settings KERN = SYSLOG_NEW('trace', 'kern'), -- Define second syslog logger with other settings USER = SYSLOG_NEW('trace', 'USER'), } SYSLOG.KERN.emerg ('emergency message') SYSLOG.USER.alert ('alert message')

Dependences

core

writer.async.udp

writer.async.zmq

writer.async.lane

  • LuaLanes - This is experemental writer

writer.console.color

  • ansicolors
  • or lua-conio
  • or cio (Windows only)

writer.file.by_day

writer.net.udp

writer.net.zmq

writer.net.smtp

About

Asynchronous logging library for Lua

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 7