passenger_mon 0.1.0 → 0.2.0

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Alex Sharp
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,42 @@
+## tl;dr ##
+
+Simple rails process monitoring for passenger 3.
+
+## Usage ##
+
+**IMPORTANT:** passenger_mon needs to be run as root to properly get access to Passenger's
+`passenger-memory-stats` output.
+
+    # Check for out of control processes every 10 seconds
+    sudo passenger_mon --interval=10
+
+    # Check every 30 seconds for processes exceeding 500mb of memory
+    sudo passenger_mon --interval=30 --memory=500
+
+    # Specify a pidfile
+    sudo passenger_mon --pid=tmp/passenger_mon.pid
+
+    # Specify a logfile
+    sudo passenger_mon --log=log/passenger_mon.log
+
+## Description ##
+
+A primary aim of this script is to have a very tiny memory footprint itself.
+It is a very lightweight script that is intended to be run by root as a daemon.
+
+It works by running in a continuous loop, sleeping for the specified interval,
+and parsing the output of `passenger-memory-stats` to find processes that have
+crossed the specified memory threshold (the default is 400 MB).
+
+## Problem ##
+
+Currently, Passenger 3 (and previous versions) don't generate pidfiles or the
+application processes it spawns. This makes it very difficult to monitor these
+processes with tools like monit and [god](http://github.com/mojombo/god). Further
+compounding this problem is the lack of any sort of per process memory threshold
+for passenger.
+
+## Contributors
+
+* Rick Bradley
+* Alex Sharp

data/bin/passenger_mon

@@ -8,46 +8,54 @@ options = {}
 op = OptionParser.new do |opts|
   opts.banner = 'Usage: passenger_mon [options]'
 
-  opts.on("-i=SECONDS", "--interval=SECONDS", "Poll interval in seconds (default: 10)") do |interval|
+  opts.on("-i=SECONDS", "--interval=SECONDS", "Poll interval in seconds (default: 30)") do |interval|
     options[:interval] = interval
   end
 
-  opts.on("-m=MEMORY", "--memory=MB", "Memory threshold in MB (default: 800)") do |mb|
+  opts.on("-m=MEMORY", "--memory=MB", "Memory threshold in MB (default: 400)") do |mb|
     options[:threshold] = mb
   end
 
+  opts.on("-l=LOG_FILE", "--log=LOG_FILE", "Log file location (default: /var/log/passenger_mon.log)") do |log|
+    options[:log] = log
+  end
+
+  opts.on("-p=PIDFILE", "--pid=PID_FILE", "Pidfile to write") do |pidfile|
+    options[:pidfile] = pidfile
+  end
+
   opts.on_tail("-h", "--help", "show this message") do
     abort(opts.to_s)
   end
 end.parse!
 
 # set option defaults
-options[:interval]  ||= 10
-options[:threshold] ||= 800
+options[:interval]  ||= 30
+options[:threshold] ||= 400
+options[:log]       ||= "/var/log/passenger_mong.log"
+options[:pidfile]   ||= "/tmp/passenger_mon.pid"
 options[:threshold] = options[:threshold].to_i
 
-process_name = 'passenger_mon'
-pidfile = "/tmp/#{process_name}.pid"
 
 # If a pidfile exists when we start up, we need to remove it.
 # This probably means a non-clean shutdown the last time
 # the program was shutdown.
-if File.exist?(pidfile)
+if File.exist?(options[:pidfile])
   $stdout.puts "Existing pidfile found. Removing..."
-  FileUtils.rm(pidfile)
+  FileUtils.rm(options[:pidfile])
 end
 
 # remove the pidfile on shutdown
 at_exit do
   $stdout.puts "Removing pidfile."
-  FileUtils.rm(pidfile)
+  FileUtils.rm(options[:pidfile])
 end
 
 # write out the pidfile
-File.open(pidfile, 'w') { |f| f.puts($$) }
+File.open(options[:pidfile], 'w') { |f| f.puts($$) }
 
 require 'logger'
-logger = Logger.new("/var/log/passenger_mon.log")
+logger = Logger.new(options[:log])
 
 Signal.trap('INT') do
   logger.info "Shutting down now..."

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: passenger_mon
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 23
   prerelease: false
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Alex Sharp
@@ -28,9 +28,11 @@ executables:
 extensions: []
 
 extra_rdoc_files: 
-- README
+- README.md
+- MIT-LICENSE
 files: 
-- README
+- README.md
+- MIT-LICENSE
 - bin/passenger_mon
 has_rdoc: true
 homepage: https://github.com/ajsharp/passenger_mon

data/README

@@ -1,26 +0,0 @@
-## tl;dr ##
-
-Simple rails process monitoring for passenger 3.
-
-## Usage ##
-
-passenger_mon needs to be run as root to properly get access to Passenger's
-`passenger-memory-stats` output.
-
-    # Check for out of control processes every 10 seconds
-    sudo passenger_mon --interval=10
-
-
-## Problem
-
-Currently, Passenger 3 (and previous versions) don't generate pidfiles or the
-application processes it spawns. This makes it very difficult to monitor these
-processes with tools like monit and [god](http://github.com/mojombo/god). Further
-compounding this problem is the lack of any sort of per process memory threshold
-for passenger.
-
-
-## Contributors
-
-* Rick Bradley
-* Alex Sharp