winston-skywriter

A Windows Azure table storage transport for winston

npm install winston-skywriter
4 downloads in the last week
10 downloads in the last month

winston-skywriter

A Windows Azure table storage transport for winston, utilizing the bluesky API for Windows Azure.

Installation

  $ npm install winston
  $ npm install winston-skywriter

Usage

  var winston = require('winston');

  //
  // Requiring `winston-skywriter` will expose 
  // `winston.transports.Skywriter`
  //
  require('winston-skywriter').Skywriter;

  winston.add(winston.transports.Skywriter, options);

The Skywriter transport accepts the following options:

  • level: Level of messages that this transport should log (defaults to info).
  • account: The name of the Windows Azure storage account to use
  • key: The access key used to authenticate into this storage account
  • partition: The value to use for the PartitionKey in each row (defaults to 'log'). The RowKey is an auto-generated GUID.
  • columns: If true, the transport will store the metadata key/value pairs in individual columns (this can be helpful when querying table storage for log entries with specific metadata values). The default is to store the entire meta value as a single JSON string in a 'meta' column.

Helpful hint

When running multiple node instances across multiple hosts, a good value for 'partition' is:

partition: require('os').hostname() + ':' + process.pid
npm loves you