winston-mongodb

A MongoDB transport for winston

npm install winston-mongodb
133 downloads in the last day
2 387 downloads in the last week
8 772 downloads in the last month

winston

A MongoDB transport for winston.

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, defaults to 'info'.
  • silent: Boolean flag indicating whether to suppress output, defaults to false.

  • 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 'logs'.
  • 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.
  • nativeParser: Boolean indicating if you want the driver to use native parser feature or not.
  • 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.
  • username: The username to use when logging into MongoDB.
  • password: The password to use when logging into MongoDB. If you don't supply a username and password it will not use MongoDB authentication.
  • errorTimeout: Reconnect timeout upon connection error from Mongo, defaults to 10 seconds (10000).
  • timeout: Timeout for keeping idle connection to Mongo alive, defaults to 10 seconds (10000).
  • storeHost: Boolean indicating if you want to store machine hostname in logs entry, if set to true it populates MongoDB entry with 'hostname' field, which stores os.hostname() value.
  • ssl: Boolean indicating if you want to use SSL connections or not.
  • authDb: Authentication database object.

Metadata: Logged as a native JSON object.

Installation

Installing npm (node package manager)

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

Installing winston-mongodb

  $ npm install winston
  $ npm install winston-mongodb

Author: Charlie Robbins

Contributors: Kendrick Taylor, Yosef Dinerstein, Yurij Mikhalevich, Steve Dalby

npm loves you