haproxy_manager 0.1.1 → 0.1.2

data/Readme.md

@@ -16,6 +16,50 @@ For this to work haproxy
 
   `stats socket /home/ubuntu/haproxysock level admin`
 
-  It means that haproxy will open a socket at /home/ubuntu/haproxysock. You can specify the level. We use `admin`.
+  It means that haproxy will open a socket at /home/ubuntu/haproxysock. You can specify the level to use. We use `admin`. But I believe operator/admin is needed for the enable/disable/setting weights to work correctly.
 
+Installation
+==============
+  Install the latest version of the gem with the following command...
 
+      $ gem install haproxy_manager
+
+      require "haproxy_manager"
+
+  # Gemfile in Rails app
+      gem "haproxy_manger", :require => false
+
+      Add the following where approporiate(eg. deploy.rb)
+      require "haproxy_manager"
+
+API
+======
+```Ruby
+
+haproxy = HAProxyManager.new ('path to haproxy socket')
+
+haproxy.backends # Lists all the backends available
+haproxy.servers("foo-farm")  # List all the servers available in the given backend
+
+haproxy.disable("preprod-app", "foo-farm") # Disables a server in a specific farm
+haproxy.disable("preprod-app") # Disables a server with a given name in all the available backends
+
+
+haproxy.enable("preprod-app", "foo-farm") # Enables a server in a specific farm
+haproxy.enable("preprod-app") # Enables a server with a given name in all the available backends
+
+haproxy.weight("preprod-app", "foo-farm", "10") # Sets the weight to 10. The value can be between 0 - 255
+haproxy.weight("preprod-app", "foo-farm", "10%") # Reduces the weight of the server by 10%(of the value specified in the config)
+haproxy.weight("preprod-app", "foo-farm", "0%") # Reduces the weight of the server to 0. Useful for disabling the server.
+haproxy.weight("preprod-app", "foo-farm", "100%") # Increases the weight to the original configuration value. useful to bring the server back up after reducing the weight to 0%
+
+haproxy.weight("preprod-app", "foo-farm") # Returns the current weights setting. The response is something like this.
+{current => 10, initial=> 12}
+
+
+haproxy.info # provides information about the haproxy setup. The following is how it looks like. Most fields are self describing.
+{"Name" =>  "HAProxy", "Version" =>  "1.5-dev11", "Release_date" =>  "2012/06/04", "Nbproc" =>  "1", "Process_num" =>  "1", "Pid" =>  "4084", "Uptime" =>  "58d 3h50m53s", "Uptime_sec" => "5025053", "Memmax_MB" =>  "0", "Ulimit-n" =>  "40029", "Maxsock" =>  "40029", "Maxconn" =>  "20000", "Hard_maxconn =>  "20000", "Maxpipes" => "0", "CurrConns" => "0", "PipesUsed" => "0", "PipesFree" => " 0", "ConnRate" => " 0", "ConnRateLimit" => " 0", "MaxConnRate" => " 69", "Tasks" => " 10", "Run_queue" => " 1", "Idle_pct" => "100", "node" => " The server name", "description" => "Our Awesome Load balancer"}
+
+haproxy.reset_counters # Clears HAProxy counters. Except Global counters
+haproxy.reset_counters(:all) # Clears All HAProxy counters. This is the equivalent of a restart
+```

data/haproxy_manager.gemspec

@@ -5,7 +5,7 @@ Gem::Specification.new do |s|
   s.version = HAProxyManager::VERSION
   s.platform = Gem::Platform::RUBY
   s.authors = ["Sreekanth(sreeix)", "Smita Bhat(sbhat)"]
-  s.email = ["gabbar@activesphere.com"]
+  s.email = ["gabbar@activesphere.com", "sbhat@altheasystems.com"]
   s.homepage = "https://github.com/althea/haproxy-manager"
   s.summary = 'HAproxy manager for controlling haproxy'
   s.description = 'Manages haproxy farms and servers'

data/lib/haproxy_manager/constants.rb

@@ -0,0 +1,4 @@
+module HAProxyManager
+  module Constants
+  end
+end

data/lib/haproxy_manager/instance.rb

@@ -33,13 +33,39 @@ module HAProxyManager
       @socket.execute( "show info").inject({}){|hash, item| x = item.split(":"); hash.merge(x[0].strip =>  x[1].strip)}
     end
 
