newrelic_f5_plugin 1.0.19 → 1.0.21

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 076a201506f8e2df06811fe92dfa70515c1da316
+  data.tar.gz: 417547dbe9f85aabbf9895eb019732c249d0e498
+SHA512:
+  metadata.gz: 59e7b3316e6a9cbb643877a1f938f9a5fa15cc4056d81dc33b1563281e19b6de40845080a45018ebf0ad0dfbb034afc43b2e69c5e73d8ab13ae1b28c3013ea98
+  data.tar.gz: 1e5f336c21ca334a660e2fd16266dee46afa308f6669ae14aa151ed5f038b4b03812d27c6490fc4d6605f49be3d57dcab1ce0d14d90910507f7cc864cc824a56

data/CHANGES

@@ -1,3 +1,9 @@
+* 1.0.21
+  - Add Hardware SYN Cookie generation / detection metrics
+
+* 1.0.20
+  - Add TLS v1.1 and v1.2 specific global metrics
+
 * 1.0.19
   - Adapt to CPU reporting changes in versions after 11.4.1
 

data/README.rdoc

@@ -75,7 +75,7 @@ SNMP version 2c is supported.
       f5_monitor install -l LICENSE_KEY
 
    using the license key from your New Relic account.
-4. Edit the +config/newrelic_plugin.yml+ file generated in step 4.  Setup name/hostname/port/snmp_community for each F5 you wish to monitor.
+4. Edit the +config/newrelic_plugin.yml+ file generated in step 3.  Setup name/hostname/port/snmp_community for each F5 you wish to monitor.
 5. Execute
 
       f5_monitor run
@@ -97,6 +97,20 @@ The F5 plugin can also be installed with {Chef}[http://www.getchef.com] and {Pup
 
 Additional information on using Chef and Puppet with New Relic is available in New Relic's {documentation}[https://docs.newrelic.com/docs/plugins/plugin-installation-with-chef-and-puppet].
 
+== Logging Instructions
+
+Logging goes to stdout by default.
+
+There are 2 methods to increase logging to verbose level. Choose one of the following:
+
+1. Uncomment the following line from the +config/newrelic_plugin.yml+ file:
+
+      #verbose: 1
+
+2. Execute the plugin with the +-v+ or +--verbose+ option.
+
+      f5_monitor run -v
+
 == Developer Instructions
 
 1. Fork/Clone the repository

data/lib/newrelic_f5_plugin/agent.rb

@@ -4,7 +4,7 @@ require 'newrelic_plugin'
 require 'snmp'
 
 module NewRelic::F5Plugin
-  VERSION = '1.0.19'
+  VERSION = '1.0.21'
 
   # Register and run the agent
   def self.run

data/lib/newrelic_f5_plugin/device.rb

@@ -84,6 +84,9 @@ module NewRelic
       OID_SYS_TCP_STAT_RXBADCOOKIE                           = "#{OID_SYS_TCP_STAT}.17.0"  # "The number of bad SYN-cookies."
       OID_SYS_TCP_STAT_SYNCACHEOVER                          = "#{OID_SYS_TCP_STAT}.18.0"  # "The number of SYN-cache overflow."
       OID_SYS_TCP_STAT_TXREXMITS                             = "#{OID_SYS_TCP_STAT}.19.0"  # "The number of retransmitted segments."
+      OID_SYS_GLOBAL_STAT                                    = "1.3.6.1.4.1.3375.2.1.1.2"
+      OID_SYS_STAT_HARD_SYNCOOKIE_GEN                        = "#{OID_SYS_GLOBAL_STAT}.57.0"  # "The number of hardware SYN cookies are generated on the system."
+      OID_SYS_STAT_HARD_SYNCOOKIE_DET                        = "#{OID_SYS_GLOBAL_STAT}.58.0"  # "The number of hardware SYN cookies are detected on the system."
 
 
       #
@@ -432,15 +435,17 @@ module NewRelic
 
         if snmp
           res = gather_snmp_metrics_array([OID_SYS_TCP_STAT_RXCOOKIE, OID_SYS_TCP_STAT_RXBADCOOKIE,
-                                           OID_SYS_TCP_STAT_SYNCACHEOVER],
+                                           OID_SYS_TCP_STAT_SYNCACHEOVER, OID_SYS_STAT_HARD_SYNCOOKIE_GEN, OID_SYS_STAT_HARD_SYNCOOKIE_DET],
                                          snmp)
 
           # Bail out if we didn't get anything
           return metrics if res.empty?
 
-          metrics["TCP/SYN/Received SYN-Cookies"] = res[0]
-          metrics["TCP/SYN/Bad SYN-Cookies"]      = res[1]
-          metrics["TCP/SYN/SYN-cache Overflows"]  = res[2]
+          metrics["TCP/SYN/Received SYN-Cookies"]           = res[0]
+          metrics["TCP/SYN/Bad SYN-Cookies"]                = res[1]
+          metrics["TCP/SYN/SYN-cache Overflows"]            = res[2]
+          metrics["TCP/SYN/Hardware SYN-Cookies Generated"] = res[3]
+          metrics["TCP/SYN/Hardware SYN-Cookies Detected"]  = res[4]
         end
 
         return metrics

data/lib/newrelic_f5_plugin/global_ssl.rb

@@ -69,6 +69,15 @@ module NewRelic
       OID_SYS_SERVERSSL_STAT_SHA_DIGEST        = "#{OID_SYS_GLOBAL_SERVER_SSL_STAT}.49.0"
       OID_SYS_SERVERSSL_STAT_NOTSSL            = "#{OID_SYS_GLOBAL_SERVER_SSL_STAT}.50.0"
 
