metzoo 0.1.3

data/lib/metzoo.rb

@@ -0,0 +1,163 @@
+#encoding: UTF-8
+
+require 'net/http'
+require 'json'
+
+# Interface to communicate with metzoo services
+#
+# To set the prouction environment (default): 
+#   Metzoo::API.uri = "http://api.metzoo.com/"
+#
+# To set the staging environment: 
+#   Metzoo::API.uri = "http://staging-metzoo01.dev.edrans.net:8081/"
+#
+# To initialize a customer instance just pass your customer key:
+#   customer = Metzoo::Customer.new('xxx-xxx....')
+#
+# To create a new agent or get an existing:
+#   agent = customer.create_agent("host name...") 
+#
+# To create a metric for an agent or just send data to new metric name:
+#   metric = agent.create_metric(["metric name 1..", ""metric name 2.."", ...]) 
+#
+# To send data for a create a metric for an agent:
+#   agent = customer.create_agent("host name...")
+#
+# Minimum example:
+#   require 'metzoo'
+#
+#   customer = Metzoo::Customer.new "xxx-xxx...."
+#   agent = customer.create_agent "host.local"
+#   agent.send_data "random.value": Random.rand(), "fix.value": 3.14 
+#
+module Metzoo
+
+  # Ruby SDK version
+  VERSION = '0.1.3'
+
+  # Raised on Metzoo exceptions
+  class MetzooException < Exception; end
+
+  # Customer access
+  #
+  class Customer
+
+    # Customer uniq identification
+    attr_reader :key
+
+    # Initialize a customer using the customer_key
+    #
+    # Attributes 
+    # * +customer_key+ - Customer uniq key 
+    # 
+    def initialize(customer_key)
+      @key = customer_key
+    end
+
+    # Create a new agent from a customer or get if exsits
+    #
+    # Attributes 
+    # * +host_name+ - A string with the agent name   
+    # 
+    def create_agent(host_name)
+      result_code, result_data = API.call("/agents", body: {host_name: host_name, customer_key: @key})
+      if [200,201].include? result_code
+        Agent.new result_data["agentKey"] || result_data.gsub(/"/, "")
+      else
+        raise MetzooException.new result_data
+      end
+    end
+  end
+
+  # Agent access
+  # 
+  class Agent
+    # Agent uniq identification
+    attr_reader :key
+
+    # Initialize an agent using the agent_key
+    #
+    # Attributes 
+    # * +agent_key+ - Agent uniq key 
+    # 
+    def initialize(agent_key)
+      @key = agent_key
+    end
+
+    # Create a new metric from an agent
+    # If the metric exists no error returns 
+    #
+    # Attributes 
+    # * +series+ - A string contain one metric name or an array contain metric names   
+    # 
+    def create_metric(series)
+      series= [series].flatten.map{|serie| serie.is_a?(String) ? Hash[[:name, :unit].zip(serie.split(":"))] : serie}
+      API.call("/metrics", header: {"Agent-Key" => @key}, body: series)
+    end
+
+    # Send data to agent metrics
+    #
+    # Multiple metrics for one agent can be sended 
+    #
+    # Attributes 
+    # * +data+ - hash with metrics and values
+    # You can send multiple metrics in a key-value format. 
+    # You can send the user time as :t attributte. If this attributte not exists the SDK will send your local time
+    #  
+    # Example:
+    #  agent.send_data t: Time.now, "random.value": Random.rand(100), "fix.value": 3.1416 
+    # 
+    def send_data(data)
+      data = Hash[data.map{|k, v| [k.to_s, v]}]
+      data["t"] = data["t"].utc.to_i if data["t"].is_a?(Time) 
+      data["t"] = Time.now.utc.to_i  if !data["t"]
+      API.call("/metrics/data?register=true", header: {"Agent-Key" => @key}, body: data)
+    end
+  end
+
+  # Metzoo API access
+  # 
+  class API
+    # The environment end-point URI address.
+    @@api = URI('http://api.metzoo.com/')
+
+    # Set the environment end-point URI address
+    def self.uri=(uri)
+      @@api = URI(uri)
+    end
+
+    def self.call(service, params = {})
+      headers = build_header(params[:header])
+      body    = params[:body].to_json if params[:body]
+
+      http = Net::HTTP.new(@@api.host, @@api.port)
+      req  = Net::HTTP::Post.new(service, headers)
+      req.body = body
+      res  = http.request(req)
+
+      [res.code.to_i, (JSON.parse(res.body) rescue res.body)]
+    end
+
+    private
+
+    def self.build_header(params = {})
+      {
+        "Content-Type" => "application/json",
+        "User-Agent"   => "Metzoo-Ruby-Client/#{Metzoo::VERSION}"
+      }.merge(params || {})
+    end
+  end
+
+end
+
+# require 'metzoo'
+#
+# # Metzoo::API.uri = "http://staging-metzoo01.dev.edrans.net:8081/"
+#
+# customer = Metzoo::Customer.new "2f9397a8-d339-4061-b9f2-cd54505d5c3f"
+# agent = customer.create_agent "host001.domain.com"
+#
+# agent = Metzoo::Agent.new "e22f3ebf-fa03-50c3-79cd-7064d1010a78"
+# agent.create_metric ["cpu.low", "cpu.high"]
+# agent.send_data "cpu.low" => 0.28, "cpu.high" => 0.65
+# agent.send_data "t" => Time.now, "cpu.low" => 0.28, "cpu.high" => 0.65

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: metzoo
+version: !ruby/object:Gem::Version
+  version: 0.1.3
+  prerelease: 
+platform: ruby
+authors:
+- Edrans development teem
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-10-21 00:00:00.000000000 Z
+dependencies: []
+description: Metzoo agent for Ruby
+email: tech-dev@edrans.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/metzoo.rb
+homepage: http://www.metzoo.com
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23.2
+signing_key: 
+specification_version: 3
+summary: Metzoo agent for Ruby
+test_files: []