Skip to content

Heymon: A Web Interface for Collectd

Introduction

Heymon is one of the most advanced interfaces currently available for Collectd. In my opinion, it's complementary to other interfaces since it allows comparisons between different machines. However, it's quite complicated to set up.

Installation

Let's install everything we need via Debian packages:

1
aptitude install unzip librrd-ruby rubygems1.9 libyaml-ruby libzlib-ruby libdbd-sqlite3-ruby mongrel libopenssl-ruby1.8

Then we download the project source code:

1
2
3
4
5
cd /var/www
wget "http://github.com/newobj/heymon/zipball/master"
unzip newobj-heymon-25ceb0e.zip
mv newobj-heymon-25ceb0e heymon
cd heymon

Next, we'll need to install gem if you don't have it already (or update it if it's already the case):

1
2
3
4
wget "http://rubyforge.org/frs/download.php/70697/rubygems-1.3.7.zip"
unzip rubygems-1.3.7.zip
cd rubygems-1.3.7
ruby1.9 ./setup.rb

And install some Ruby modules:

1
2
3
4
gem install rake
gem install right_aws
gem install haml
gem install -v=2.3.5 rails

Configuration

Now we'll configure what's needed to run Heymon. Let's generate what's necessary for the SQLite database:

1
2
cd ..
rake db:migrate

Edit the configuration file and adapt it if needed (/var/www/heymon/config/environment.rb):

1
2
3
4
5
...
RAILS_GEM_VERSION = '2.3.5' unless defined? RAILS_GEM_VERSION
COLLECTD_RRD = '/var/lib/collectd/rrd/'
RRDTOOL_BIN = '/usr/bin/rrdtool'
...

Launching

Now all that's left is to launch the application:

1
/var/www/heymon/script/server -d

Now try to access the following URL: http://192.168.0.48:3000.