+    # Sets weight for the server. If a numeric value is provider, that will become the absolute weight. It can be between 0 -256
+    # If a weight has been provided ending with % then the weight is reduced by that percentage. It has to be between 0% - 100%
+    # Weight of a server defines, how many requests are passed to it.
+    def weights(server, backend, weight=nil)
+      if(weight.nil?)
+        weight = @socket.execute "get weight #{backend}/#{server}"
+        /(\d*)\s\(initial\s(\d*)\)/.match( weight[0])
+        {:current => $1.to_i, :initial => $2.to_i}
+      else
+        @socket.execute "set weight #{backend}/#{server} #{weight}"
+      end
+    end
+
+    def stats
+      stats = @socket.execute( "show stat -1 -1 -1" )
+      headers = stats[0].split(",")
+      stats[1..-1].inject({}) do |hash, line|
+        data = line.split(","); backend = data[0]; server = data[1]; rest = data[2..-1]
+        hash[backend] = {} if( hash[backend].nil?)
+        hash[backend][server] = {}.tap do |server_hash|
+          headers[2..-1].each_with_index{|x, i| server_hash[x]= rest[i]}
+        end
+        hash
+      end
+    end
+
     def servers(backend = nil)
       backend.nil? ? @backends.values.flatten : @backends[backend]
     end
-    
+
     # resets Haproxy counters. If no option is specified backend and frontend counters are cleared, but
     # cumulative counters are not cleared. The cumulative counters can be cleared by passing the option of
-    # all to the method, in that case all the counters are cleared. This is similar to a restart.
+    # :all to the method, in that case all the counters are cleared. This is similar to a restart.
     # This is useful to reset stats after for example an incident.
     def reset_counters(option = "")
       @socket.execute "clear counters {option}", &@print_response

data/lib/haproxy_manager/version.rb

@@ -1,3 +1,3 @@
 module HAProxyManager
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/spec/instance_spec.rb

@@ -10,7 +10,19 @@ module HAProxyManager
        "foo-https-farm,preprod-bg,0,0,0,0,30,0,0,0,,0,,0,0,0,0,DOWN,5,1,0,4,4,2453494,4518368,,1,2,2,,0,,2,0,,0,L4CON,,0,0,0,0,0,0,0,0,,,,0,0,", 
        "foo-https-farm,preprod-test,0,0,0,0,30,0,0,0,,0,,0,0,0,0,DOWN,5,1,0,0,1,5017532,5017532,,1,2,3,,0,,2,0,,0,L4CON,,0,0,0,0,0,0,0,0,,,,0,0,"]
       @info_response = ["Name: HAProxy", "Version: 1.5-dev11", "Release_date: 2012/06/04", "Nbproc: 1", "Process_num: 1", "Pid: 4084", "Uptime: 58d 3h50m53s", "Uptime_sec: 5025053", "Memmax_MB: 0", "Ulimit-n: 40029", "Maxsock: 40029", "Maxconn: 20000", "Hard_maxconn: 20000", "Maxpipes: 0", "CurrConns: 0", "PipesUsed: 0", "PipesFree: 0", "ConnRate: 0", "ConnRateLimit: 0", "MaxConnRate: 69", "Tasks: 10", "Run_queue: 1", "Idle_pct: 100", "node: some machine on ec3", "description: Our awesome load balancer"]
+      @allstats = ["# pxname,svname,qcur,qmax,scur,smax,slim,stot,bin,bout,dreq,dresp,ereq,econ,eresp,wretr,wredis,status,weight,act,bck,chkfail,chkdown,lastchg,downtime,qlimit,pid,iid,sid,throttle,lbtot,tracked,type,rate,rate_lim,rate_max,check_status,check_code,check_duration,hrsp_1xx,hrsp_2xx,hrsp_3xx,hrsp_4xx,hrsp_5xx,hrsp_other,hanafail,req_rate,req_rate_max,req_tot,cli_abrt,srv_abrt,",
+        "foo-farm,FRONTEND,,,0,150,2000,165893,38619996,3233457381,0,0,6504,,,,,OPEN,,,,,,,,,1,1,0,,,,0,0,0,69,,,,0,136147,2128,6654,20955,9,,0,144,165893,,,",
+        "foo-farm,preprod-app,0,9,0,60,60,139066,34839081,3222850212,,0,,3,725,0,0,UP,10,1,0,583,148,10893,257935,,1,1,1,,114847,,2,0,,88,L7OK,200,150,0,135827,2128,147,230,0,0,,,,20,11,",
+        "foo-farm,preprod-bg,0,0,0,3,30,31,14333,380028,,0,,0,9,4,2,DOWN,5,1,0,4,10,2538799,4603702,,1,1,2,,6,,2,0,,2,L4CON,,0,0,16,0,0,0,0,0,,,,1,0,",
+        "foo-farm,preprod-test,0,0,0,0,30,0,0,0,,0,,0,0,0,0,DOWN,5,1,0,0,1,5102839,5102839,,1,1,3,,0,,2,0,,0,L4CON,,0,0,0,0,0,0,0,0,,,,0,0,",
+        "foo-farm,BACKEND,0,84,0,150,200,159082,38619996,3233457381,0,0,,19991,734,4,2,UP,10,1,0,,148,10893,300268,,1,1,0,,114853,,1,0,,144,,,,0,135843,2128,147,20955,9,,,,,21,11,",
+        "foo-https-farm,FRONTEND,,,0,3,2000,6545,2675933,71871179,0,0,76,,,,,OPEN,,,,,,,,,1,2,0,,,,0,0,0,3,,,,0,5912,181,82,313,57,,0,3,6545,,,",
+        "foo-https-farm,preprod-app,0,0,0,3,60,6219,2577996,71804141,,0,,1,30,3,0,UP,12,1,0,580,142,10893,257923,,1,2,1,,1948,,2,0,,2,L7OK,200,70,0,5912,181,11,29,0,0,,,,501,0,",
+        "foo-https-farm,preprod-bg,0,0,0,0,30,0,0,0,,0,,0,0,0,0,DOWN,5,1,0,4,4,2538799,4603673,,1,2,2,,0,,2,0,,0,L4CON,,0,0,0,0,0,0,0,0,,,,0,0,",
+        "foo-https-farm,preprod-test,0,0,0,0,30,0,0,0,,0,,0,0,0,0,DOWN,5,1,0,0,1,5102837,5102837,,1,2,3,,0,,2,0,,0,L4CON,,0,0,0,0,0,0,0,0,,,,0,0,",
+        "foo-https-farm,BACKEND,0,0,0,3,200,6469,2675933,71871179,0,0,,254,30,3,0,UP,12,1,0,,142,10893,300288,,1,2,0,,1948,,1,0,,2,,,,0,5912,181,11,313,52,,,,,501,0,"]
     end
