XervoIO/logger

# Xervo logger

[![version](https://img.shields.io/npm/v/@xervo/logger.svg?style=flat-square)][version]
[![build](https://img.shields.io/travis/XervoIO/logger.svg?style=flat-square)][build]
[![coverage](https://img.shields.io/codeclimate/coverage/github/XervoIO/logger.svg?style=flat-square)][coverage]
[![code climate](https://img.shields.io/codeclimate/github/XervoIO/logger.svg?style=flat-square)][climate]
[![license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)][license]

A Winston wrapper with a simplified interface and opinionated output.

## Install

`npm install @xervo/logger`

## Usage

The returned object is a [winston] logger instance, so all behavior is
documented on that project. The addition of a namespace prefix mimics behavior
of our other favorite logger: [debug].

```
const Logger = require('@xervo/logger')('namespace')

Logger.info('message', { example: true })

// writes to process.stdout
// 2015-11-28T01:38:45.979Z INFO namespace message {"example":true}
```

### Log level

The default log level is `info`, but can be configured using the environment
variable `LOG_LEVEL`.

```
LOG_LEVEL=debug npm start
```

### Exceptions

All uncaught exceptions are automatically logged to `stderr` and the process is
exited. There is no need to add an additional handler. If you would like to
enable the additional behavior of writing all exceptions to a file, you can!
Just set an environment variable `EXCEPTION_LOG` to a writeable file.

```
EXCEPTION_LOG=/var/logs/myapp.exceptions.log npm start
```

[winston]: https://www.npmjs.com/package/winston
[debug]: https://www.npmjs.com/package/debug

[version]: https://www.npmjs.com/package/@xervo/logger
[build]: https://travis-ci.org/XervoIO/logger
[coverage]: https://codeclimate.com/github/XervoIO/logger/coverage
[climate]: https://codeclimate.com/github/XervoIO/logger/code
[license]: https://raw.githubusercontent.com/XervoIO/logger/master/LICENSE