newrelic_f5_plugin 1.0.8 → 1.0.9

data/CHANGES

@@ -1,3 +1,11 @@
+* 1.0.9
+  - Add SNAT Pools statistics:
+    - Current Connections
+    - Connections per second
+    - Max Connections
+    - Throughput (In/Out)
+    - Packets per Second (In/Out)
+
 * 1.0.8
   - Changed the name attribute to agent_name as name wasn't being picked up
     and we don't want to break systems that might have it set.

data/bin/f5_monitor

@@ -5,6 +5,8 @@ require 'optparse'
 
 options = OptionParser.new do |opts|
   opts.banner = <<-EOF
+New Relic F5 Plugin version #{NewRelic::F5Plugin::VERSION}
+
 Usage:
   f5_monitor  ( run | install ) [options]
 EOF
@@ -26,7 +28,6 @@ EOF
   end
 
   opts.on("-h", "--help") do
-    puts "New Relic F5 Plugin version #{NewRelic::F5Plugin::VERSION}"
     puts opts
     if File.basename($0) == File.basename(__FILE__)
       exit 0

data/lib/newrelic_f5_plugin/agent.rb

@@ -4,7 +4,7 @@ require 'newrelic_plugin'
 require 'snmp'
 
 module NewRelic::F5Plugin
-  VERSION = '1.0.8'
+  VERSION = '1.0.9'
 
   # Register and run the agent
   def self.run
@@ -146,6 +146,33 @@ module NewRelic::F5Plugin
       pool_throughput_out = pool.get_throughput_out
       pool_throughput_out.each_key { |m| report_counter_metric m, "bits/sec", pool_throughput_out[m] } unless pool_throughput_out.nil?
 
+      #
+      # Collect snat pool statistics
+      #
+      NewRelic::PlatformLogger.debug("Collecting SNAT Pool stats")
+      snatpool = NewRelic::F5Plugin::SnatPools.new snmp
+
+      snatpool_conns_max = snatpool.get_conns_max
+      snatpool_conns_max.each_key { |m| report_metric m, "conns", snatpool_conns_max[m] } unless snatpool_conns_max.nil?
+
+      snatpool_conns_current = snatpool.get_conns_current
+      snatpool_conns_current.each_key { |m| report_metric m, "conns", snatpool_conns_current[m] } unless snatpool_conns_current.nil?
+
+      snatpool_conns_total = snatpool.get_conns_total
+      snatpool_conns_total.each_key { |m| report_counter_metric m, "conn/sec", snatpool_conns_total[m] } unless snatpool_conns_total.nil?
+
+      snatpool_throughput_in = snatpool.get_throughput_in
+      snatpool_throughput_in.each_key { |m| report_counter_metric m, "bits/sec", snatpool_throughput_in[m] } unless snatpool_throughput_in.nil?
+
+      snatpool_throughput_out = snatpool.get_throughput_out
+      snatpool_throughput_out.each_key { |m| report_counter_metric m, "bits/sec", snatpool_throughput_out[m] } unless snatpool_throughput_out.nil?
+
+      snatpool_packets_in = snatpool.get_packets_in
+      snatpool_packets_in.each_key { |m| report_counter_metric m, "pkts/sec", snatpool_packets_in[m] } unless snatpool_packets_in.nil?
+
+      snatpool_packets_out = snatpool.get_packets_out
+      snatpool_packets_out.each_key { |m| report_counter_metric m, "pkts/sec", snatpool_packets_out[m] } unless snatpool_packets_out.nil?
+
       #
       # Cleanup snmp connection
       #

data/lib/newrelic_f5_plugin/snatpools.rb

