logolite

Lite Virtual Logger and Tracer

How to use it?

Create a logger object:

var LogAdapter = require('logolite').LogAdapter;

// connect to a logger instance (winston)
var winston = require('winston');
LogAdapter.connectTo(new winston.Logger({
    transports: [
        new winston.transports.Console({
            level: 'debug',
            json: false,
            timestamp: true,
            colorize: true
        })
    ]
}));

/*
// or a bunyan logger instance instead
var bunyan = require('bunyan');
LogAdapter.connectTo(bunyan.createLogger({
    name: 'myApplication',
    level: 'debug'
}));
*/

/*
// or a log4js logger instance
var log4js = require('log4js');
var log4jsLogger = log4js.getLogger();
log4jsLogger.level = 'debug';
LogAdapter.connectTo(log4jsLogger);
*/

// create a logger
var logger = LogAdapter.getLogger();

Create a LogTracer object and put message and loginfo into it:

var LogTracer = require('logolite').LogTracer;

var appTracer = LogTracer.ROOT.branch({
    key: 'appId',
    value: LogTracer.getLogID()
});

// ... your code here ...

// .has() is an alias of .isEnabledFor() method;
// .add() a map (key/value), .put() a single field (key, value)
logger.has('info') && logger.log('info', appTracer
    .add({
        message: 'app level logging message',
        intValue: 123,
        boolValue: true,
        objectData: { key1: 'value 1', key2: 'value 2' },
        strValue: 'simple string'
    })
    .put('singleField', 'put a single key/value')
    .put('anotherField', 1024)
    .toMessage({
        tags: ['FOR_TRACKING_ONLY', 'END_OF_FUNCTION'],
        text: 'Message - integer ${intValue}, str: ${strValue}!'
    }));

// ... your code here ...

// create a child tracer object
var subLevel = appTracer.branch({
    key: 'subLevel',
    value: LogTracer.getLogID()
});

logger.has('debug') && logger.log('debug', subLevel
    .add({
        name: 'Foo',
        percent: 51
    })
    .toMessage({
        text: '${percent}% completed...'
    }));

logger.has('debug') && logger.log('debug', subLevel
    .add({
        name: 'Foo',
        percent: 100
    })
    .toMessage({
        text: '${percent}% completed. The task "${name}" has done.'
    }));

// ... your code here ...

Environment variables

• LOGOLITE_INSTANCE_ID: (UUID string) predefined instance ID;
• LOGOLITE_INFO_MESSAGE: (string) Value of message field in libraryInfo logging object (default: "Application Information");
• LOGOLITE_DEFAULT_SECTOR: (string) default sector name for debug module (default: logolite-default, to display this sector: DEBUG=logolite*,other*);
• LOGOLITE_ALWAYS_ENABLED: (string) the list of levels that are always enabled (default: none, "all" for all);
• LOGOLITE_AUTO_DETECT_FOR: ("bunyan"|"winston") detects for default bunyan or winston logging engine (default: none);
• LOGOLITE_DEBUGLOG_ENABLED: (true/false) forces using debug module to render logging message (default: false);
• LOGOLITE_DEBUGLOG_GREEDY: (string) the name for debug logging levels is forwarded to console (default: conlog);
• LOGOLITE_TAGS_EMBEDDABLE: (true/false) enable/disable to embed tags array to output message (default: true);
• LOGOLITE_TAGS_FIELD_NAME: (string) field name of embedded tags array in output log object (default: "tags");
• LOGOLITE_TEXT_EMBEDDABLE: (true/false) enable/disable to embed formatted message to output log object (default: true);
• LOGOLITE_TEXT_FIELD_NAME: (string) field name of formatted message string in output log object (default: "text");
• LOGOLITE_TEMPLATE_APPLIED: (true/false) enable/disable format logging object by template string (default: true);
• LOGOLITE_FORMAT_NOT_FOUND_VALUE: (string) value returned when a placeholder in template is not found (default: not_found_value);
• LOGOLITE_INTERCEPTOR_ENABLED: (true/false) enable/disable interception mode (default: true);
• LOGOLITE_STRINGIFY_DISABLED: (true/false) turns off stringify logging message when call toMessage() method (default: false);
• LOGOLITE_STRINGIFY_FAILED_VALUE: (string) value returned when stringify() is failed (default: stringify_failed);
• LOGOLITE_STRINGIFY_PROTECTED: (true/false) run JSON.stringify() inside try...catch block (default: true);
• LOGOLITE_BASE64_UUID: (true/false) enable/disable base64 UUID format (default true);