@@ -16,23 +16,20 @@ gem install fiveruns-dash-sensor -s http://gems.github.com == Configuration -When you run 'fiveruns-dash-sensor start' for the first time, it will create a blank +When you run 'fiveruns-dash-sensor' for the first time, it will create a blank configuration for you in ~/.fiveruns-dash-sensor/config.rb. You will need to edit this file with your app token and activate the plugins for your environment. Once -done, you should be able to run 'fiveruns-dash-sensor run' for a few minutes to verify +done, you should be able to restart 'fiveruns-dash-sensor' for a few minutes to verify everything is working as designed. If there are no problems, you can run -'fiveruns-dash-sensor start' to spin off the daemon into the background and forget about it. +'fiveruns-dash-sensor -d' to spin off the daemon into the background and forget about it. == Command Summary - 'fiveruns-dash-sensor run' - start the daemon in the foreground, for debugging purposes. - 'fiveruns-dash-sensor start' - start the daemon in the background, output and PID file goes - in the ~/.fiveruns-dash-sensor/log/ directory. - 'fiveruns-dash-sensor stop' - stop the daemon in the background + fiveruns-dash-sensor --help -You can run Sensor in verbose mode to get more debug output: - - 'fiveruns-dash-sensor run -- -v' +Sensor allows you to control OS-specific parameters like log file and PID file location, +the user and group to run as, etc. -d will start Sensor as a daemon. To stop it, just +kill the associated PID. == Creating your own Plugins README.rdoc @@ -1,7 +1,11 @@ #!/usr/bin/env ruby -$LOAD_PATH.unshift File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')) -require 'runner' +begin + require 'runner' +rescue LoadError + $LOAD_PATH.unshift File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib')) + require 'runner' +end app_options = { :config_file => File.expand_path('~/.fiveruns-dash-sensor/config.rb') bin/fiveruns-dash-sensor @@ -1,6 +1,6 @@ Gem::Specification.new do |s| s.name = "dash-sensor" - s.version = "0.8.3" + s.version = "0.8.4" s.authors = "FiveRuns" s.email = "support@fiveruns.com" s.homepage = "http://github.com/fiveruns/dash-sensor/" @@ -12,7 +12,7 @@ Gem::Specification.new do |s| # get this easily and accurately by running 'Dir.glob("{bin,config,lib,plugins}/**/*")' # in an IRB session. However, GitHub won't allow that command hence # we spell it out. - s.files = ["bin/fiveruns-dash-sensor", "config.rb", "lib/daemon.rb", "lib/sensor.rb", "lib/sensor_plugin.rb", "plugins/memcached.rb", "plugins/starling.rb", "plugins/nginx.rb", "plugins/apache.rb"] + s.files = ["bin/fiveruns-dash-sensor", "config.rb", "lib/runner.rb", "lib/sensor.rb", "lib/sensor_plugin.rb", "plugins/memcached.rb", "plugins/starling.rb", "plugins/nginx.rb", "plugins/apache.rb"] s.test_files = [] s.extra_rdoc_files = ["README.rdoc"] s.executables = ["fiveruns-dash-sensor"] dash-sensor.gemspec 8d69b90f683305a4efd973d7dd0c69b2bf045df5 Mike Perham mperham@gmail.com http://github.com/fiveruns/dash-sensor/commit/d0ebba1cecb3fef23c7a422d978b191711bdeb2a d0ebba1cecb3fef23c7a422d978b191711bdeb2a 2009-02-10T11:02:32-08:00 2009-02-10T11:02:32-08:00 Update docs, bump version 685f3f8c1082900a82f48e5fe8da9cf4d8a5be7d Mike Perham mperham@gmail.com