@@ -0,0 +1,182 @@
+#!/usr/bin/env ruby
+
+require 'newrelic_plugin'
+
+#LtmSnatPoolStatEntry
+#    ltmSnatPoolStatName                                    LongDisplayString,
+#    ltmSnatPoolStatServerPktsIn                            Counter64,
+#    ltmSnatPoolStatServerBytesIn                           Counter64,
+#    ltmSnatPoolStatServerPktsOut                           Counter64,
+#    ltmSnatPoolStatServerBytesOut                          Counter64,
+#    ltmSnatPoolStatServerMaxConns                          Counter64,
+#    ltmSnatPoolStatServerTotConns                          Counter64,
+#    ltmSnatPoolStatServerCurConns                          CounterBasedGauge64
+
+
+module NewRelic
+  module F5Plugin
+
+    class SnatPools
+      attr_accessor :names, :snmp_manager
+
+      OID_LTM_SNATS                      = "1.3.6.1.4.1.3375.2.2.9"
+      OID_LTM_SNAT_POOL                  = "#{OID_LTM_SNATS}.7"
+      OID_LTM_SNAT_POOL_ENTRY            = "#{OID_LTM_SNAT_POOL}.2.1"
+
+      OID_LTM_SNAT_POOL_STAT             = "#{OID_LTM_SNATS}.8"
+      OID_LTM_SNAT_POOL_STAT_ENTRY       = "#{OID_LTM_SNAT_POOL_STAT}.3.1"
+
+      OID_LTM_SNAT_POOL_STAT_NAME             = "#{OID_LTM_SNAT_POOL_STAT_ENTRY}.1"
+      OID_LTM_SNAT_POOL_STAT_SERVER_PKTS_IN   = "#{OID_LTM_SNAT_POOL_STAT_ENTRY}.2"
+      OID_LTM_SNAT_POOL_STAT_SERVER_BYTES_IN  = "#{OID_LTM_SNAT_POOL_STAT_ENTRY}.3"
+      OID_LTM_SNAT_POOL_STAT_SERVER_PKTS_OUT  = "#{OID_LTM_SNAT_POOL_STAT_ENTRY}.4"
+      OID_LTM_SNAT_POOL_STAT_SERVER_BYTES_OUT = "#{OID_LTM_SNAT_POOL_STAT_ENTRY}.5"
+      OID_LTM_SNAT_POOL_STAT_SERVER_MAX_CONNS = "#{OID_LTM_SNAT_POOL_STAT_ENTRY}.6"
+      OID_LTM_SNAT_POOL_STAT_SERVER_TOT_CONNS = "#{OID_LTM_SNAT_POOL_STAT_ENTRY}.7"
+      OID_LTM_SNAT_POOL_STAT_SERVER_CUR_CONNS = "#{OID_LTM_SNAT_POOL_STAT_ENTRY}.8"
+
+
+
+      #
+      # Init
+      #
+      def initialize(snmp = nil)
+        @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
+          @names.clear
+
+          begin
+            snmp.walk([OID_LTM_SNAT_POOL_STAT_NAME]) do |row|
+              row.each do |vb|
+                @names.push(vb.value)
+              end
+            end
+          rescue Exception => e
+            NewRelic::PlatformLogger.error("Unable to gather SNAT Pool names with error: #{e}")
+          end
+
+          NewRelic::PlatformLogger.debug("SNAT Pools: Found #{@names.size} pools")
+          return @names
+        end
+      end
+
+
+
+      #
+      # Gather Max Connection count
+      #
+      def get_conns_max(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("SnatPools/Max Connections", @names, OID_LTM_SNAT_POOL_STAT_SERVER_MAX_CONNS, snmp)
+        NewRelic::PlatformLogger.debug("SNAT Pools: Got #{res.size}/#{@names.size} Max Connection metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Connection count
+      #
+      def get_conns_current(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("SnatPools/Current Connections", @names, OID_LTM_SNAT_POOL_STAT_SERVER_CUR_CONNS, snmp)
+        NewRelic::PlatformLogger.debug("SNAT Pools: Got #{res.size}/#{@names.size} Current Connection metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Connection rate
+      #
+      def get_conns_total(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("SnatPools/Connection Rate", @names, OID_LTM_SNAT_POOL_STAT_SERVER_TOT_CONNS, snmp)
+        NewRelic::PlatformLogger.debug("SNAT Pools: Got #{res.size}/#{@names.size} Connection Rate metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Throughput Inbound (returns in bits)
+      #
+      def get_throughput_in(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("SnatPools/Throughput/In", @names, OID_LTM_SNAT_POOL_STAT_SERVER_BYTES_IN, snmp)
+        res = res.each_key { |n| res[n] *= 8 }
+        NewRelic::PlatformLogger.debug("SNAT Pools: Got #{res.size}/#{@names.size} Inbound Throughput metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Throughput Inbound (returns in bits)
+      #
+      def get_throughput_out(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("SnatPools/Throughput/Out", @names, OID_LTM_SNAT_POOL_STAT_SERVER_BYTES_OUT, snmp)
+        res = res.each_key { |n| res[n] *= 8 }
+        NewRelic::PlatformLogger.debug("SNAT Pools: Got #{res.size}/#{@names.size} Outbound Throughput metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Packets Inbound
+      #
+      def get_packets_in(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("SnatPools/Packets/In", @names, OID_LTM_SNAT_POOL_STAT_SERVER_PKTS_IN, snmp)
+        NewRelic::PlatformLogger.debug("SNAT Pools: Got #{res.size}/#{@names.size} Inbound packet metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Packets Outbound
+      #
+      def get_packets_out(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("SnatPools/Packets/Out", @names, OID_LTM_SNAT_POOL_STAT_SERVER_PKTS_OUT, snmp)
+        NewRelic::PlatformLogger.debug("SNAT Pools: Got #{res.size}/#{@names.size} Outbound packet metrics")
+        return res
+      end
+
+    end
+  end
+end
+

data/lib/newrelic_f5_plugin.rb

@@ -3,6 +3,7 @@ require 'newrelic_f5_plugin/util'
 require 'newrelic_f5_plugin/device'
 require 'newrelic_f5_plugin/nodes'
 require 'newrelic_f5_plugin/pools'
+require 'newrelic_f5_plugin/snatpools'
 require 'newrelic_f5_plugin/virtuals'
 require 'newrelic_f5_plugin/agent'
 

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.8'
-  s.date              = '2013-12-31'
+  s.version           = '1.0.9'
+  s.date              = '2014-01-21'
   s.rubyforge_project = 'newrelic_f5_plugin'
 
   ## Make sure your summary is short. The description may be as long
@@ -78,6 +78,7 @@ to find out how to install and run the plugin agent.
     lib/newrelic_f5_plugin/device.rb
     lib/newrelic_f5_plugin/nodes.rb
     lib/newrelic_f5_plugin/pools.rb
+    lib/newrelic_f5_plugin/snatpools.rb
     lib/newrelic_f5_plugin/util.rb
     lib/newrelic_f5_plugin/virtuals.rb
     newrelic_f5_plugin.gemspec

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: newrelic_f5_plugin
 version: !ruby/object:Gem::Version
-  version: 1.0.8
+  version: 1.0.9
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-31 00:00:00.000000000 Z
+date: 2014-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: newrelic_plugin
@@ -69,6 +69,7 @@ files:
 - lib/newrelic_f5_plugin/device.rb
 - lib/newrelic_f5_plugin/nodes.rb
 - lib/newrelic_f5_plugin/pools.rb
+- lib/newrelic_f5_plugin/snatpools.rb
 - lib/newrelic_f5_plugin/util.rb
 - lib/newrelic_f5_plugin/virtuals.rb
 - newrelic_f5_plugin.gemspec