newrelic_f5_plugin 1.0.15 → 1.0.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f4de3101ffe13d4eeb48b77722e6d0ede0d22ad6
-  data.tar.gz: 209080c82f5e16c92bacb4d35c204404d02865cb
+  metadata.gz: 6b7cc8b0330af44b1a00392f0d9dc7a048c0ce79
+  data.tar.gz: 0aab0890155622be2e12ab0ba2263cb7593f1ba7
 SHA512:
-  metadata.gz: 5796767f4c3461ff54ac392c3e6efde4d744fadf5d3b7f2743ce50345221d49cb40261309d7d10efce038a73e9f98197a346b3fa63c3c3119f13f81ad6daa6f1
-  data.tar.gz: 96db6ecf6410ae9a21a6bccfafb007cd44b6dc22e4e65cf0d9ec3b996d059147a76b9402b4ddd2b7b350e4845aa7b1663c386f532f8ec54673ceb2e6da0a8322
+  metadata.gz: dd8e326a708d65cf0f2f799328fe2802e059154d531e10317385234b67c1b4abfa495cf6e7010fbe891e044903565268e3d7f5d52d3b03de4113c1e227fd53c5
+  data.tar.gz: aa3406c4791ab4ffe72ef4a7b15eedd04d7f0797c636938fd06aa0e148222daf3bf121264db28f79b0af3533aa3ba87681389ed368152f3c134efa25cefc5db5

data/CHANGES

@@ -1,3 +1,12 @@
+* 1.0.16
+  - Added Interface statistics
+    - State
+    - Throughput
+    - Packets per second (Unicast/Multicast)
+    - Errors per second
+    - Dropped packets per second
+    - Collisions per second
+
 * 1.0.15
   - Fix bug in 1.0.14 where pool data collection was multiplied by 8 twice
 

data/README.rdoc

@@ -14,6 +14,14 @@ Device wide Metrics
 * TCP Details (Current connections, connection rate, Server/Client side, Wait State)
 * Node status
 
+Interface Statistics
+* State (Up/Down)
+* Throughput
+* Packets per Second (Unicast / Multicast)
+* Errors per Second
+* Dropped packets per Second
+* Collisions per Second
+
 Virtual Server Statistics
 * Requests per Second
 * Current Connections

data/lib/newrelic_f5_plugin.rb

@@ -2,6 +2,7 @@ require 'rubygems'
 require 'newrelic_f5_plugin/util'
 require 'newrelic_f5_plugin/client_ssl'
 require 'newrelic_f5_plugin/device'
+require 'newrelic_f5_plugin/interfaces'
 require 'newrelic_f5_plugin/nodes'
 require 'newrelic_f5_plugin/pools'
 require 'newrelic_f5_plugin/rules'

data/lib/newrelic_f5_plugin/agent.rb

@@ -4,7 +4,7 @@ require 'newrelic_plugin'
 require 'snmp'
 
 module NewRelic::F5Plugin
-  VERSION = '1.0.15'
+  VERSION = '1.0.16'
 
   # Register and run the agent
   def self.run
@@ -77,6 +77,11 @@ module NewRelic::F5Plugin
       @system ||= NewRelic::F5Plugin::Device.new
       @system.poll(self, snmp)
 
+      # Device Interface metrics
+      NewRelic::PlatformLogger.debug("Collecting Interface stats")
+      @interfaces ||= NewRelic::F5Plugin::Interfaces.new
+      @interfaces.poll(self, snmp)
+
       # Node stats
       NewRelic::PlatformLogger.debug("Collecting Node stats")
       @nodes ||= NewRelic::F5Plugin::Nodes.new

data/lib/newrelic_f5_plugin/interfaces.rb

