LuaLogService:new

The constructor for a LuaLogService object (creates a new LuaLogService).

IMPORTANT:

Do not create a new log service to write messages to standard log types. Obtain a LuaLog object through the function get_log instead.

Syntax

LuaLogService:new( config )

Arguments

Argument Description
config (LuaConfig) The configuration object to read the logging settings from. You can obtain a LuaConfig object through the function get_config.

Returns

(LuaLogService). The new LuaLogService object.

Example

The following example creates a LuaLogService object to write log messages to a custom log file named lua.log. Declare the log service globally to avoid a LuaLogService object being created every time the script runs. For example, if you are writing a Lua script to use with a connector or CFS, create the LuaLogService outside the handler function. Otherwise, the server creates a LuaLogService object for every document that is processed.

local luaConfigString = [===[
[Logging]
LogLevel=FULL
0=LuaLogStream

[LuaLogStream]
LogTypeCSVs=lua
LogFile=lua.log
]===]
    
local config = LuaConfig:new(luaConfigString)

-- global log service instance for Lua log stream
luaLogService = LuaLogService:new(config)

local luaLog = luaLogService:get_log("lua")
luaLog:write_line(log_level_normal(), "running Lua script")

_HP_HTML5_bannerTitle.htm