Logging

The ringo/logging module provides a rich and fine-grained logging API. It uses Simple Logging Facade for Java (SLF4J) as abstraction layer for various Java logging frameworks, e.g. java.util.logging, log4j2 and logback, allowing the end user to plug in the desired logging framework at deployment time.

By default, RingoJS comes with and uses Apache log4j 2.x. The default log4j configuration for RingoJS is in modules/config/log4j.properties. Web apps can override this by providing their own configuration in config/log4j.properties. Using this file, setting log levels for individual loggers/modules is straightforward. Another way is to call setConfig() and provide custom logging properties.

var logging = require("ringo/logging");
var loggingConfig = module.resolve("/path/to/log4j.properties");
logging.setConfig(getResource(loggingConfig));
var log = logging.getLogger(module.id);

All logger methods take a variable number of arguments. If the first argument passed to any of the logging methods is a string containing any number of curly bracket pairs ({}), the logger will interpret it as format string and use any following arguments to replace the curly bracket pairs. If an argument is an Error or Java Exception object, the logger will render a stack trace for it and append it to the log message. If the first string does not contain {} placeholders, or the number of arguments exceeds the number of placeholders, arguments are simply concatenated.

var log = require("ringo/logging").getLogger(module.id);
log.info("Hello {}", "world", 1, 2, 3);
// 0    [main] INFO  <shell>  - Hello world 1 2 3

Example log4j2.properties

The following properties show how you can use the logger name prefix. It overrides the default log level from INFO to DEBUG for the logger with the name example.logger.name and for Ringo's ringo/httpserver module.

rootLogger.level = info
rootLogger.appenderRefs = stdout
rootLogger.appenderRef.stdout.ref = stdout

logger.mylogger.name = example.logger.name
logger.mylogger.level = debug
logger.mylogger.appenderRefs = stdout

logger.httpserver.name = ringo.httpserver
logger.httpserver.level = debug
logger.httpserver.appenderRefs = STDOUT

appender.console.type = Console
appender.console.name = stdout
appender.console.layout.type = PatternLayout
appender.console.layout.pattern = [%-5level] [%t] %c - %msg%n