prtg 0.0.1p1

data/lib/prtg/client.rb

@@ -0,0 +1,91 @@
+require "net/https"
+require "uri"
+require "cgi"
+require "prtg/query"
+require "prtg/utils"
+require 'xmlsimple'
+
+module Prtg # :nodoc:
+  class Client
+
+    # The host is a Net:Http(s) instance
+    attr_accessor :host
+
+    # Username of the prtg user
+    attr_accessor :username
+
+    # Password for prtg user
+    #
+    # The password is just temporary because of the intension to
+    # use +passhash+ as auth method.
+    attr_writer :password
+
+    attr_accessor :passhash
+
+    def initialize(args)
+      args.each do |k,v|
+        send("#{k}=", v)
+      end
+
+      @host or raise ArgumentError.new("Need host")
+    end
+
+    # The +passhash+ in comibnation with the +username+ is used for
+    # authentication. The passhash gets generated by the prtg instance.
+    #
+    # If no passhash is set he gets lazy converted using +password+
+    def passhash
+      @passhash ||= getpasshash
+    end
+
+    def getpasshash
+      url = "/api/getpasshash.htm?"+
+        Utils.url_params(:username => @username, :password => @password)
+      host.get(url, {"accept-encoding" => "gzip"}).body
+    end
+
+    def getstatus
+      host.get("/api/getstatus.xml")
+    end
+
+    def devices
+      params = {
+        :content => "devices",
+        :output  => "xml",
+        :columns => %w(
+          objid
+          probe
+          group
+          device
+          host
+          downsens
+          partialdownsens
+          downacksens
+          upsens
+          warnsens
+          pausedsens
+          unusualsens
+          undefinedsens).join(",")
+      }
+
+      api_request(params)
+    end
+
+    def auth_params
+      {:username => @username, :passhash => passhash}
+    end
+
+    def live_data(content)
+      Prtg::Query.new(self, content)
+    end
+
+    def api_request(params)
+      resp_body = host.get("/api/table.xml?" + Utils.url_params(auth_params.merge(params))).body
+      XmlSimple.xml_in(resp_body)
+    end
+
+    def method_missing(*args)
+      super(*args)
+    end
+  end
+end

data/lib/prtg/query.rb

@@ -0,0 +1,60 @@
+module Prtg # :nodoc:
+
+  # Proxy class to caspule request
+  class Query
+
+    # BlankSlate
+    instance_methods.each { |m| undef_method m unless m =~ /^(__|send|object_id)/ }
+
+    def initialize(client, content)
+      @prtg_client = client
+      @query_hash = {}
+      @query_hash[:output]  = :xml
+      @query_hash[:content] = content
+    end
+
+    # This single values for the query.
+    # They are pretty much like sql.
+    #
+    # content is like a table
+    # count is like LIMIT
+    # start is like OFFSET
+    VALUES = [:count, :start, :output, :id]
+
+    VALUES.each do |key|
+      define_method key do |value|
+        @query_hash[key] = value
+        self
+      end
+    end
+
+    MULTIPLE_VALUES = [:columns]
+
+    MULTIPLE_VALUES.each do |key|
+      define_method key do |*args|
+        @query_hash[key] = (@query_hash[key] || []) | args
+        self
+      end
+    end
+
+   def execute
+     @prtg_client.api_request(@query_hash)
+   end
+
+   private
+
+   def add_filter(name, value)
+     @query_hash[name.to_sym] = value
+     self
+   end
+
+   def method_missing(*args)
+     if args.first.to_s.start_with? "filter"
+       add_filter(*args)
+     else
+       execute.send(*args)
+     end
+   end
+
+  end
+end

data/lib/prtg/utils.rb

@@ -0,0 +1,22 @@
+require "cgi"
+
+module Prtg # :nodoc:
+
+  module Utils
+
+    # Convert hashes to get parameters
+    #
+    # Example:
+    #   Utils.url_params(name: "foo", login: "bar") #=> "name=foo&login=bar"
+    #
+    def self.url_params(params)
+      url_params = []
+
+      params.each do |key, value|
+        url_params << "#{CGI.escape(key.to_s)}=#{[*value].map{|v| CGI.escape(v.to_s)}.join(",")}"
+      end
+
+      url_params.join("&")
+    end
+  end
+end

data/lib/prtg.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+require "rubygems"
+require "happymapper"
+
+require "prtg/client"
+require "prtg/query"
+require "prtg/live_data_response"
+require "prtg/utils"
+
+# This is a wrapper for the api of paessler's prtg monitoring tool.
+#
+# Simple Example:
+#   http = Net::HTTP.new("subdomain.domain.tld", 443)
+#   http.use_ssl = true
+#   http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+#
+#   client = Prtg::Client.new(:host => http, :username => "foo", :password => "bar")
+#   p client.live_data(:sensors)
+module Prtg
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: prtg
+version: !ruby/object:Gem::Version
+  version: 0.0.1p1
+  prerelease: 5
+platform: ruby
+authors:
+- Konstantin Kanellopoulos
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-12-13 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: xml-simple
+  requirement: &70286691700740 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *70286691700740
+description: This gem is a wrapper around the prth http api.Prtg is an network monitoring
+  solution which provides a api to retrieve several information about monitored devices.
+email: k@kanello.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/prtg/client.rb
+- lib/prtg/query.rb
+- lib/prtg/utils.rb
+- lib/prtg.rb
+homepage: http://github.com/ikaros/Prtg-for-Ruby
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Wrapper for the prtg network monitor api (http://www.paessler.com/prtg)
+test_files: []