Logging routines

Detailed Description

The log package allows a script to write messages to the pipeline module's log file.

The log file is filtered on log level, and as such messages of a lower level than that the log file is currently set to will be ignored. The following log levels are available

• log.ALWAYS - This message is always logged
• log.CRITICAL
• log.ERROR
• log.NOTIFY
• log.WARN
• log.INFO
• log.DEBUG

Functions
	log.log (var level, var message)
	Log a message to the pipeline logfile. More...
	log.logline (var level, var message)
	Log a message to the pipeline logfile. More...
	log.getlevel ()
	Return the current log level.

Function Documentation

log.log	(	var	level,
		var	message
	)

Log a message to the pipeline logfile.

Parameters

level	- Log level
message	- Text to log

This function will cause the message to be logged to the pipeline module's logfile at the appropriate level

The following example will log some a message to the pipeline logfile at debug level

require("log")

function myfunc(symbolname)
   log(log.INFO,"This is a message related to symbol "..symbolname)
end

Note

This function will not append a new line character to the end of message.

log.logline	(	var	level,
		var	message
	)

Log a message to the pipeline logfile.

Parameters

level	- Log level
message	- Text to log

This function will cause the message to be logged to the pipeline module's logfile at the appropriate level

Note

This function will append a new line character to the end of message.