recmon 1.0.2 → 1.0.3

data/CHANGELOG

@@ -1,5 +1,8 @@
+== Version 1.0.3
+- Added DiskfreeSensor
+
 == Version 1.0.2
-- Fixed du syntax 
+- Fixed du syntax
 
 == Version 1.0.1
 - Added filesize monitor.

data/README

@@ -41,6 +41,7 @@ and it will periodically write entries to the log file (default = +/var/log/recm
 There are several sensors:
 
 - *web*: ensure a website is responding
+- *diskfree*: track disk free space
 - *diskspace*: track the diskspace used by a folder
 - *filesize*: monitor the size of a file
 - *ping*: check if a server is alive
@@ -70,6 +71,13 @@ To periodically check if a website is reachable, add a WebSensor, specifying the
   s.web("Google", "http://www.google.com/jsapi", 120)
     # log entry => "2012-09-13T16:09:02+10:00 site=Google status=up"
 
+=== diskfree: track disk free space
+A DiskfreeSensor tracks how much disk space is available on a mounted disk partition:
+
+  s.diskfree(name, freq=1200)
+  s.diskfree("/var")
+    # log entry => "2012-09-13T16:09:02+10:00 mountpoint=/var usage=45%"
+
 === diskspace: track the diskspace used by a folder
 A DiskspaceSensor tracks how much disk space is being consumed by a set of files (log files or database files) in a folder:
 

data/lib/recmon.rb

@@ -1,6 +1,7 @@
 require 'recmon/monitor'
 require 'recmon/sensor'
 require 'recmon/command-sensor'
+require 'recmon/diskfree-sensor'
 require 'recmon/diskspace-sensor'
 require 'recmon/filesize-sensor'
 require 'recmon/ping-sensor'
@@ -12,6 +13,7 @@ require 'recmon/web-sensor'
 # - Recmon::Monitor
 # - Recmon::Sensor
 # - Recmon::CommandSensor
+# - Recmon::DiskfreeSensor
 # - Recmon::DiskspaceSensor
 # - Recmon::FilesizeSensor
 # - Recmon::PingSensor

data/lib/recmon/diskfree-sensor.rb

@@ -0,0 +1,30 @@
+require 'recmon/sensor'
+
+module Recmon
+
+# Periodically check the diskspace usage for a folder
+class DiskfreeSensor < Sensor
+
+  # create a DiskfreeSensor to check the usage of a disk partition.
+  # * +name+ is a name of the mounted partition (eg. "/var")
+  def initialize(name, freq=1200)
+    super(name.strip(), freq)
+    raise "Partition not found: #{@name}" unless File.directory?(@name)
+  end
+
+  # Called by Monitor. Executes df(1) to determine the disk %usage.
+  def sense()
+    begin
+      lines = `sudo /bin/df #{@name}`.split("\n")
+      line = lines[1]
+      usage = "unknown"
+      if line
+        parts = line.split(/\s+/)
+        usage = parts[4]
+      end
+    end
+    return("mountpoint=#{@name} usage=#{usage}%")
+  end
+
+end
+end

data/lib/recmon/monitor.rb

@@ -71,6 +71,11 @@ class Monitor
     @sensors << Recmon::CommandSensor.new(name, command, freq)
   end
 
+  # Adds a DiskfreeSensor
+  def diskspace(name, freq=1200)
+    @sensors << Recmon::DiskfreeSensor.new(name, freq)
+  end
+
   # Adds a DiskspaceSensor
   def diskspace(name, path, freq=1200)
     @sensors << Recmon::DiskspaceSensor.new(name, path, freq)

data/lib/recmon/ping-sensor.rb

@@ -6,7 +6,8 @@ module Recmon
 # Periodically pings a host to check it is alive
 class PingSensor < Sensor
 
-  # Create a new PingSensor to ping the given IP every 2 minutes
+  # Create a new PingSensor to ping the given IP every 2 minutes.
+  # +ip+ can be a hostname if it can be sucessfully resolved.
   def initialize(name, ip, freq=120)
     super(name, freq)
     @ip = IPAddr.new(ip)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: recmon
 version: !ruby/object:Gem::Version 
-  hash: 19
+  hash: 17
   prerelease: 
   segments: 
   - 1
   - 0
-  - 2
-  version: 1.0.2
+  - 3
+  version: 1.0.3
 platform: ruby
 authors: 
 - Richard Kernahan
@@ -31,6 +31,7 @@ files:
 - lib/recmon/monitor.rb
 - lib/recmon/sensor.rb
 - lib/recmon/command-sensor.rb
+- lib/recmon/diskfree-sensor.rb
 - lib/recmon/diskspace-sensor.rb
 - lib/recmon/filesize-sensor.rb
 - lib/recmon/ping-sensor.rb