newrelic_f5_plugin 1.0.2 → 1.0.3

data/CHANGES

@@ -1,3 +1,10 @@
+* 1.0.3
+  - Add Pool statistics:
+    - Requests per second
+    - Current Connections
+    - Connections per second
+    - Throughput (In/Out)
+
 * 1.0.2
   - Removed bundler requirement as it was not needed
 

data/Gemfile

@@ -2,7 +2,7 @@ source 'https://rubygems.org'
 
 # This gemfile is used in the context of development on this plugin agent.
 
-gem 'newrelic_plugin', '>= 0.2.11'
+gem 'newrelic_plugin', '= 1.0.2'
 gem 'snmp'
 gem 'rake', '>0.9.2'
 gem 'test-unit'

data/README.rdoc

@@ -20,6 +20,12 @@ Virtual Server Statistics
 * Connections per Second
 * Inbound and Outbound Throughput
 
+Pool Statistics
+* Requests per Second
+* Current Connections
+* Connections per Second
+* Inbound and Outbound Throughput
+
 
 == Requirements
 
@@ -31,11 +37,11 @@ host also needs Ruby (tested with 1.8.7 and 1.9.3), and support for rubygems.
 
 === F5
 
-This plugin has been tested with F5 LTM versions 11.2.x and 11.3.x.  Some metrics are reported on
+This plugin has been tested with F5 LTM versions 11.2.x and 11.3.x. Some metrics are reported on
 10.2.x, but the data is incomplete due to SNMP changes made by F5 between 10 and 11.
 
 A *read-only* SNMP community is required for each device to be monitored. Currently, only
-SNMP verison 2c is supported.
+SNMP version 2c is supported.
 
 
 == Installation and Running

data/lib/newrelic_f5_plugin.rb

@@ -1,5 +1,6 @@
 require 'rubygems'
 require 'newrelic_f5_plugin/nodes'
+require 'newrelic_f5_plugin/pools'
 require 'newrelic_f5_plugin/virtuals'
 require 'newrelic_f5_plugin/agent'
 

data/lib/newrelic_f5_plugin/agent.rb

@@ -4,7 +4,7 @@ require 'newrelic_plugin'
 require 'snmp'
 
 module NewRelic::F5Plugin
-  VERSION = '1.0.2'
+  VERSION = '1.0.3'
 
   # Register and run the agent
   def self.run
@@ -87,6 +87,34 @@ module NewRelic::F5Plugin
         report_counter_metric m, "bits/sec", virtual_throughput_out[m]
       }
 
+      #
+      # Collect pool statistics
+      #
+      pool = NewRelic::F5Plugin::Pools.new snmp
+      pool_requests = pool.get_requests
+      pool_requests.each_key { |m|
+        report_counter_metric m, "req/sec", pool_requests[m]
+      }
+
+      pool_conns_current = pool.get_conns_current
+      pool_conns_current.each_key { |m|
+        report_metric m, "conns", pool_conns_current[m]
+      }
+
+      pool_conns_total = pool.get_conns_total
+      pool_conns_total.each_key { |m|
+        report_counter_metric m, "conn/sec", pool_conns_total[m]
+      }
+
+      pool_throughput_in = pool.get_throughput_in
+      pool_throughput_in.each_key { |m|
+        report_counter_metric m, "bits/sec", pool_throughput_in[m]
+      }
+
+      pool_throughput_out = pool.get_throughput_out
+      pool_throughput_out.each_key { |m|
+        report_counter_metric m, "bits/sec", pool_throughput_out[m]
+      }
 
 
       snmp.close

data/lib/newrelic_f5_plugin/pools.rb

