raptor-logging

Module to support the optimized delivery of web application resources

raptor-logging

Super simple logging system that works on the server and and in the browser.

Example

projects/logging-test/run.js:

require('raptor-logging').configure({
    loggers: {
        'ROOT': 'WARN',
        'logging-test': 'DEBUG'
    }
});
 
// ... 
 
var logger = require('raptor-logging').logger(module);
logger.debug('This is a debug message');

Output:

DEBUG logging-test/run: This is a debug message

You can also pass multiple arguments, as well as non-String arguments to the logging methods.

For example:

var logger = require('raptor-logging').logger(module);
logger.debug('This is a debug message', {foo: 'bar'});

Output:

DEBUG logging-test/run: This is a debug message { foo: 'bar' }

Installation

npm install raptor-logging --save

API

Returns a new Logger instance whose name is based on the filename associated with the Node.js module object.

Example:

var logger = require('raptor-logging').logger(module);
logger.debug('Hello World');

Returns a new Logger instance with the given name

Example:

var logger = require('raptor-logging').logger('foo');
logger.debug('Hello World');

Output:

DEBUG foo: Hello World

Supported options:

  • loggers: A mapping of logger prefixes to log levels (see below)
  • appenders: An array of appender instances (see ConsoleAppender for an example appender implementation)

Example:

require('raptor-logging').configure({
    'ROOT': 'WARN',
    'foo': 'DEBUG',
    'foo/bar': 'WARN',
});

Methods:

  • isTraceEnabled() : boolean
  • isDebugEnabled() : boolean
  • isInfoEnabled() : boolean
  • isWarnEnabled() : boolean
  • isErrorEnabled() : boolean
  • isFatalEnabled() : boolean
  • dump(arg1, arg2, ...)
  • trace(arg1, arg2, ...)
  • debug(arg1, arg2, ...)
  • info(arg1, arg2, ...)
  • warn(arg1, arg2, ...)
  • error(arg1, arg2, ...)
  • fatal(arg1, arg2, ...)

Contributors

Contribute

Pull Requests welcome. Please submit Github issues for any feature enhancements, bugs or documentation problems.

License

Apache License v2.0