logzilla/README.md

Node.js Logging Adapter for Devebot

# logzilla

[![NPM](https://nodei.co/npm/logzilla.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/logzilla/)

The simple winston based logging adapter using in devebot.

## Usage

Installs `logzilla` module:

``` bash
$ npm install --save logzilla
```

Creates a logzilla object and initializes it:

``` javascript
var LoggerFactory = require('logzilla');
var factory = new LoggerFactory({
  logger: {
    transports: [{
      type: 'console',
      level: 'trace'
    }, {
      type: 'dailyRotateFile',
      level: 'trace',
      json: false,
      datePattern: '.yyyy-MM-dd',
      filename: 'dailyfile.log'
    }, {
      type: 'logstash',
      level: 'trace',
      silent: true,
      host: '127.0.0.1',
      port: 28777
    }]
  }
});
var logger = factory.getLogger();
```

Uses the helper methods to log messages:

``` javascript
logger.error(' - this is an error: %s', err);
logger.warn(' - alert: this record should be index again.');
logger.trace(' - marks the startpoint of process ...');
logger.info(' - object detail: %s', JSON.stringify(doc));
logger.debug(' - display data and process in details');
```

### Change logger's level

To change logger level at runtime, you should use the setLevel() method:

``` javascript
// ... code that uses old loglevel

// set 'error' level to all transports
logger.setLevel('error');

// set 'trace' level to only 'console' transport
logger.setLevel('trace', 'console'); 

// set 'debug' level to both 'console' and 'logstash' transports
logger.setLevel('debug', ['console', 'logstash']);

// ... code that uses new loglevel
```

You can reset all logger transport levels to default levels:

```javascript
logger.resetDefaultLevels();
```

### Enable/disable transports

To disable the transports at runtime, use the follow method call:

``` javascript
// disable the logstash transport
logger.deactivate('logstash');
//logger.activate('logstash', false);

// or the list of transports
logger.deactivate(['dailyRotateFile', 'logstash']);
//logger.activate(['dailyRotateFile', 'logstash'], false);
```

To enable the tranports at runtime, use the `true` value in `activate()` method:

``` javascript
// enable the logstash transport
logger.activate('logstash');

// or the list of transports
logger.activate(['dailyRotateFile', 'logstash']);
```