awslogger

awslogger

A CLI tool to send lines from stdin as messages to AWS CloudWatch Logs.

Will create the log group and log stream if necessary (and if the correct permissions are available). Loads credentials in the same way the AWS SDKs do (env, config file, IAM role).

Also check out cloudwatchlogs-stream in case that's more suitable for your needs – it wasn't for mine because I needed other features like line splitting, credential loading, timestamping etc.

Example

$ awslogger --help
 
Usage: awslogger [-t] group-name stream-name < lines.log
 
Sends lines from stdin to AWS CloudWatch Logs
 
Options:
--help     Display this help message and exit
-t         Prepend a ISO8601 timestamp to each message/line

Or programmatically (as a writable stream):

var awslogger = require('awslogger'),
    CloudWatchLogsStream = awslogger.CloudWatchLogsStream
 
var logStream = awslogger({logGroupName: 'a', logStreamName: 'b', addTimestamp: true})
 
// or
 
var logStream = new CloudWatchLogsStream({logGroupName: 'a', logStreamName: 'b', addTimestamp: true})
 
process.stdin.setEncoding('utf8')
process.stdin.pipe(logStream)

Installation

With npm do:

$ npm install -g awslogger