@@ -0,0 +1,381 @@
+#!/usr/bin/env ruby
+
+require 'newrelic_plugin'
+require 'snmp'
+
+# sysInterfaceEntry
+#    sysInterfaceName                                       LongDisplayString,
+#    sysInterfaceMediaMaxSpeed                              Integer32,
+#    sysInterfaceMediaMaxDuplex                             INTEGER,
+#    sysInterfaceMediaActiveSpeed                           Integer32,
+#    sysInterfaceMediaActiveDuplex                          INTEGER,
+#    sysInterfaceMacAddr                                    MacAddress,
+#    sysInterfaceMtu                                        Integer32,
+#    sysInterfaceEnabled                                    INTEGER,
+#    sysInterfaceLearnMode                                  INTEGER,
+#    sysInterfaceFlowCtrlReq                                INTEGER,
+#    sysInterfaceStpLink                                    INTEGER,
+#    sysInterfaceStpEdge                                    INTEGER,
+#    sysInterfaceStpEdgeActive                              INTEGER,
+#    sysInterfaceStpAuto                                    INTEGER,
+#    sysInterfaceStpEnable                                  INTEGER,
+#    sysInterfaceStpReset                                   INTEGER,
+#    sysInterfaceStatus                                     INTEGER,
+#    sysInterfaceComboPort                                  INTEGER,
+#    sysInterfacePreferSfp                                  INTEGER,
+#    sysInterfaceSfpMedia                                   INTEGER,
+#    sysInterfacePhyMaster                                  INTEGER
+
+# sysInterfaceStatEntry
+#    sysInterfaceStatName                                   LongDisplayString,
+#    sysInterfaceStatPktsIn                                 Counter64,
+#    sysInterfaceStatBytesIn                                Counter64,
+#    sysInterfaceStatPktsOut                                Counter64,
+#    sysInterfaceStatBytesOut                               Counter64,
+#    sysInterfaceStatMcastIn                                Counter64,
+#    sysInterfaceStatMcastOut                               Counter64,
+#    sysInterfaceStatErrorsIn                               Counter64,
+#    sysInterfaceStatErrorsOut                              Counter64,
+#    sysInterfaceStatDropsIn                                Counter64,
+#    sysInterfaceStatDropsOut                               Counter64,
+#    sysInterfaceStatCollisions                             Counter64,
+#    sysInterfaceStatPauseActive                            INTEGER
+
+module NewRelic
+  module F5Plugin
+
+    class Interfaces
+      attr_accessor :names, :snmp_manager
+
+      INTERFACE_ENABLED_STATES = {
+        0 => 'Disabled',
+        1 => 'Enabled',
+      }
+      INTERFACE_STATUS_STATES = {
+        0 => 'Up',
+        1 => 'Down',
+        3 => 'Uninitialized',
+        5 => 'Unpopulated',
+      }
+      INTERFACE_DUPLEX_STATES = {
+        0 => 'None',
+        1 => 'Half',
+        2 => 'Full',
+      }
+
+      OID_SYS_INTERFACES                    = "1.3.6.1.4.1.3375.2.1.2.4"
+
+      # Config
+      OID_SYS_INTERFACE                     = "#{OID_SYS_INTERFACES}.1"
+      OID_SYS_INTERFACE_ENTRY               = "#{OID_SYS_INTERFACE}.2.1"
+
+      OID_SYS_INTERFACE_NAME                = "#{OID_SYS_INTERFACE_ENTRY}.1"
+      OID_SYS_INTERFACE_MEDIA_MAX_SPEED     = "#{OID_SYS_INTERFACE_ENTRY}.2"
+      OID_SYS_INTERFACE_MEDIA_MAX_DUPLEX    = "#{OID_SYS_INTERFACE_ENTRY}.3"
+      OID_SYS_INTERFACE_MEDIA_ACTIVE_SPEED  = "#{OID_SYS_INTERFACE_ENTRY}.4"
+      OID_SYS_INTERFACE_MEDIA_ACTIVE_DUPLEX = "#{OID_SYS_INTERFACE_ENTRY}.5"
+      OID_SYS_INTERFACE_MAC_ADDR            = "#{OID_SYS_INTERFACE_ENTRY}.6"
+      OID_SYS_INTERFACE_MTU                 = "#{OID_SYS_INTERFACE_ENTRY}.7"
+      OID_SYS_INTERFACE_ENABLED             = "#{OID_SYS_INTERFACE_ENTRY}.8"
+      OID_SYS_INTERFACE_STATUS              = "#{OID_SYS_INTERFACE_ENTRY}.17"
+
+      # Stats
+      OID_SYS_INTERFACE_STAT                = "#{OID_SYS_INTERFACES}.4"
+      OID_SYS_INTERFACE_STAT_ENTRY          = "#{OID_SYS_INTERFACE_STAT}.3.1"
+
+      OID_SYS_INTERFACE_STAT_NAME           = "#{OID_SYS_INTERFACE_STAT_ENTRY}.1"
+      OID_SYS_INTERFACE_STAT_PKTS_IN        = "#{OID_SYS_INTERFACE_STAT_ENTRY}.2"
+      OID_SYS_INTERFACE_STAT_BYTES_IN       = "#{OID_SYS_INTERFACE_STAT_ENTRY}.3"
+      OID_SYS_INTERFACE_STAT_PKTS_OUT       = "#{OID_SYS_INTERFACE_STAT_ENTRY}.4"
+      OID_SYS_INTERFACE_STAT_BYTES_OUT      = "#{OID_SYS_INTERFACE_STAT_ENTRY}.5"
+      OID_SYS_INTERFACE_STAT_MCAST_IN       = "#{OID_SYS_INTERFACE_STAT_ENTRY}.6"
+      OID_SYS_INTERFACE_STAT_MCAST_OUT      = "#{OID_SYS_INTERFACE_STAT_ENTRY}.7"
+      OID_SYS_INTERFACE_STAT_ERRORS_IN      = "#{OID_SYS_INTERFACE_STAT_ENTRY}.8"
+      OID_SYS_INTERFACE_STAT_ERRORS_OUT     = "#{OID_SYS_INTERFACE_STAT_ENTRY}.9"
+      OID_SYS_INTERFACE_STAT_DROPS_IN       = "#{OID_SYS_INTERFACE_STAT_ENTRY}.10"
+      OID_SYS_INTERFACE_STAT_DROPS_OUT      = "#{OID_SYS_INTERFACE_STAT_ENTRY}.11"
+      OID_SYS_INTERFACE_STAT_COLLISIONS     = "#{OID_SYS_INTERFACE_STAT_ENTRY}.12"
+
+
+
+      #
+      # Init
+      #
+      def initialize(snmp = nil)
+        @names = [ ]
+
+        if snmp
+          @snmp_manager = snmp
+        else
+          @snmp_manager = nil
+        end
+      end
+
+
+
+      #
+      # Perform polling and reportings of metrics
+      #
+      def poll(agent, snmp)
+        @snmp_manager = snmp
+
+        unless get_names.empty?
+          throughput_in = get_throughput_in
+          throughput_in.each_key { |m| agent.report_counter_metric m, "bits/sec", throughput_in[m] } unless throughput_in.nil?
+
+          throughput_out = get_throughput_out
+          throughput_out.each_key { |m| agent.report_counter_metric m, "bits/sec", throughput_out[m] } unless throughput_out.nil?
+
+          packets_in = get_packets_in
+          packets_in.each_key { |m| agent.report_counter_metric m, "pkts/sec", packets_in[m] } unless packets_in.nil?
+
+          packets_out = get_packets_out
+          packets_out.each_key { |m| agent.report_counter_metric m, "pkts/sec", packets_out[m] } unless packets_out.nil?
+
+          mcast_in = get_mcast_in
+          mcast_in.each_key { |m| agent.report_counter_metric m, "pkts/sec", mcast_in[m] } unless mcast_in.nil?
+
+          mcast_out = get_mcast_out
+          mcast_out.each_key { |m| agent.report_counter_metric m, "pkts/sec", mcast_out[m] } unless mcast_out.nil?
+
+          errors_in = get_errors_in
+          errors_in.each_key { |m| agent.report_counter_metric m, "errors/sec", errors_in[m] } unless errors_in.nil?
+
+          errors_out = get_errors_out
+          errors_out.each_key { |m| agent.report_counter_metric m, "errors/sec", errors_out[m] } unless errors_out.nil?
+
+          drops_in = get_drops_in
+          drops_in.each_key { |m| agent.report_counter_metric m, "drops/sec", drops_in[m] } unless drops_in.nil?
+
+          drops_out = get_drops_out
+          drops_out.each_key { |m| agent.report_counter_metric m, "drops/sec", drops_out[m] } unless drops_out.nil?
+
+          collisions = get_collisions
+          collisions.each_key { |m| agent.report_counter_metric m, "collisions/sec", collisions[m] } unless collisions.nil?
+
+          status = get_status
+          status.each_key { |m| agent.report_metric m, status[m][:label], status[m][:count] } unless status.nil?
+        end
+      end
+
+
+
+      #
+      # Get the list of Interface names
+      #
+      def get_names(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        if snmp
+          @names.clear
+
+          begin
+            snmp.walk([OID_SYS_INTERFACE_NAME]) do |row|
+              row.each do |vb|
+                @names.push(vb.value)
+              end
+            end
+          rescue Exception => e
+            NewRelic::PlatformLogger.error("Unable to gather Interface names with error: #{e}")
+          end
+
+          NewRelic::PlatformLogger.debug("Interfaces: Found #{@names.size} interfaces")
+          return @names
+        end
+      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("Interfaces/Throughput/In", @names, OID_SYS_INTERFACE_STAT_BYTES_IN, snmp)
+        res = res.each_key { |n| res[n] *= 8 }
+        NewRelic::PlatformLogger.debug("Interfaces: 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("Interfaces/Throughput/Out", @names, OID_SYS_INTERFACE_STAT_BYTES_OUT, snmp)
+        res = res.each_key { |n| res[n] *= 8 }
+        NewRelic::PlatformLogger.debug("Interfaces: 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("Interfaces/Packets/In", @names, OID_SYS_INTERFACE_STAT_PKTS_IN, snmp)
+        NewRelic::PlatformLogger.debug("Interfaces: 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("Interfaces/Packets/Out", @names, OID_SYS_INTERFACE_STAT_PKTS_OUT, snmp)
+        NewRelic::PlatformLogger.debug("Interfaces: Got #{res.size}/#{@names.size} Outbound packet metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Multicast Packets Inbound
+      #
+      def get_mcast_in(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("Interfaces/Multicast/In", @names, OID_SYS_INTERFACE_STAT_MCAST_IN, snmp)
+        NewRelic::PlatformLogger.debug("Interfaces: Got #{res.size}/#{@names.size} Inbound multicast metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Multicast Packets Outbound
+      #
+      def get_mcast_out(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("Interfaces/Multicast/Out", @names, OID_SYS_INTERFACE_STAT_MCAST_OUT, snmp)
+        NewRelic::PlatformLogger.debug("Interfaces: Got #{res.size}/#{@names.size} Outbound multicast metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Errors Inbound
+      #
+      def get_errors_in(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("Interfaces/Errors/In", @names, OID_SYS_INTERFACE_STAT_ERRORS_IN, snmp)
+        NewRelic::PlatformLogger.debug("Interfaces: Got #{res.size}/#{@names.size} Inbound error metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Errors Outbound
+      #
+      def get_errors_out(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("Interfaces/Errors/Out", @names, OID_SYS_INTERFACE_STAT_ERRORS_OUT, snmp)
+        NewRelic::PlatformLogger.debug("Interfaces: Got #{res.size}/#{@names.size} Outbound error metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Drops Inbound
+      #
+      def get_drops_in(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("Interfaces/Drops/In", @names, OID_SYS_INTERFACE_STAT_DROPS_IN, snmp)
+        NewRelic::PlatformLogger.debug("Interfaces: Got #{res.size}/#{@names.size} Inbound drop metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Drops Outbound
+      #
+      def get_drops_out(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("Interfaces/Drops/Out", @names, OID_SYS_INTERFACE_STAT_DROPS_OUT, snmp)
+        NewRelic::PlatformLogger.debug("Interfaces: Got #{res.size}/#{@names.size} Outbound drop metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Collisions
+      #
+      def get_collisions(snmp = nil)
+        snmp = snmp_manager unless snmp
+
+        get_names(snmp) if @names.empty?
+        res = gather_snmp_metrics_by_name("Interfaces/Collisions", @names, OID_SYS_INTERFACE_STAT_COLLISIONS, snmp)
+        NewRelic::PlatformLogger.debug("Interfaces: Got #{res.size}/#{@names.size} Collision metrics")
+        return res
+      end
+
+
+
+      #
+      # Gather Interface Status
+      #
+      def get_status(snmp = nil)
+        snmp = snmp_manager unless snmp
+        metrics = { }
+        counter = 0
+
+        if snmp
+          # Init all the states with zeros so we always get them
+          base_name = "Interfaces/Status"
+          INTERFACE_STATUS_STATES.each do |key,value|
+            metrics["#{base_name}/#{value}"] = { :label => "interfaces", :count => 0 }
+          end
+
+          # ltmNodeAddrMonitorStatus
+          begin
+            snmp.walk([OID_SYS_INTERFACE_STATUS]) do |row|
+              row.each do |vb|
+                metric_name = "#{base_name}/#{INTERFACE_STATUS_STATES[vb.value.to_i]}"
+                metrics[metric_name][:count]  += 1
+                counter += 1
+              end
+            end
+          rescue Exception => e
+            NewRelic::PlatformLogger.error("Unable to gather Interface status metrics with error: #{e}")
+          end
+        end
+
+        NewRelic::PlatformLogger.debug("Interfaces: Got #{counter} Status metrics")
+        return metrics
+      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.15'
-  s.date              = '2014-07-07'
+  s.version           = '1.0.16'
+  s.date              = '2014-08-18'
   s.rubyforge_project = 'newrelic_f5_plugin'
   s.licenses          = ['MIT']
 
@@ -78,6 +78,7 @@ to find out how to install and run the plugin agent.
     lib/newrelic_f5_plugin/agent.rb
     lib/newrelic_f5_plugin/client_ssl.rb
     lib/newrelic_f5_plugin/device.rb
+    lib/newrelic_f5_plugin/interfaces.rb
     lib/newrelic_f5_plugin/nodes.rb
     lib/newrelic_f5_plugin/pools.rb
     lib/newrelic_f5_plugin/rules.rb

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: newrelic_f5_plugin
 version: !ruby/object:Gem::Version
-  version: 1.0.15
+  version: 1.0.16
 platform: ruby
 authors:
 - Jonathan Thurman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-07 00:00:00.000000000 Z
+date: 2014-08-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: newrelic_plugin
@@ -73,6 +73,7 @@ files:
 - lib/newrelic_f5_plugin/agent.rb
 - lib/newrelic_f5_plugin/client_ssl.rb
 - lib/newrelic_f5_plugin/device.rb
+- lib/newrelic_f5_plugin/interfaces.rb
 - lib/newrelic_f5_plugin/nodes.rb
 - lib/newrelic_f5_plugin/pools.rb
 - lib/newrelic_f5_plugin/rules.rb