LuaLogService:new

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

IMPORTANT:

Do not create a new log service to write messages to log types that are defined in the Query Manipulation Server configuration file. Instead use the same log service as Query Manipulation Server, by calling get_log_service, or obtain a LuaLog object through the function get_log.

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