# overloop-log

overloop-log is a wrapper of [npmlog](https://github.com/npm/npmlog), all it's methods are availiable plus some extras detailed below.

## Features
* support for pushing logging to syslog (for logentries)
* morgan logging of hits with response_time etc
* hitIds using [continuation-local-storage](https://github.com/othiym23/node-continuation-local-storage) (cls)
* wrapping console.* so that they are logged in the same way
* logging line numbers for where errors are emitted
* integrated util.format support

## Install
```
npm install git+ssh://git@github.com/overloop-io/overloop-log.git#v0.0.1 --save
```

## Usage

### Standalone
In the code:
```javascript
var log = require('overloop-log');

log.init({
    'level': 'silly'
});

// standard usage
log.info('category','my message');

// standard usage with formating
log.warn('category','my %s message', '2nd');

// console...
console.log('my %s message is this', '3rd');
```

Stdout Output:
```
info category my message
WARN category my 2nd message
info console my 3rd message is this
```

### Express Middleware

```javascript
var log = require('overloop-log');

log.init({
    'level': 'silly'
});

var express = require('express');
var app = express();

app.use(log.express());
```
## Methods
### log.init()

Initialises the setting for the logging

#### showLines
#### stackTraceLimit
#### maxTraceLimit
#### lineLevel
#### logHitId
#### level
#### sysloglevel
#### stream
#### logUsers
#### root

### log.express()

Returns express middleware to log hits with response_time etc and formatted for use with logentries