Skip to content
LuaLogging provides a simple API to use logging features in Lua. Its design was based on log4j.
Lua Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
doc Prepare release 1.3.0 Mar 5, 2013
src Catch exceptions when formatting log messages. Aug 22, 2014
tests
COPYRIGHT
Makefile Fix path to logging.lua Jun 8, 2012
Makefile.win Remove execute permissions from files that don't need it. Mar 5, 2013
README Prepare release 1.3.0 Mar 5, 2013
lualogging-1.2.0-1.rockspec Remove execute permissions from files that don't need it. Mar 5, 2013
lualogging-1.3.0-1.rockspec Prepare release 1.3.0 Mar 5, 2013
lualogging-scm-0.rockspec Remove execute permissions from files that don't need it. Mar 5, 2013

README

LuaLogging
==========
http://neopallium.github.com/lualogging/

LuaLogging provides a simple API to use logging features in Lua.
Its design was based on log4j. LuaLogging currently supports,
through the use of appenders, console, file, rolling file, email, socket and sql outputs.

Current version is 1.3.0. It was developed for Lua 5.1 & 5.2.

LuaLogging is free software and uses the same license as Lua. It is part of the Kepler Project.

Please see docs at http://neopallium.github.com/lualogging/ for more details

Installation
============

Release 1.3.0
-------------

With LuaRocks:

	$ sudo luarocks install lualogging

Latest Git revision
-------------------

With LuaRocks:

	$ sudo luarocks install https://github.com/Neopallium/lualogging/raw/master/lualogging-scm-0.rockspec

With make:

	$ sudo make


Guide lines for improved logging performance
============================================

The changes that I have made allow more complex log message formatting to be done only when 
that log level is enabled.  This will decrease the impact of logging statement when their level 
is disabled.

* Use string.format() style formatting:

logger:info("Some message prefix: val1='%s', val2=%d", "some string value", 1234)

* For more complex log message formatting:

local function log_callback(val1, val2)
	-- Do some complex pre-processing of parameters, maybe dump a table to a string.
	return string.format("Some message prefix: val1='%s', val2=%d", val1, val2)
end
-- function 'log_callback' will only be called if the current log level is "DEBUG"
logger:debug(log_callback, "some string value", 1234)


Something went wrong with that request. Please try again.