+      # Client-side TLS
+      OID_SYS_CLIENTSSL_STAT_TLSV11            = "#{OID_SYS_GLOBAL_CLIENT_SSL_STAT}.60.0"
+      OID_SYS_CLIENTSSL_STAT_TLSV12            = "#{OID_SYS_GLOBAL_CLIENT_SSL_STAT}.61.0"
+      OID_SYS_CLIENTSSL_STAT_DTLSV1            = "#{OID_SYS_GLOBAL_CLIENT_SSL_STAT}.62.0"
+      # Server-side TLS
+      OID_SYS_SERVERSSL_STAT_TLSV11            = "#{OID_SYS_GLOBAL_SERVER_SSL_STAT}.57.0"
+      OID_SYS_SERVERSSL_STAT_TLSV12            = "#{OID_SYS_GLOBAL_SERVER_SSL_STAT}.58.0"
+      OID_SYS_SERVERSSL_STAT_DTLSV1            = "#{OID_SYS_GLOBAL_SERVER_SSL_STAT}.59.0"
+
 
 
       #
@@ -176,8 +185,10 @@ module NewRelic
 
         if snmp
 
-          res = gather_snmp_metrics_array([OID_SYS_CLIENTSSL_STAT_SSLV2, OID_SYS_CLIENTSSL_STAT_SSLV3, OID_SYS_CLIENTSSL_STAT_TLSV1,
-                                           OID_SYS_SERVERSSL_STAT_SSLV2, OID_SYS_SERVERSSL_STAT_SSLV3, OID_SYS_SERVERSSL_STAT_TLSV1],
+          res = gather_snmp_metrics_array([OID_SYS_CLIENTSSL_STAT_SSLV2,  OID_SYS_CLIENTSSL_STAT_SSLV3,  OID_SYS_CLIENTSSL_STAT_TLSV1,
+                                           OID_SYS_SERVERSSL_STAT_SSLV2,  OID_SYS_SERVERSSL_STAT_SSLV3,  OID_SYS_SERVERSSL_STAT_TLSV1,
+                                           OID_SYS_CLIENTSSL_STAT_TLSV11, OID_SYS_CLIENTSSL_STAT_TLSV12, OID_SYS_SERVERSSL_STAT_TLSV11,
+                                           OID_SYS_SERVERSSL_STAT_TLSV12],
                                            snmp)
 
           # Bail out if we didn't get anything
@@ -185,12 +196,16 @@ module NewRelic
 
           vals = res.map { |i| i.to_i }
 
-          metrics["SSL/Global/Protocol/Client/SSLv2"] = vals[0]
-          metrics["SSL/Global/Protocol/Client/SSLv3"] = vals[1]
-          metrics["SSL/Global/Protocol/Client/TLSv1"] = vals[2]
-          metrics["SSL/Global/Protocol/Server/SSLv2"] = vals[3]
-          metrics["SSL/Global/Protocol/Server/SSLv3"] = vals[4]
-          metrics["SSL/Global/Protocol/Server/TLSv1"] = vals[5]
+          metrics["SSL/Global/Protocol/Client/SSLv2"]   = vals[0]
+          metrics["SSL/Global/Protocol/Client/SSLv3"]   = vals[1]
+          metrics["SSL/Global/Protocol/Client/TLSv1"]   = vals[2]
+          metrics["SSL/Global/Protocol/Client/TLSv1.1"] = vals[6]
+          metrics["SSL/Global/Protocol/Client/TLSv1.2"] = vals[7]
+          metrics["SSL/Global/Protocol/Server/SSLv2"]   = vals[3]
+          metrics["SSL/Global/Protocol/Server/SSLv3"]   = vals[4]
+          metrics["SSL/Global/Protocol/Server/TLSv1"]   = vals[5]
+          metrics["SSL/Global/Protocol/Server/TLSv1.1"] = vals[8]
+          metrics["SSL/Global/Protocol/Server/TLSv1.2"] = vals[9]
         end
 
         return metrics

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.19'
-  s.date              = '2016-03-15'
+  s.version           = '1.0.21'
+  s.date              = '2017-06-27'
   s.rubyforge_project = 'newrelic_f5_plugin'
   s.licenses          = ['MIT']
 

metadata

@@ -1,64 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: newrelic_f5_plugin
 version: !ruby/object:Gem::Version
-  version: 1.0.19
-  prerelease: 
+  version: 1.0.21
 platform: ruby
 authors:
 - Jonathan Thurman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-15 00:00:00.000000000 Z
+date: 2017-06-27 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: '1.3'
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.0
 - !ruby/object:Gem::Dependency
   name: snmp
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.1.0
-description: ! 'This is the New Relic plugin for monitoring F5 devices developed by
-  New Relic, Inc.
-
-'
+description: |
+  This is the New Relic plugin for monitoring F5 devices developed by New Relic, Inc.
 email: support@newrelic.com
 executables:
 - f5_monitor
@@ -97,29 +90,28 @@ files:
 homepage: http://newrelic.com
 licenses:
 - MIT
-post_install_message: ! "To get started with this plugin, create a working directory
+metadata: {}
+post_install_message: "To get started with this plugin, create a working directory
   and do \n  f5_monitor -h\nto find out how to install and run the plugin agent.\n"
 rdoc_options:
-- --charset=UTF-8
-- --main
+- "--charset=UTF-8"
+- "--main"
 - README.rdoc
 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: newrelic_f5_plugin
-rubygems_version: 1.8.23
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 2
 summary: New Relic F5 plugin