Eye
===

Process monitoring tool. With Bluepill like config syntax. Requires MRI Ruby >= 1.9.2. Uses Celluloid and Celluloid::IO.


Recommended installation on the server (system wide):

    $ sudo /usr/local/ruby/1.9.3/bin/gem install eye
    $ sudo ln -sf /usr/local/ruby/1.9.3/bin/eye /usr/local/bin/eye


Config example, shows most of the options (examples/test.eye):

```ruby
Eye.load("./eye/*.rb") # load submodules
Eye.config do
  logger "/tmp/eye.log" # eye logger
end

Eye.app "test" do
  working_dir File.expand_path(File.join(File.dirname(__FILE__), %w[ processes ]))
  stdall "trash.log" # stdout + stderr
  env "APP_ENV" => "production"
  triggers :flapping, :times => 10, :within => 1.minute

  group "samples" do
    env "A" => "1" # env merging
    chain :grace => 5.seconds, :action => :restart # restarting with 5s interval, one by one.

    # eye daemonized process
    process("sample1") do
      pid_file "1.pid" # expanded with working_dir
      start_command "ruby ./sample.rb"
      daemonize true
      stdall "sample1.log"

      checks :cpu, :below => 30, :times => [3, 5]
    end

    # self daemonized process
    process("sample2") do
      pid_file "2.pid"
      start_command "ruby ./sample.rb -d --pid 2.pid --log sample2.log"
      stop_command "kill -9 {{PID}}"

      checks :memory, :below => 300.megabytes, :times => 3
    end
  end

  # daemon with 3 childs
  process("forking") do
    pid_file "forking.pid"
    start_command "ruby ./forking.rb start"
    stop_command "ruby forking.rb stop"
    stdall "forking.log"

    start_timeout 5.seconds
    stop_grace 5.seconds
  
    monitor_children do
      childs_update_period 5.seconds

      restart_command "kill -2 {{PID}}"
      checks :memory, :below => 300.megabytes, :times => 3
    end
  end

end
```

### Start monitoring and load config:

    $ eye l(oad) examples/test.eye

load folder with configs:

    $ eye l examples/
    $ eye l examples/*.rb

Load also uses for config synchronization and load new application into runned eye daemon. Light operation, so i recommend to use with every deploy (and than restart processes).
(for processes with option `stop_on_delete`, `load` becomes a tool for full config synchronization, which stopps deleted from config processes).


Process statuses:
  
    $ eye i(nfo)

```
test                               
  samples                          
    sample1 ....................... up  (21:38, 0%, 15Mb, <4813>)
    sample2 ....................... up  (21:36, 0%, 14Mb, <4530>)
  forking ......................... up  (21:34, 0%, 19Mb, <4272>)
    =child= ....................... up  (21:34, 0%, 22Mb, <4275>)
    =child= ....................... up  (21:34, 0%, 21Mb, <4278>)
    =child= ....................... up  (21:34, 0%, 21Mb, <4281>)
```

### Commands:
    
    start, stop, restart, delete, monitor, unmonitor

Command params (with restart for example):

    $ eye r(estart) all
    $ eye r test
    $ eye r samples
    $ eye r sample1
    $ eye r sample*
    $ eye r test:samples
    $ eye r test:samples:sample1
    $ eye r test:samples:sample*
    $ eye r test:*sample*

Check config syntax:

    $ eye c(heck) examples/test.eye

Log tracing:

    $ eye trace 
    $ eye tr test
    $ eye tr sample

Quit monitoring:

    $ eye q(uit)

Config explain (for debug):

    $ eye explain examples/test.eye