winston

A MongoDB transport for winston.

Installation

Installing npm (node package manager)

  $ curl http://npmjs.org/install.sh | sh

Installing winston-mongodb

  $ npm install winston
  $ npm install winston-mongodb

Motivation

tldr;?: To break the winston codebase into small modules that work together.

The winston codebase has been growing significantly with contributions and other logging transports. This is awesome. However, taking a ton of additional dependencies just to do something simple like logging to the Console and a File is overkill.

Usage

  var winston = require('winston');
  
  //
  // Requiring `winston-mongodb` will expose 
  // `winston.transports.MongoDB`
  //
  require('winston-mongodb').MongoDB;
  
  winston.add(winston.transports.MongoDB, options);

The MongoDB transport takes the following options. 'db' is required:

• level: Level of messages that this transport should log.
• silent: Boolean flag indicating whether to suppress output.
• db: The name of the database you want to log to. [required]
• collection: The name of the collection you want to store log messages in, defaults to 'log'.
• safe: Boolean indicating if you want eventual consistency on your log messages, if set to true it requires an extra round trip to the server to ensure the write was committed, defaults to true.
• host: The host running MongoDB, defaults to localhost.
• port: The port on the host that MongoDB is running on, defaults to MongoDB's default port.
• formatter: Optional formatter function to override the structure of the entry inserted into MongoDB

Metadata: Logged as a native JSON object.

Author: Charlie Robbins

Contributors: Kendrick Taylor