Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Nephelae runs as a daemon and sends custom stats such as disk space, memory usage to Cloud Watch on a regular basis
Branch: master


The Nephelae were the nymph of clouds ( carrying water from Earth to Heaven. In this particular case the nephelae carry data from servers to Amazon EC2 Cloud Watch. It was written to send disk space and memory usage of EC2 servers but can be extended to query any metrics and upload them on a regular basis.

For example the Redis plugin will collect the UsedMemory, ConnectedSlaves, ConnectedClients, ChangesSinceLastSave, MasterIOSecondsAgo, MasterLinkStatus and Up of a Redis instance and send this to AWS CloudWatch. We use this to put CloudWatch Alarms on the Up and MasterLinkStatus metrics to notify if Redis goes down or loses connection with the Master

The Nephelae gem contains a daemon process which has a number of plugins to collect stats. The daemon process is configured through a yaml file


To install as a gem

$ gem install nephelae


To run the nephelae deamon

$ nephelae start

This will start with default settings looking for a config yaml file in .etc/nephelae.yml. It will use /var/log as a log directory and /var/run for a pid directory

To start in the background (this uses the daemon gem

$ nephelae start --piddir /home/nephelae/ --loglevel debug

To start in the foreground

$ nephelae --foreground

Other command line options

--loglevel *level* (debug, info, warn, error, fatal) default: warn
--config *path*
--instance-name *override the instance-id*


The config yaml file is used to define the AWS access keys and plugin settings

An example configuration file

:aws_secret_access_key: your_secret_key
:aws_access_key_id: your_access_key
:region: ec2_region
    :plugin_class: DiskSpace
    :path: /
    :schedule: 1m
    :plugin_class: MemUsage
    :schedule: 1m


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
Something went wrong with that request. Please try again.