lagerjs v0.0.3

Lager

Lager enables you to collect data, organize it, and programmatically flush it to a single endpoint. Logs are separated by type, each of which contains an array of entries. Logs can then be flushed by type or all at once.

Logs are sent as a POST request in the form

{
  payload: {
    'type': [log[, log]],
    'type_2': [log[, log]]
    ...
  }
}

where log is an object of key-value pairs.

Install

Node

npm install lagerjs --save

Browser
Include build/lager.js or build/lager.min.js in your HTML file. Alternatively, you can build lager yourself with make.

##Usage Lager.log(type, data, flush)
Store log data and associate it with an type. Optionally set flush to true to send the data immediately. Flush is false by default.

Lager.flush(type)
Send all logs to the endpoint. Optionally give type, and only those logs will be sent.

Example

var Lager = require('lagerjs');

var logger = new Lager({
  host: 'yourserver.io/some-endpoint' // or whatever
});

logger.log('playstart', { name: 'wells' });
logger.log('playstart', { paused: true });
logger.log('playstart', { hd: false });
logger.log('playend', { seconds: 50 });

Will produce the following data in memory

{
  payload: {
    'playstart': [{ name: 'wells' }, {paused: true}, {hd: false}],
    'playend': [{ seconds: 50 }]
  }
}

Then send logs to a backend

logger.flush('playstart') // flush playstart logs only
logger.flush()            // alternatively flush everything