README.md in daemonizer-0.4.13 vs README.md in daemonizer-0.4.14

@@ -1,42 +1,45 @@
 Daemonizer: Simple framework for creating daemons with Ruby
 ====================================
 
-**Homepage**:     [http://daemonizer.org](http://daemonizer.org)   
-**Git**:          [http://github.com/glebpom/daemonizer](http://github.com/glebpom/daemonizer)   
-**Author**:       Gleb Pomykalov    
-**Copyright**:    2010    
-**License**:      MIT License    
-**Status**:       alpha    
+**Homepage**:     [http://daemonizer.org](http://daemonizer.org)
+**Git**:          [http://github.com/glebpom/daemonizer](http://github.com/glebpom/daemonizer)
+**Author**:       Gleb Pomykalov
+**Copyright**:    2010
+**License**:      MIT License
+**Status**:       alpha
 
 Synopsis
 --------
 
-Daemonizer is a simple ruby framework to create custom daemons. It is fully 
+Daemonizer is a simple ruby framework to create custom daemons. It is fully
 compatible with EventMachine, Rails and any other Ruby frameworks.
 
 
 Feature List
 ------------
-                                                                              
-**1. Daemonfile (similar to Gemfile, Rakefile)** as a configuration file. It is 
-possible to describe different background pools there.
-                                                                              
-**2. Monitoring**: If child is found dead it will be immediately 
+
+**1. Daemonfile (similar to Gemfile, Rakefile)** as a configuration file. It is
+possible to describe different worker pools there.
+
+**2. Monitoring**: If child is found dead it will be immediately
 restored
-                                                                              
+
 **3. Logging**
 
+**4. Statistics**: Daemonizer collects worker statistics and let you kill workers if
+some statistics exceeds regular values.
+
 Installing
 ----------
 
 To install Daemonizer, use the following command:
 
     $ gem install daemonizer
-    
-(Add `sudo` if you're installing under a POSIX system as root)                                                                              
 
+(Add `sudo` if you're installing under a POSIX system as root)
+
 Usage
 -----
 
 **Demfile example:**
 
@@ -44,111 +47,118 @@
     poll_period 5
 
     pool :daemonizer do
       workers 4
       log_file "log/daemonizer.log" #relative to Demfile
-  
+
       prepare do |block|
         block.call
       end
-  
+
       start do |worker_id, workers_count|
         logger.info "Started #{worker_id} from #{workers_count}"
-    
+
         exit = false
-    
+
         stop = proc {
           exit = true
         }
 
         trap('TERM', stop)
         trap('INT', stop)
         trap('EXIT', stop)
-    
+
         loop do
           break if exit
           logger.info "Ping #{worker_id}"
           sleep 10
         end
-    
+
         true
       end
     end
 
-    settings_group do 
+    settings_group do
       before_start do |worker_id, workers_count|
         #reconnect to db, etc.
       end
 
       #simple string option
       set_option :author, "Gleb Pomykalov"
 
       pool :new_daemonizer do
+        on_poll do |pool|
+          pool.stats.where(:private_dirty_rss).last_probes_by_count(8).mean.is_higher_then(150_000) do |stat|
+            Daemonizer.logger.info "Memory limit exceeded for #{stat}. Gracefully stopping"
+            worker = pool.find_worker_by_name(stat)
+            worker.stop if worker
+          end
+        end
         workers 4
         log_file "log/daemonizer.log" #relative to Demfile
 
         handler MyBackgroundSolution::DaemonizerHandler
-      
+
         not_cow_friendly #disable Copy-On-Write friendly (enabled by default)
 
         #automatically-parsed option by daemonizer
-        set_option :queue do |worker_id, worker_count|  
+        set_option :queue do |worker_id, worker_count|
           "queue_#{worker_id}"
         end
-            
+
         #lambda-option (transparent for daemonizer, fully processed by handler)
         set_option :on_error, lambda { |object| object.logger.fatal "epic fail"}
       end
 
 
       pool :new_daemonizer2 do
         workers 4
         log_file "log/daemonizer2.log" #relative to Demfile
 
         handler MyBackgroundSolution::DaemonizerHandler
-              
+
         not_cow_friendly #disable Copy-On-Write friendly (enabled by default)
 
         #automatically-parsed option by daemonizer
-        set_option :queue do |worker_id, worker_count|  
+        set_option :queue do |worker_id, worker_count|
           "another_queue_#{worker_id}"
         end
-        
+
         after_prepare do |logger|
           require 'something'
         end
-        
+
         #lambda-option (transparent for daemonizer, fully processed by handler)
         set_option :on_error, lambda { |object| object.logger.fatal "epic fail"}
       end
     end
 
 **Handler example**
 
     module MyBackgroundSolution
       class DaemonizerHandler < Daemonizer::Handler
-        def prepare(block)
+        def preparee(starter, &block)
           require File.join(Daemonizer.root, '/config/environment') #Require rails
           require 'my_background_solution/worker' #Require our code
           super #now we are ready to fork
         end
 
-        def start 
+        def start
           #we are in worker process
           logger.info "Starting cycle. We are number #{worker_id} from #{workers_count}"
           logger.info "Options - #{option(:queue)}" #We can get option :queue, which is set with set_option in pool configuration
           worker = Worker.new
           worker.run
           logger.info "Ending cycle"
         end
       end
     end
-    
+
 Who are the authors
 -------------------
 
-This gem has been created in qik.com for our internal use and then 
-the sources were opened for other people to use. All the code in this package 
+This gem has been created in qik.com for our internal use and then
+the sources were opened for other people to use. All the code in this package
 has been developed by Gleb Pomykalov. As for the first versions, it was mostly based
  on [http://github.com/kovyrin/loops](loops) code written by Alexey Kovyrin. Now
 most of it is heavily refactored. MemoryStats is taken from Phusion Passenger.The gem
 is released under the MIT license. For more details, see the LICENSE file.