Ut-log NPM | npm.io

ut-log

'ut-log' is a module aimed to provide logging functionality for the UT5 implementations. A basic log instance can be obtained with the following code:

var utLog = require('ut-log');
var utLogConfig = {
    type: 'bunyan',
    streams: [
        {
            level: 'trace',
            stream: 'process.stdout'
        }
    ]
};
var logFactory = new utLog(utLogConfig);
var log = logFactory.createLog('info', {name: 'a', context: 'b'});

ut-log module exposes a constructor for creating logFactory objects
The configuration object that the ut-log constructor accepts as an argument has to have properties type and streams (for bunyan) or transports (for winston) where:
- type is a string specifying which vendor node module will be used for logging. The possible values are: bunyan or winston
- streams (for bunyan) is an array of objects where each object specifies a single logging stream or transports (for winston) is an object of transports. For more information visit bunyan streams and winston transports
The logFactory object has a single method (createLog) which has to be called in order for a log instance to get obtained. logFactory.createLog method has 2 arguments: level and params
- level is a string specifying the minimum logging level the logger will be able to log to. The possible values for this argument are: trace, debug, info, warn, error, fatal.
Each log level has a weight and the priority of the levels is as listed above.

Once having the log instantiated it can be used to log data across all specified streams simultaneously (in this case only the NodeJS console through process.stdout). Logging itself happens by calling one of the log's methods (logFactory.createLog returns an object with each logging level assigned as a method). In our case, because we set 'info' as a minimum logging level, the 'log' object will be equipped with 4 methods:

log.info
log.warn
log.error
log.fatal

To log something, pass the data that needs to be log as an argument to some of the functions listed above. E.g:

log.info('log message');

Doing so will log the data to all specified streams with a minimum level equal to 'info' or higher. For optimal performance all log method calls should always be verified before being called so that changing the global logFactory object's minimum log level should not break the code and high volume log data will not occupy memory. I.e. logging should always happen like:

log.info && log.info('log message');

Multiple streams example:

var utLog = require('ut-log');
var level = require('level');
var path = require('path');
// stream constructors
var SocketStream = require('ut-log/socketStream');
var LevelDBStream = require('ut-log/leveldbStream');
var SentryStream = require('ut-log/sentryStream');
var LogRotateStream = require('ut-log/logRotateStream');

var utLogConfig = {
    type: 'bunyan',
    transformData: {
        // which field should be (hidden/overwritten with *) value from log
        id: 'hide'
    },
    streams: [
        {
            level: 'trace',
            stream: 'process.stdout'
        },
        {
            level: 'trace',
            stream: new SocketStream({
                host: '127.0.0.1',
                port: '30001',
                objectMode: true
            }),
            type: 'raw'
        },
        {
            level: 'trace',
            stream: new LevelDBStream({
                dbPath: './leveldbLogs'
            }),
            type: 'raw'
        },
        {
            level: 'error',
            stream: new SentryStream({
                dsn : 'http://b62b47864e93466cbb16a2b4a1d749b1:05968d770cdf4f8f8f09985d95ea9911@sentry.softwaregroup.com:49161/2',
                patchGlobal: true,
                logger: 'impl-test'
            }),
            type: 'raw'
        },
        {
            level: 'trace',
            stream: new LogRotateStream({
                path : path.join('logs', 'ut5_%Y-%m-%d.log'),
                symlink: path.join('logs', 'ut5.log'),
                compress: true
            })
        }
    ]
};
var logFactory = new utLog(utLogConfig);
var log = logFactory.createLog('info', {name: 'a', context: 'b'});