+
     before(:each) do
       HAPSocket.any_instance.expects(:execute).once.returns(@stat_response)
       @instance = Instance.new("foo")
@@ -32,7 +44,7 @@ module HAProxyManager
         @instance.servers.should include "preprod-test"
       end
     end
-    
+
     describe "enables/disables servers" do
       it "enables a server" do
         HAPSocket.any_instance.expects(:execute).with('enable server foo-farm/preprod-bg')
@@ -56,11 +68,41 @@ module HAProxyManager
         @instance.disable("preprod-bg")
       end
     end
+    describe "weights" do
+      it "gets current weight" do
+        HAPSocket.any_instance.expects(:execute).with('get weight foo-farm/preprod-bg').returns(["10 (initial 12)"])
+        weights = @instance.weights("preprod-bg","foo-farm" )
+        weights[:current].should == 10
+        weights[:initial].should == 12
+      end
+
+      it "sets weight if weight is specified" do
+        HAPSocket.any_instance.expects(:execute).with('set weight foo-farm/preprod-bg 20')
+        weights = @instance.weights "preprod-bg","foo-farm", 20
+      end
+    end
+    describe "stats" do
+      it "show for all servers" do
+        HAPSocket.any_instance.expects(:execute).with('show stat -1 -1 -1').returns(@allstats)
+        stats = @instance.stats
+        stats.keys.size.should == 2
+        stats.keys.should include "foo-farm"
+        stats.keys.should include "foo-https-farm"
+        stats["foo-farm"].keys.size.should == 5
+        ["BACKEND", "FRONTEND", "preprod-app", "preprod-bg"].each do |item|
+          stats["foo-farm"].keys.should include item
+          stats["foo-https-farm"].keys.should include item
+        end
+        stats["foo-https-farm"]["preprod-app"]["status"].should == "UP"
+        stats["foo-https-farm"]["preprod-app"]["weight"].should == "12"
+        stats["foo-https-farm"]["preprod-bg"]["status"].should == "DOWN"
+        stats["foo-https-farm"]["preprod-bg"]["weight"].should == "5"
+      end
+    end
 
     describe "info about haproxy" do
       it "has description/version and uptime" do
         HAPSocket.any_instance.expects(:execute).with("show info").returns(@info_response)
-        
         info = @instance.info
         info["description"].should == 'Our awesome load balancer'
         info["Version"].should == '1.5-dev11'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: haproxy_manager
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-21 00:00:00.000000000 Z
+date: 2012-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: couchrest
@@ -95,6 +95,7 @@ dependencies:
 description: Manages haproxy farms and servers
 email:
 - gabbar@activesphere.com
+- sbhat@altheasystems.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -106,6 +107,7 @@ files:
 - Readme.md
 - haproxy_manager.gemspec
 - lib/haproxy_manager.rb
+- lib/haproxy_manager/constants.rb
 - lib/haproxy_manager/instance.rb
 - lib/haproxy_manager/version.rb
 - spec/instance_spec.rb
@@ -124,7 +126,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4440927357192594363
+      hash: -845805154420122450
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -133,7 +135,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4440927357192594363
+      hash: -845805154420122450
 requirements: []
 rubyforge_project: haproxy_manager
 rubygems_version: 1.8.24