Home

Cloudwatchd is a daemon which takes a directory of scripts in various programming languages, runs them at a designated interval, and sends their stdout along with parsed metadata to Amazon's Cloudwatch.

The default configuration file is assumed to be /etc/cloudwatchd/cloudwatchd.conf, but can be any location passed to this daemon as the first argument. The configuration file must have:

 AWS_CREDENTIAL_FILE=FILE
 CLOUDWATCH_METRICS_DIR=DIRECTORY

The Cloudwatchd daemon will run each script in CLOUDWATCH_METRICS_DIR according to its file extension, use the file's name as the metric name, parse "METRIC_UNIT=" from the file as the unit, parse "NAMESPACE=" from the file as the namespace, and post the stdout of the script to Amazon's Cloudwatch using the API credentials provided in AWS_CREDENTIAL_FILE.

Version 1.0 currently parses up to two keywords from the metric script itself before posting data to Cloudwatch, they are:

 METRIC_UNIT=[STRING]         defaults to "None". honored values are maintained by the python-boto library
 NAMESPACE=[STRING]           defaults to "Default",