pimon 0.1.0

data/.gitignore

@@ -0,0 +1,10 @@
+.idea
+.rspec
+bin/free
+bin/vmstat
+bin/*.o
+config/thin/development_config.yml
+coverage
+log
+pids
+sandbox.sh

data/.travis.yml

@@ -0,0 +1,6 @@
+rvm:
+  - 1.9.3
+script: "rake spec"
+notifications:
+    email:
+        - pedro.carrico@gmail.com

data/Capfile

@@ -0,0 +1,2 @@
+load 'deploy' if respond_to?(:namespace)
+load 'config/deploy'

data/Gemfile

@@ -0,0 +1,18 @@
+source :rubygems
+
+gem 'capistrano'
+gem 'haml'
+gem 'redis'
+gem 'sinatra', :require => 'sinatra/base'
+gem 'thin'
+
+gem 'pry', :group => [:development, :test]
+
+group :test do
+  gem 'mock_redis', '~> 0.5.0'
+  gem 'rack-test'
+  gem 'rspec', '~> 2.11.0'
+  gem 'simplecov', :require => false
+  gem 'simplecov-rcov'
+  gem 'timecop'
+end

data/Gemfile.lock

@@ -0,0 +1,77 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    capistrano (2.13.3)
+      highline
+      net-scp (>= 1.0.0)
+      net-sftp (>= 2.0.0)
+      net-ssh (>= 2.0.14)
+      net-ssh-gateway (>= 1.1.0)
+    coderay (1.0.7)
+    daemons (1.1.9)
+    diff-lcs (1.1.3)
+    eventmachine (0.12.10)
+    haml (3.1.7)
+    highline (1.6.13)
+    method_source (0.8)
+    mock_redis (0.5.0)
+    multi_json (1.0.4)
+    net-scp (1.0.4)
+      net-ssh (>= 1.99.1)
+    net-sftp (2.0.5)
+      net-ssh (>= 2.0.9)
+    net-ssh (2.5.2)
+    net-ssh-gateway (1.1.0)
+      net-ssh (>= 1.99.1)
+    pry (0.9.10)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.3.1)
+    rack (1.4.1)
+    rack-protection (1.2.0)
+      rack
+    rack-test (0.6.1)
+      rack (>= 1.0)
+    redis (3.0.1)
+    rspec (2.11.0)
+      rspec-core (~> 2.11.0)
+      rspec-expectations (~> 2.11.0)
+      rspec-mocks (~> 2.11.0)
+    rspec-core (2.11.1)
+    rspec-expectations (2.11.2)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.11.2)
+    simplecov (0.6.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    simplecov-rcov (0.2.3)
+      simplecov (>= 0.4.1)
+    sinatra (1.3.2)
+      rack (~> 1.3, >= 1.3.6)
+      rack-protection (~> 1.2)
+      tilt (~> 1.3, >= 1.3.3)
+    slop (3.3.2)
+    thin (1.4.1)
+      daemons (>= 1.0.9)
+      eventmachine (>= 0.12.6)
+      rack (>= 1.0.0)
+    tilt (1.3.3)
+    timecop (0.3.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  capistrano
+  haml
+  mock_redis (~> 0.5.0)
+  pry
+  rack-test
+  redis
+  rspec (~> 2.11.0)
+  simplecov
+  simplecov-rcov
+  sinatra
+  thin
+  timecop

data/README.md

@@ -0,0 +1,77 @@
+# Pimon
+
+[![Build Status](https://secure.travis-ci.org/pedrocarrico/pimon.png)](http://travis-ci.org/pedrocarrico/pimon) [![Dependency Status](https://gemnasium.com/pedrocarrico/pimon.png?travis)](https://gemnasium.com/pedrocarrico/pimon) [![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/pedrocarrico/pimon)
+
+![Pimon](http://pedrocarrico.net/pimon.jpg "Pimon")
+
+## Description
+Pimon is a simple server monitor designed for the Raspberry Pi.
+It uses redis lists to keep the latest observed statistics and also uses
+highcharts to display some nice charts on your web browser.
+
+## What do I need to get it to work?
+1. Install redis an configure it to run on a socket on /tmp/redis.sock
+2. bundle
+3. bin/pimon start # run the sinatra app
+4. go to http://localhost:3000 and PROFIT!
+Optionally you may install it as a gem and run it, please check "Installing as a gem" further down.
+
+## Configuration
+1. basic_auth - enable or disable, configure username and password
+2. redis - location of the redis socket
+3. chart - colors for each chart
+4. queues - redis list names for the series in the charts
+5. stats - configure number of stats and time period between them
+
+## Deployment
+To deploy on your raspberry pi you just have to have ssh enabled and your keys authorized.  
+Then you can deploy with capistrano using:  
+```
+cap deploy:setup
+cap deploy:cold
+```
+
+This will setup your raspberry pi and deploy the application.  
+The username and password for the basic_auth in the production environment will be asked in the
+first deploy.
+To start and stop the application you have the usual:  
+```
+cap deploy:start
+cap deploy:stop
+```
+
+## Running tests
+To run the coverage suite:
+```
+rake coverage:spec
+```
+Results will be in coverage/index.html directory.
+
+## Installing as a gem
+```
+gem install pimon
+```
+After installation just do _pimon start_ and go to http://localhost:3000 and check your stats 
+(This will only work on your Raspberry Pi and perhaps some other linux distros, check the quirks section for more info).
+
+## Quirks
+Pimon uses _vmstat_ and _free_ to collect it's stats from the operating system and these are only
+available on operating systems that have the /proc filesystem.  
+So if you want to develop on a Mac you may use the mock implementations that are in the bin directory.  
+The mock implementations are programmed in C and mimic the output of _vmstat_ and _free_.  
+They just change and generate some random values on the observed stats using /dev/urandom.  
+To use them you must first compile them using _make_ and then include the bin directory of this project
+in your $PATH to have them available when you run the sinatra application.
+The temperature stat is only available with the latest Raspbian distro (2012-09-18) on your Raspberry Pi and will (may)
+not work if you're developing on other systems.
+
+## TODO
+1. Improve disk stats, have a way of having custom mount points
+2. Capistrano task to reset production basic_auth username and password
+3. Show uptime
+4. Change configuration in realtime
+5. Daemonize if running in production through bin/pimon (usefull for production environments without deploying through
+capistrano)
+
+## Copyright
+Licensed under the [WTFPL](http://en.wikipedia.org/wiki/WTFPL "Do What The Fuck You Want To Public License") license.

data/Rakefile

@@ -0,0 +1,13 @@
+require 'rspec/core/rake_task'
+
+desc 'run specs'
+RSpec::Core::RakeTask.new
+
+namespace :coverage do
+  desc 'run rspec code coverage'
+  task :spec do
+    ENV['COVERAGE'] = 'on'
+    FileUtils.rm_r 'coverage', :force => true
+    Rake::Task[:spec].execute
+  end
+end

data/WTFPL-LICENSE

@@ -0,0 +1,13 @@
+           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                   Version 2, December 2004
+
+Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+
+Everyone is permitted to copy and distribute verbatim or modified
+copies of this license document, and changing it is allowed as long
+as the name is changed.
+
+           DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+  TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. You just DO WHAT THE FUCK YOU WANT TO.

data/bin/clean_redis_stats

@@ -0,0 +1 @@
+/Users/pecarrico/opt/redis/src/redis-cli -s /tmp/redis.sock del pimon_mem del pimon_swap del pimon_cpu del pimon_time del pimon_disk pimon_temp

data/bin/free.c

@@ -0,0 +1,12 @@
+#include <stdio.h>
+#include <stdlib.h>
+
+int main (int argc, char *argv[])
+{
+    int mem_used = generate_random();
+    int swap_used = generate_random();
+    
+    printf("             total       used       free     shared    buffers     cached\nMem:           215        %d         %d          0          4        110\nSwap:          100        %d         %d\n", mem_used, 215 - mem_used, swap_used, 100 - swap_used);
+    
+    exit (0);
+}

data/bin/makefile

@@ -0,0 +1,2 @@
+all:
+	gcc -c random.c vmstat.c free.c; gcc -o vmstat vmstat.o random.o ;gcc -o free free.o random.o

data/bin/pimon

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+action = ARGV[0]
+environment = ARGV[1]
+
+case action
+when "start"
+  require 'rack'
+  
+  puts 'Pimon is starting at http://localhost:3000'
+  config = "#{File.dirname(__FILE__)}/../config/config.ru"
+  
+  ARGV[1] ? ENV['RACK_ENV'] = environment : ENV['RACK_ENV'] = 'development'
+  
+  puts "Running in #{ENV['RACK_ENV']} mode."
+  server = Rack::Server.new(:config => config, :Port => 3000, :server => 'thin')
+  server.start
+else
+  puts "Usage: pimon start <environment>"
+end

data/bin/random.c

@@ -0,0 +1,21 @@
+#include <stdio.h>
+#include <unistd.h>
+#include <stdlib.h>
+#include <math.h>
+
+int generate_random()
+{
+    FILE *urandom;
+    unsigned int seed;
+    int cpu_idle;
+    
+    urandom = fopen ("/dev/urandom", "r");
+    if (urandom == NULL) {
+        fprintf (stderr, "ERROR: Cannot open /dev/urandom!\n");
+        exit (1);
+    }
+    fread (&seed, sizeof (seed), 1, urandom);
+    srand (seed);
+    
+    return ((int) floor (rand() * 100.0 / ((double) RAND_MAX + 1) ) + 1);
+}

data/bin/random.h

@@ -0,0 +1 @@
+extern int generate_random();

data/bin/vmstat.c

@@ -0,0 +1,12 @@
+#include <stdio.h>
+#include <stdlib.h>
+#include "random.h"
+
+int main (int argc, char *argv[])
+{
+    int cpu_idle = generate_random();
+    
+    printf("procs -----------memory---------- ---swap-- -----io---- -system-- ----cpu----\n r  b   swpd   free   buff  cache   si   so    bi    bo   in   cs us sy id wa\n 1  0  10976  50992   4900 113188    1    2   109   244  101  183 11 10 77  1\n 0  0  10976  50992   4900 113188    0    0     0     0 8366  315 10  5 %d  0\n", cpu_idle);
+    
+    exit (0);
+}

data/config/config.ru

@@ -0,0 +1,4 @@
+require 'sinatra'
+require "#{File.dirname(__FILE__)}/../lib/pimon"
+
+run Pimon

data/config/config_dev.ru

@@ -0,0 +1,11 @@
+require 'sinatra'
+require './pimon'
+
+root_dir = File.dirname(__FILE__) + "/.."
+
+set :environment, :development
+set :root,  root_dir
+set :app_file, File.join(root_dir, 'pimon.rb')
+disable :run
+
+run Pimon

data/config/deploy.rb

@@ -0,0 +1,65 @@
+set :application, "pimon"
+set :user, "pi"
+
+set :scm, :git
+
+set :repository, "git://github.com/pedrocarrico/pimon.git"
+
+set :deploy_to, '/home/pi/app/pimon'
+set :deploy_via, :remote_cache # quicker checkouts from github
+
+set :domain, 'raspberrypi'
+role :app, domain
+role :web, domain
+
+set :runner, user
+set :use_sudo, false
+
+after 'deploy:update_code', 'deploy:bundle_install'
+
+namespace :deploy do
+  task :start, :roles => [:web, :app] do
+    run "cd #{deploy_to}/current && nohup thin -C config/thin/config.yml -R config/config.ru start"
+  end
+  
+  task :stop, :roles => [:web, :app] do
+    run "cd #{deploy_to}/current && nohup thin -C config/thin/config.yml -R config/config.ru stop"
+  end
+  
+  task :restart, :roles => [:web, :app] do
+    deploy.stop
+    deploy.check_basic_auth
+    deploy.start
+  end
+  
+  task :cold do
+    deploy.update
+    deploy.check_basic_auth
+    deploy.start
+  end
+  
+  desc "After deploying check if there's need for a new username/password for the basic_auth"
+  task :check_basic_auth, :roles => :app do
+    require "yaml"
+    set :username, proc { Capistrano::CLI.ui.ask("username : ") }
+    set :password, proc { Capistrano::CLI.password_prompt("password : ") }
+    set :shared_config, "#{deploy_to}/shared/production.yml"
+    
+    if 'true' ==  capture("if [ -e #{shared_config} ]; then echo 'true'; fi").strip
+      run "cp #{shared_config} #{deploy_to}/current/config/production.yml"
+    else
+      production_config = YAML::load_file('config/production.yml')
+      production_config['basic_auth']['username'] = username
+      production_config['basic_auth']['password'] = password
+      
+      put YAML::dump(production_config), shared_config, :mode => 0664
+      run "cp #{shared_config} #{deploy_to}/current/config/production.yml"
+      puts "DONE"
+    end
+  end
+  
+  desc "run 'bundle install' to install Bundler's packaged gems for the current deploy"
+  task :bundle_install, :roles => :app do
+    run "cd #{deploy_to}/current && bundle install --without test development"
+  end
+end

data/config/development.yml

@@ -0,0 +1,25 @@
+basic_auth:
+  enabled: false
+redis:
+  socket: /tmp/redis.sock
+chart:
+  cpu:
+    color: '#D2691E'
+  disk:
+    color: '#CDC673'
+  mem:
+    color: '#87CEFA'
+  temp:
+    color: '#FF9B04'
+  swap:
+    color: '#3CB371'
+queues:
+  time: pimon_time
+  cpu:  pimon_cpu
+  disk: pimon_disk
+  mem:  pimon_mem
+  swap: pimon_swap
+  temp: pimon_temp
+stats_collector:
+  number_of_stats: 6
+  time_period_in_min: 1

data/config/production.yml

@@ -0,0 +1,27 @@
+basic_auth:
+  enabled: true
+  username: changed_on_deploy
+  password: changed_on_deploy
+redis:
+  socket: /tmp/redis.sock
+chart:
+  cpu:
+    color: '#D2691E'
+  disk:
+    color: '#CDC673'
+  mem:
+    color: '#87CEFA'
+  temp:
+    color: '#FF9B04'
+  swap:
+    color: '#3CB371'
+queues:
+  time: pimon_time
+  cpu:  pimon_cpu
+  disk: pimon_disk
+  mem:  pimon_mem
+  swap: pimon_swap
+  temp: pimon_temp
+stats_collector:
+  number_of_stats: 12
+  time_period_in_min: 5