@@ -0,0 +1,217 @@
+#!/usr/bin/env ruby
+
+require 'newrelic_plugin'
+require 'snmp'
+
+#  LtmPoolStatEntry
+#    ltmPoolStatName                                        LongDisplayString,
+#    ltmPoolStatServerPktsIn                                Counter64,
+#    ltmPoolStatServerBytesIn                               Counter64,
+#    ltmPoolStatServerPktsOut                               Counter64,
+#    ltmPoolStatServerBytesOut                              Counter64,
+#    ltmPoolStatServerMaxConns                              Counter64,
+#    ltmPoolStatServerTotConns                              Counter64,
+#    ltmPoolStatServerCurConns                              CounterBasedGauge64,
+#    ltmPoolStatPvaPktsIn                                   Counter64,
+#    ltmPoolStatPvaBytesIn                                  Counter64,
+#    ltmPoolStatPvaPktsOut                                  Counter64,
+#    ltmPoolStatPvaBytesOut                                 Counter64,
+#    ltmPoolStatPvaMaxConns                                 Counter64,
+#    ltmPoolStatPvaTotConns                                 Counter64,
+#    ltmPoolStatPvaCurConns                                 CounterBasedGauge64,
+#    ltmPoolStatTotPvaAssistConn                            Counter64,
+#    ltmPoolStatCurrPvaAssistConn                           CounterBasedGauge64,
+#    ltmPoolStatConnqDepth                                  Integer32,
+#    ltmPoolStatConnqAgeHead                                Integer32,
+#    ltmPoolStatConnqAgeMax                                 Integer32,
+#    ltmPoolStatConnqAgeEma                                 Integer32,
+#    ltmPoolStatConnqAgeEdm                                 Integer32,
+#    ltmPoolStatConnqServiced                               Counter64,
+#    ltmPoolStatConnqAllDepth                               Integer32,
+#    ltmPoolStatConnqAllAgeHead                             Integer32,
+#    ltmPoolStatConnqAllAgeMax                              Integer32,
+#    ltmPoolStatConnqAllAgeEma                              Integer32,
+#    ltmPoolStatConnqAllAgeEdm                              Integer32,
+#    ltmPoolStatConnqAllServiced                            Counter64,
+#    ltmPoolStatTotRequests                                 Counter64,
+#    ltmPoolStatCurSessions                                 CounterBasedGauge64
+
+
+module NewRelic
+  module F5Plugin
+
+    class Pools
+      attr_accessor :pool_names, :snmp_manager
+
+      OID_LTM_POOLS                      = "1.3.6.1.4.1.3375.2.2.5"
+      OID_LTM_POOL_STAT                  = "#{OID_LTM_POOLS}.2"
+      OID_LTM_POOL_ENTRY                 = "#{OID_LTM_POOL_STAT}.3.1"
+      OID_LTM_POOL_STAT_NAME             = "#{OID_LTM_POOL_ENTRY}.1"
+      OID_LTM_POOL_STAT_SERVER_BYTES_IN  = "#{OID_LTM_POOL_ENTRY}.3"
+      OID_LTM_POOL_STAT_SERVER_BYTES_OUT = "#{OID_LTM_POOL_ENTRY}.5"
+      OID_LTM_POOL_STAT_SERVER_TOT_CONNS = "#{OID_LTM_POOL_ENTRY}.7"
+      OID_LTM_POOL_STAT_SERVER_CUR_CONNS = "#{OID_LTM_POOL_ENTRY}.8"
+      OID_LTM_POOL_STAT_TOT_REQUESTS     = "#{OID_LTM_POOL_ENTRY}.30"
+
+
+
+      #
+      # Init
+      #
+      def initialize(snmp = nil)
+        @pool_names = [ ]
+
+        if snmp
+          @snmp_manager = snmp
+        else
+          @snmp_manager = nil
+        end
+      end
+
+
+
+      #
+      # Get the list of Pool names
+      #
+      def get_names(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        if snmp
+          @pool_names.clear
+
+          snmp.walk([OID_LTM_POOL_STAT_NAME]) do |row|
+            row.each do |vb|
+              @pool_names.push(vb.value)
+            end
+          end
+
+          return @pool_names
+        end
+      end
+
+
+
+      #
+      # Gather Total Requests
+      #
+      def get_requests(snmp = nil)
+        metrics = { }
+        index   = 0
+        snmp    = snmp_manager unless snmp
+
+        if snmp
+          get_names(snmp) if @pool_names.empty?
+
+          snmp.walk([OID_LTM_POOL_STAT_TOT_REQUESTS]) do |row|
+            row.each do |vb|
+              metrics["Pools/Requests/#{@pool_names[index]}"] = vb.value.to_i
+              index += 1
+            end
+          end
+
+          return metrics
+        end
+      end
+
+
+
+      #
+      # Gather Connection count
+      #
+      def get_conns_current(snmp = nil)
+        metrics = { }
+        index   = 0
+        snmp    = snmp_manager unless snmp
+
+        if snmp
+          get_names(snmp) if @pool_names.empty?
+
+          snmp.walk([OID_LTM_POOL_STAT_SERVER_CUR_CONNS]) do |row|
+            row.each do |vb|
+              metrics["Pools/Current Connections/#{@pool_names[index]}"] = vb.value.to_i
+              index += 1
+            end
+          end
+
+          return metrics
+        end
+      end
+
+
+
+      #
+      # Gather Connection rate
+      #
+      def get_conns_total(snmp = nil)
+        metrics = { }
+        index   = 0
+        snmp    = snmp_manager unless snmp
+
+        if snmp
+          get_names(snmp) if @pool_names.empty?
+
+          snmp.walk([OID_LTM_POOL_STAT_SERVER_TOT_CONNS]) do |row|
+            row.each do |vb|
+              metrics["Pools/Connection Rate/#{@pool_names[index]}"] = vb.value.to_i
+              index += 1
+            end
+          end
+
+          return metrics
+        end
+      end
+
+
+
+      #
+      # Gather Throughput Inbound (returns in bits)
+      #
+      def get_throughput_in(snmp = nil)
+        metrics = { }
+        index   = 0
+        snmp    = snmp_manager unless snmp
+
+        if snmp
+          get_names(snmp) if @pool_names.empty?
+
+          snmp.walk([OID_LTM_POOL_STAT_SERVER_BYTES_IN]) do |row|
+            row.each do |vb|
+              metrics["Pools/Throughput/In/#{@pool_names[index]}"] = (vb.value.to_f * 8)
+              index += 1
+            end
+          end
+
+          return metrics
+        end
+      end
+
+
+
+      #
+      # Gather Throughput Inbound (returns in bits)
+      #
+      def get_throughput_out(snmp = nil)
+        metrics = { }
+        index   = 0
+        snmp    = snmp_manager unless snmp
+
+        if snmp
+          get_names(snmp) if @pool_names.empty?
+
+          snmp.walk([OID_LTM_POOL_STAT_SERVER_BYTES_OUT]) do |row|
+            row.each do |vb|
+              metrics["Pools/Throughput/Out/#{@pool_names[index]}"] = (vb.value.to_f * 8)
+              index += 1
+            end
+          end
+
+          return metrics
+        end
+      end
+
+
+
+    end
+  end
+end
+

data/newrelic_f5_plugin.gemspec

@@ -13,8 +13,8 @@ Gem::Specification.new do |s|
   ## If your rubyforge_project name is different, then edit it and comment out
   ## the sub! line in the Rakefile
   s.name              = 'newrelic_f5_plugin'
-  s.version           = '1.0.2'
-  s.date              = '2013-07-30'
+  s.version           = '1.0.3'
+  s.date              = '2013-09-10'
   s.rubyforge_project = 'newrelic_f5_plugin'
 
   ## Make sure your summary is short. The description may be as long
@@ -51,7 +51,7 @@ This is the New Relic plugin for monitoring F5 devices developed by New Relic, I
   ## The newrelic_plugin needs to be installed.  Prior to public release, the
   # gem needs to be downloaded from git@github.com:newrelic-platform/newrelic_plugin.git
   # and built using the "rake build" command
-  s.add_dependency('newrelic_plugin', ">= 0.2.11")
+  s.add_dependency('newrelic_plugin', "= 1.0.2")
   s.add_dependency('snmp', ">= 1.1.0")
 
   s.post_install_message = <<-EOF
@@ -76,6 +76,7 @@ to find out how to install and run the plugin agent.
     lib/newrelic_f5_plugin.rb
     lib/newrelic_f5_plugin/agent.rb
     lib/newrelic_f5_plugin/nodes.rb
+    lib/newrelic_f5_plugin/pools.rb
     lib/newrelic_f5_plugin/virtuals.rb
     newrelic_f5_plugin.gemspec
     test/f5_monitor_test.rb

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: newrelic_f5_plugin
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,24 +9,24 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-30 00:00:00.000000000 Z
+date: 2013-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: newrelic_plugin
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.11
+        version: 1.0.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.11
+        version: 1.0.2
 - !ruby/object:Gem::Dependency
   name: snmp
   requirement: !ruby/object:Gem::Requirement
@@ -67,6 +67,7 @@ files:
 - lib/newrelic_f5_plugin.rb
 - lib/newrelic_f5_plugin/agent.rb
 - lib/newrelic_f5_plugin/nodes.rb
+- lib/newrelic_f5_plugin/pools.rb
 - lib/newrelic_f5_plugin/virtuals.rb
 - newrelic_f5_plugin.gemspec
 - test/f5_monitor_test.rb