activerecord-zabbix 0.1.0

data/README.md

@@ -0,0 +1,39 @@
+activerecord-zabbix
+===================
+
+This is not a rails app.
+
+Although some attempt `may be` (later) made to facilitate this integrating seamlessly into one.
+
+Quick Start
+-----------
+
+`gem install activerecord-zabbix`  # once published... (to rubygems-org)
+
+<pre>
+	
+require 'activerecord-zabbix'
+	
+CONFIG = {
+	:adapter => 'postgresql', # or whatever
+    :host => 'your.zabbix.db.server',
+    :database => 'zabbix',
+    :username => 'username',
+    :password => 'passrod'
+}
+
+Zabbix::connect( CONFIG )
+
+Zabbix::Host.find_by_dns( 'monitored.server.com' ).items.each do |item|
+
+	#
+	# all monitored item(s) for the given host
+	#
+	puts item.inspect
+
+end
+
+</pre>
+
+
+[Schema Diagram](https://docs.google.com/drawings/d/12sIp0gAaoAlLOVluyiSLSFYhTiuw8txoUL67BDUVxvc/edit)

data/activerecord-zabbix.gemspec

@@ -0,0 +1,50 @@
+$LOAD_PATH.unshift 'lib'
+
+require 'date'
+require 'zabbix/version'
+
+Gem::Specification.new do |spec|
+  
+  spec.name = GEM_NAME
+  spec.version = MODULE_NAME::Version
+  spec.date = DateTime.now.strftime( "%Y-%m-%d" )
+  spec.authors = ["","","","Richard"]
+  spec.email = %q{ops@clue.co.za}
+  spec.summary = %q{ActiveRecord access into Zabbix}
+  spec.homepage = %q{https://github.com/cluetechnologies/activerecord-zabbix}
+  spec.description = %q{This is not a rails app.}
+ 
+  spec.add_runtime_dependency 'activerecord'
+  
+  spec.files = [
+    
+    #
+    # du -a lib/ spec/ README* *.gemspec | awk '{print($2)}' | while read file; do echo "'$file',"; done
+    # 
+    
+    'lib//activerecord-zabbix.rb',
+    'lib//boot.rb',
+    'lib//zabbix/connect.rb',
+    'lib//zabbix/function.rb',
+    'lib//zabbix/host.rb',
+    'lib//zabbix/item.rb',
+    'lib//zabbix/trigger.rb',
+    'lib//zabbix/version.rb',
+    'lib//zabbix/zabbix.rb',
+    'lib//zabbix',
+    'lib/',
+    'spec//README',
+    'spec//spec_helper.rb',
+    'spec//zabbix/connect_spec.rb',
+    'spec//zabbix/function_spec.rb',
+    'spec//zabbix/host_spec.rb',
+    'spec//zabbix/item_spec.rb',
+    'spec//zabbix/trigger_spec.rb',
+    'spec//zabbix',
+    'spec/',
+    'README.md',
+    'activerecord-zabbix.gemspec'  #,
+    
+  ]
+  
+end

data/lib/activerecord-zabbix.rb

@@ -0,0 +1,10 @@
+# do this somewhere else
+# 
+#$LOAD_PATH.unshift 'lib'
+## 
+## bundler autoload
+##
+#require 'boot'
+#
+require 'active_record'
+require 'zabbix/zabbix'

data/lib/boot.rb

@@ -0,0 +1 @@
+Zabbix::connect

data/lib/zabbix/connect.rb

@@ -0,0 +1,71 @@
+module Zabbix
+  
+  
+  ##
+  # 
+  # Expects `config` (unimplemented optional) as a `Hash` with 
+  # 
+  #  :adapter
+  #  :host
+  #  :database
+  #  :username
+  #  :password 
+  # 
+  # Expects `logger` (optional) to be a standard logger
+  #  
+  def self.connect( config = nil, logger = nil )
+    
+    @logger = logger
+    
+    if config.nil?
+      
+      config = load_standard_rails_things_for_db__and_feel_free_to_rename_this_function
+      
+    end
+    
+    begin
+      
+      ActiveRecord::Base.establish_connection(
+
+        :adapter => config[:adapter],
+        :host => config[:host],
+        :database => config[:database],
+        :username => config[:username],
+        :password => config[:password]
+
+      )
+    
+    rescue Exception => e
+      
+      #
+      # Intercept to log error
+      #
+      
+      @logger.error( 
+
+        "ERROR: in Zabbix::connect() #{e.to_s}"
+
+      ) unless @logger.nil?
+      
+      #
+      # Re-Raise  (STILL WANT TO BRING THE DAEMON DOWN)
+      #
+      
+      raise e
+      
+    end
+      
+  end
+  
+  
+  def self.load_standard_rails_things_for_db__and_feel_free_to_rename_this_function
+    
+    #  
+    #
+    #  
+    # 
+    #   
+    
+  end
+  
+end

data/lib/zabbix/function.rb

@@ -0,0 +1,13 @@
+module Zabbix
+  
+  class Function < ::ActiveRecord::Base
+    
+    set_table_name "functions"
+    set_primary_key "functionid"
+  
+    belongs_to :item,    :class_name => "Item", :foreign_key => "itemid"
+    belongs_to :trigger, :class_name => "Trigger", :foreign_key => "triggerid"
+    
+  end
+  
+end

data/lib/zabbix/host.rb

@@ -0,0 +1,52 @@
+module Zabbix
+
+  class Host < ::ActiveRecord::Base
+
+    set_table_name "hosts"
+    set_primary_key "hostid"
+  
+    default_scope where(:status => [0,1] )
+    scope :monitored, where(:status => 0)
+    scope :not_monitored, where(:status => 1)
+    
+    has_many :items, :class_name => "Item", :foreign_key => "hostid"
+  
+    #scope :item_data_ago, lambda {|dns, key, ago | where(:dns => dns)[0].item_by_key(key).history.ago(ago)}
+    
+    
+    #has_many :host_group, :class_name => "HostGroup", :foreign_key => "hostid"
+    #has_many :groups, :through => :host_group
+    #has_many :host_template, :class_name => "HostTemplate", :foreign_key => "hostid"
+    #has_many :templates, :through => :host_template
+  
+  
+    #belongs_to :proxy, :class_name => "Proxy", :foreign_key => "proxy_hostid"
+  
+    #def item_last_value(key, value, time_shift_tolerance = 480)
+    #  items.where("key_ = ? and lastvalue = ? and lastclock >=", key, value.to_s, Time.now.to_i - time_shift_tolerance)
+    #end
+    #
+    
+    
+    # activerecord3 does lazyload, so .items does not get all the items 
+    # and will get only the ONE record when:
+    # 
+    # Zabbix::Host.find_by_dns( fqdn ).items.where( :key_ => 'icmpping')
+    # 
+    # -stu
+    # 
+    #
+    # def item_by_key(key)
+    #  i = items.where("key_ = ?", key)
+    #  return nil if i.nil? or i.empty?
+    #  raise(TooManyRecords) if i.size > 1
+    #  i[0]
+    #end
+  
+    #def self.to_s
+    #  "#{self.name}, #{self.dns}"
+    #end
+  
+  end
+  
+end

data/lib/zabbix/item.rb

@@ -0,0 +1,40 @@
+module Zabbix
+  
+  class Item < ::ActiveRecord::Base
+    
+    set_table_name "items"
+    set_primary_key "itemid"
+    set_inheritance_column "dodge_rails_assumptions_about_type_column" # this is not an single inheritance table
+    
+    belongs_to :host,      :class_name => "Host", :foreign_key => "hostid"
+    has_many   :functions, :class_name => "Function", :foreign_key => "itemid"
+    
+    #has_many :groups, :through => :host, :source => :host_group
+    
+      
+    # select distinct ho.dns, i.itemid,i.value_type,h.value
+    #from items i,history_uint h, hosts ho
+    #where h.itemid = i.itemid
+    #and i.hostid = ho.hostid
+    #and h.clock > (extract(epoch FROM now())::int - 480)
+    #and i.value_type = 3
+    #and h.value = 1
+    #and i.itemid in (
+    #
+    #  select itemid from items
+    #  join hosts on (items.hostid = hosts.hostid)
+    #  join hosts_groups on (hosts_groups.hostid = hosts.hostid)
+    #  join groups on (groups.groupid = hosts_groups.groupid)
+    #  where items.key_='icmpping'
+    #    and items.status=0
+    #    and hosts.status=0
+    #    and groups.name in ('School Firewalls')
+    #)
+    
+      #def self.by_group_and_key_with_conditions(group, key, conditions = {})
+      #  self.joins(:groups).where("group.name = ?", group)
+      #end
+    
+  end
+    
+end

data/lib/zabbix/trigger.rb

@@ -0,0 +1,15 @@
+module Zabbix
+  
+  class Trigger < ::ActiveRecord::Base
+    
+    set_table_name "triggers"
+    set_primary_key "triggerid"
+    
+    has_many   :functions, :class_name => "Function", :foreign_key => "triggerid"
+    #
+    # might be one-to-one, not one-to-many??? 
+    #
+    
+  end
+  
+end

data/lib/zabbix/version.rb

@@ -0,0 +1,9 @@
+GEM_NAME = 'activerecord-zabbix'
+
+module Zabbix
+  
+  Version = VERSION = '0.1.0'
+    
+end
+
+MODULE_NAME = Zabbix

data/lib/zabbix/zabbix.rb

@@ -0,0 +1,8 @@
+require 'zabbix/version'
+
+require 'zabbix/connect'
+
+require 'zabbix/host'
+require 'zabbix/item'
+require 'zabbix/function'
+require 'zabbix/trigger'

data/spec/README

@@ -0,0 +1,4 @@
+
+The rails way would have set up a database.yml with a test subconfig that would trest the models on a local database.
+
+That has not been done...

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'activerecord-zabbix'

data/spec/zabbix/connect_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe Zabbix do
+  
+  before :each do
+    
+    
+    CONFIG = {
+      
+      
+      
+    }
+    
+  end
+
+  it 'connects' do
+    
+    ActiveRecord::Base.should_receive( 
+    
+      :establish_connection
+      
+    ).with( 
+    
+      {:password=>nil, :adapter=>nil, :host=>nil, :database=>nil, :username=>nil}
+    
+    )
+    
+    Zabbix.connect( nil, nil )
+    
+  end
+
+end

data/spec/zabbix/function_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe Zabbix::Function do
+  
+  # pending
+  
+end

data/spec/zabbix/host_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe Zabbix::Host do
+  
+  # pending 
+  
+end

data/spec/zabbix/item_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe Zabbix::Item do
+  
+  # pending 
+  
+end

data/spec/zabbix/trigger_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe Zabbix::Trigger do
+  
+  # pending 
+  
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification 
+name: activerecord-zabbix
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- ""
+- ""
+- ""
+- Richard
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-06-27 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: This is not a rails app.
+email: ops@clue.co.za
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib//activerecord-zabbix.rb
+- lib//boot.rb
+- lib//zabbix/connect.rb
+- lib//zabbix/function.rb
+- lib//zabbix/host.rb
+- lib//zabbix/item.rb
+- lib//zabbix/trigger.rb
+- lib//zabbix/version.rb
+- lib//zabbix/zabbix.rb
+- spec//README
+- spec//spec_helper.rb
+- spec//zabbix/connect_spec.rb
+- spec//zabbix/function_spec.rb
+- spec//zabbix/host_spec.rb
+- spec//zabbix/item_spec.rb
+- spec//zabbix/trigger_spec.rb
+- README.md
+- activerecord-zabbix.gemspec
+homepage: https://github.com/cluetechnologies/activerecord-zabbix
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: ActiveRecord access into Zabbix
+test_files: []
+