log.q

Log - Console Logger

This library is inspired by Java's log4j and similar logging systems providing a simple console logger with the following features:

• Consistent logging information
• Configurable log level support from TRACE to FATAL
• Multiple default logging formats and support for extensions
  • Basic logging
  • Color logging for WARN, ERROR and FATAL log levels
  • syslog supported logging

Log Format

The library uses a standard logging format for each line that is printed to the terminal:

• UTC date and time (.z.d and .z.t)
• Log level (one of TRACE, DEBUG, INFO, WARN, ERROR, FATAL)
• Process identifier (pid-*pid*)
• Current user (.z.u)
• Current handle (.z.w)

An example informational message

q) .log.info "An info message"
2017.03.06 15:23:41.453 INFO pid-14448 jasra_000 0 An info message

Changing Log Levels

By default when the log library is initialised, it defaults to INFO. If the process is started in debug mode, which is defined by using the -e command line argument, the level is set to DEBUG.

The configured log level is printed when the library is initialised:

Logging enabled [ Level: INFO ] [ Current Logger: `.log.loggers.basic ]

You can use .log.setLevel to change it as necessary post initialisation.

Changing the Logger

The following loggers are supplied by default:

• .log.loggers.basic: Simple space-separated logging
• .log.loggers.color: Space-separated logging with color highlighting for WARN, ERROR and FATAL levels
• .log.loggers.syslog: syslog compatible space-separated logging
• .log.loggers.json: JSON formatted logging

By default, the basic logger will be enabled but the other loggers can be selected by the following:

• .log.loggers.color: If the environment variable KDB_COLORS or the command line argument -logColors is specified
• .log.loggers.syslog: If the environment variable KDB_LOG_SYSLOG or the command line argument -logSyslog is specified
• .log.loggers.json: If the environment variable KDB_LOG_JSON or the command line argument -logJson is specified

For example, color output looks as follows:

Changing Process Identifier

By default, the process is identified by its PID, in the form pid-*pid*. However, you can change it any point to be more descriptive by setting .log.process:

q) .log.info "Hi"

q).log.info "Hi"
2018.08.24 15:36:02.709 INFO pid-87646 jrajasansir 0 Hi
q) .log.process:`myProcess
q) .log.info "Hi again"
2018.08.24 15:36:31.161 INFO myProcess jrajasansir 0 Hi again

Adding Your Own Logger

To add your own logger, you must modify the dictionary .log.cfg.loggers:

1. The key of the dictonary is a symbol reference to the logging function to use
2. The value of the dictionary is a function that determines when the function should be used

NOTE: That the first function that returns true will be the logger selected.

The logging function defined must accept the following 3 arguments:

• fd: The file descriptor to output the log line
• lvl: The log level of the current message as a symbol (e.g. `INFO)
• message: The log message as a string

Once the configuration dictionary has been modifed, call .log.setLogger.

Example

q) .jas.customLogger:{[fd; lvl; message] -1 " " sv ("Logging: ";string lvl;message) };

/ Make .jas.customLogger the first entry in the config dictionary and always be used
q) .log.cfg.loggers:(enlist[`.jas.customLogger]!enlist { 1b }),.log.cfg.loggers;
q) .log.setLogger[];

Logging enabled [ Level: INFO ] [ Current Logger: `.jas.customLogger ]

q) .log.info "A log message";
Logging:  INFO A log message