README.md

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
• table: The name of the table to log to (defaults to 'log'). Must already exist.
• 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