BENE Logger #

The BENE Logger is a library, which wraps winston with default
parameters to be sent to all log messages using the instance.
It also provides the console.time and console.timeEnd functionality
to the logger, so that your log messages contain durations.
Additionally, it allows you to log to Elasticsearch directly.

Log levels ##

The log levels follow the syslog standard as laid out in RFC5424, and
are as follows:
``
{ emerg: 0, alert: 1, crit: 2, error: 3, warning: 4, notice: 5, info: 6, debug: 7 }
`

You can specify the logger to only log up to a certain log level, by
passing in level to the options. For example to only log emerg,
alert, crit, and error logs, pass in level: 'error'.

Example usage ##

A simple log message is shown below:

`
var BeneLogger = require('bene-logger');
var logger = new BeneLogger({ defaults: { foo: 'bar' } });

logger.info('entering the void', { boo: 'moo' });
// info: entering the void boo=moo, foo=bar
`

Another example showing the usage of the setDefaults method:
`
var BeneLogger = require('bene-logger');

var logger = new BeneLogger({ defaults: {alpha: 'bravo'}});

logger.setDefaults({charlie: 'delta'});

logger.info('calling phonetic alphabet');
// info: calling phonetic alphabet charlie=delta
`

Below is an example of a timed log message:

`
var BeneLogger = require('bene-logger');
var logger = new BeneLogger({ defaults: { process_id: 1337 } });

logger.time('db request');

// ... request here that takes 1234ms

logger.timeEnd('db request', { request_id: 42 });
// info: db request request_id=42, process_id=1337, duration=1234
`

An Elasticsearch example is shown below:

`
var BeneLogger = require('bene-logger');
var logger = new BeneLogger({
defaults: { foo: 'bar' },
elasticsearch: {
indexPrefix: 'logs',
indexSuffixPattern: 'YYYY.MM.DD',
clientOpts: { host: 'http://localhost:9200' }
}
});

logger.info('entering the void', { boo: 'moo' });
// info: entering the void boo=moo, foo=bar
`

For more options to pass into the elasticsearch` property,
refer here.