newrelic_f5_plugin 1.0.0

data/CHANGES

@@ -0,0 +1,35 @@
+* 1.0.0
+  - Updated version for release!
+
+* 0.0.8
+  - Updated to require newrelic_platform.gem > 0.2.10
+  - Added a total throughput metric
+
+* 0.0.7
+  - Initial reporting of Nodes (Monitor Status)
+  - Include a Total throughput summary metric
+
+* 0.0.6
+  - Change the GUID to match the standard naming scheme
+  - Added a summary metric for CPU usage
+  - Added summary metrics for SSL
+  - Added HTTP Compression metrics
+
+* 0.0.5
+  - Changed bytes to bits on throughput metrics
+
+* 0.0.4
+  - Added SSL metric collection
+  - Changed CPU to be a percentage of 100 by asking how many CPUs the device has
+
+* 0.0.3
+  - Added more HTTP metrics
+  - Added default port so you don't have to specify it in the yaml
+  - Refactored much of the agent implementation to make if more modular
+
+* 0.0.2
+  - Added Global CPU Metrics
+
+* 0.0.1
+  - In Dev
+

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+# This gemfile is used in the context of development on this plugin agent.
+
+gem 'newrelic_plugin', :git => 'git@github.com:newrelic-platform/newrelic_plugin.git', :branch => 'release'
+gem "snmp"
+gem "rake", ">0.9.2"
+gem 'test-unit'
+gem "shoulda"
+gem "mocha"
+gem "rdoc", ">2.4.2"
+

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License
+
+Copyright (c) 2013 New Relic, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+

data/NOTES

@@ -0,0 +1,30 @@
+F5 MIB Tree Overview
+-----------------------------------
+1.3.6.1.4.1       Enterprises
++-3375            F5
+  +-2             bigipTrafficMgmt
+    +-1           bigipSystem
+      +-1         sysGlobals
+      | +-2       sysGlobalStats
+      | | +-1     sysGlobalStat
+      | | | +-38  sysStatCpuCount
+      | | +-4     sysGlobalHttpStat
+      | | +-12    sysGlobalTcpStat
+      | | +-20    sysGlobalHost
+      | | | +-4   sysGlobalHostCpuCount
+      | | +-22    sysGlobalHttpCompressionStat
+      | |   +-2   sysHttpCompressionStatPrecompressBytes
+      | 2         sysNetwork
+      | +-4       sysInterfaces
+      | 3         sysPlatform
+      | +-2       sysChassis
+      | +-6       sysSystem
+      | 4         sysProduct
+      2           bigipLocalTM
+      +-1         ltmGlobals
+      +-4         ltmNodes
+      +-5         ltmPools
+      +-6         ltmProfiles
+      +-8         ltmRules
+      +-10        ltmVirtualServers
+

data/README.rdoc

@@ -0,0 +1,53 @@
+= New Relic F5 Plugin
+
+The New Relic F5 Plugin enables integrated monitoring of your F5 Local Traffic
+Manager devices inside of New Relic.  Currently the following metrics are recorded:
+
+Device wide Metrics
+* CPU / Memory usage
+* Throughput (Total, Client side, Server side)
+* HTTP Requests (Requests/second, HTTP Methods, Status Codes, Versions)
+* HTTP Compression (Pre/Post broken down by content type)
+* SSL Requests/second
+* TCP Details (Current connections, connection rate, Server/Client side, Wait State)
+* Node status
+
+
+== Requirements
+
+=== Proxy host
+
+You need a host to install the plugin on that is able to poll the desired F5s via SNMP. That
+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
+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.
+
+
+== Instructions for running the F5 plugin agent
+
+1. Install the +newrelic_plugin+ gem.
+2. Install this gem.
+3. Create an installation directory (like /opt/newrelic/f5 ).
+4. In the installation directory, execute
+
+      f5_monitor install -l LICENSE_KEY
+
+   using the license key from your New Relic account.
+5. Edit the +config/newrelic_plugin.yml+ file generated in step 4.  Setup name/hostname/port/snmp_community for each F5 you wish to monitor.
+6. Execute
+
+      f5_monitor run
+
+== Developer Instructions
+
+1. Fork/Clone the repository
+2. Install bundler and do +bundle install+
+3. Do <b><tt>rake -T</tt></b> to see rake options, including tests.
+

data/Rakefile

@@ -0,0 +1,155 @@
+require 'rubygems'
+require 'rake'
+require 'date'
+
+# https://raw.github.com/mojombo/rakegem
+
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  line = File.read("lib/#{name}.rb")[/^\s*VERSION\s*=\s*.*/]
+  line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+end
+
+def date
+  Date.today.to_s
+end
+
+def rubyforge_project
+  name
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
+end
+
+#############################################################################
+#
+# Standard tasks
+#
+#############################################################################
+
+task :default => :test
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+desc "Generate RCov test coverage and open in your browser"
+task :coverage do
+  require 'rcov'
+  sh "rm -fr coverage"
+  sh "rcov test/test_*.rb"
+  sh "open coverage/index.html"
+end
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "#{name} #{version}"
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('LICENSE')
+  rdoc.rdoc_files.include('CHANGES')
+  rdoc.main = "README.rdoc"
+end
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -I./lib -r ./lib/#{name}.rb"
+end
+
+#############################################################################
+#
+# Custom tasks (add your own tasks here)
+#
+#############################################################################
+
+
+
+#############################################################################
+#
+# Packaging tasks
+#
+#############################################################################
+
+desc "Create tag v#{version} and build and push #{gem_file} to Rubgems"
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
+  end
+  sh "git commit --allow-empty -a -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push origin v#{version}"
+  sh "gem push pkg/#{name}-#{version}.gem"
+end
+
+desc "Build #{gem_file} into the pkg directory"
+task :build => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+desc "Generate #{gemspec_file}"
+task :gemspec => :validate do
+  # read spec file and split out manifest section
+  spec = File.read(gemspec_file)
+  head, manifest, tail = spec.split("  # = MANIFEST =\n")
+
+  # replace name version and date
+  replace_header(head, :name)
+  replace_header(head, :version)
+  replace_header(head, :date)
+  #comment this out if your rubyforge_project has a different name
+  replace_header(head, :rubyforge_project)
+
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject { |file| file =~ /^\./ }.
+    reject { |file| file =~ /^(rdoc|pkg)/ }.
+    map { |file| "    #{file}" }.
+    join("\n")
+
+  # piece file back together and write
+  manifest = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
+  File.open(gemspec_file, 'w') { |io| io.write(spec) }
+  puts "Updated #{gemspec_file}"
+end
+
+desc "Validate #{gemspec_file}"
+task :validate do
+  libfiles = Dir['lib/*'] - ["lib/#{name}.rb", "lib/#{name}"]
+  unless libfiles.empty?
+    puts "Directory `lib` should only contain a `#{name}.rb` file and `#{name}` dir."
+    exit!
+  end
+  unless Dir['VERSION*'].empty?
+    puts "A `VERSION` file at root level violates Gem best practices."
+    exit!
+  end
+end

data/bin/f5_monitor

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift File.expand_path "../../lib", __FILE__
+require "newrelic_f5_plugin"
+require 'optparse'
+
+options = OptionParser.new do |opts|
+  opts.banner = <<-EOF
+Usage:
+  f5_monitor  ( run | install ) [options]
+EOF
+
+  opts.on("-v", "--verbose", "Run verbosely") do
+    NewRelic::Plugin::Config.config.newrelic['verbose'] = 1
+  end
+
+  opts.on("-l", "--license LICENSE_KEY", "Your NewRelic account License Key") do | license_key |
+    $license_key = license_key
+  end
+
+  opts.on("-c", "--config FILE", "Override the location of the newrelic_plugin.yml") do | filename |
+    if !File.exists? filename
+      puts "File not found: #{filename.inspect}"
+      exit 1
+    end
+    NewRelic::Plugin::Config.config_file = filename
+  end
+
+  opts.on("-h", "--help") do
+    puts opts
+    if File.basename($0) == File.basename(__FILE__)
+      exit 0
+    end
+  end
+
+end
+
+args = options.parse!(ARGV)
+
+if args.first == "run"
+  if $license_key
+    NewRelic::Plugin::Config.config.options['newrelic']['license_key'] = $license_key
+  end
+  NewRelic::F5Plugin.run
+elsif args.first == "install"
+  config_file = File.read(File.expand_path("../../config/newrelic_plugin.yml", __FILE__))
+  if $license_key
+    config_file.gsub!("YOUR_LICENSE_KEY_HERE", $license_key)
+  end
+  require 'fileutils'
+  FileUtils.mkdir_p "config"
+  File.open("config/newrelic_plugin.yml", "w") do | io |
+    io.write(config_file)
+  end
+  puts "Saved agent config file #{File.expand_path("config/newrelic_plugin.yml")}"
+else
+  puts options
+end
+

data/config/newrelic_plugin.yml

@@ -0,0 +1,38 @@
+#
+#
+# This is a sample newrelic_plugin.yml file. Please move this file
+# to the following location if it is not already there:
+#
+#     ./config/newrelic_plugin.yml
+#
+# Where the current directory is the directory where your main program resides and is your current
+# directory when you run the main program.
+#
+# Please make sure to update the license_key information with the license key for your New Relic
+# account.
+#
+#
+newrelic:
+  #
+  # Update with your New Relic account license key:
+  #
+  license_key: 'YOUR_LICENSE_KEY_HERE'
+  #
+  # Set to '1' for verbose output, remove for normal output.
+  # All output goes to stdout/stderr.
+  #
+  #verbose: 1
+
+
+#
+# Agent Configuration:
+#
+agents:
+  f5:
+    # Define one or more instances
+    -
+      name:           'My F5'
+      hostname:       'my-f5'
+      port:           161
+      snmp_community: 'public'
+

data/lib/newrelic_f5_plugin.rb

@@ -0,0 +1,8 @@
+require 'rubygems'
+require 'newrelic_f5_plugin/nodes'
+require 'newrelic_f5_plugin/agent'
+
+module NewRelic::F5Plugin
+  VERSION = '1.0.0'
+end
+

data/lib/newrelic_f5_plugin/agent.rb

@@ -0,0 +1,381 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'bundler/setup'
+require 'newrelic_plugin'
+require 'snmp'
+
+
+module NewRelic::F5Plugin
+
+  # Register and run the agent
+  def self.run
+    # Register this agent.
+    NewRelic::Plugin::Setup.install_agent :f5, self
+
+    # Launch the agent; this never returns.
+    NewRelic::Plugin::Run.setup_and_run
+  end
+
+
+  # Part of me wants to split this out into different devices using this OID:
+  #   1.3.6.1.4.1.3375.2.1.3.5.2.0 = STRING: "BIG-IP 3900" or
+  #   1.3.6.1.4.1.3375.2.1.3.5.1.0 = STRING: "C106"
+  # Especially since a 3900, 6900, Viprion won't respond exactly the same.
+  # To make it worse, versions of BIG-IP older than 11.2 might not implent all
+  # all of these OIDs.
+  #   Version: 1.3.6.1.4.1.3375.2.1.4.2.0
+  #     Build: 1.3.6.1.4.1.3375.2.1.4.3.0
+  class Agent < NewRelic::Plugin::Agent::Base
+    agent_guid    'com.newrelic.f5'
+    agent_version '1.0.0'
+    agent_config_options :hostname, :port, :snmp_community
+    agent_human_labels('F5') { "#{hostname}" }
+
+    #
+    # Required, but not used
+    #
+    def setup_metrics
+    end
+
+
+    #
+    # This is called on every polling cycle
+    #
+    def poll_cycle
+      # SNMP Stuff here
+      snmp = SNMP::Manager.new(:host => hostname, :port => port, :community => snmp_community)
+
+      report_global_cpu_metrics(snmp)
+      report_global_memory_metrics(snmp)
+      report_global_connection_metrics(snmp)
+      report_global_throughput_metrics(snmp)
+      report_global_http_metrics(snmp)
+      report_global_http_compression_metrics(snmp)
+      report_global_ssl_metrics(snmp)
+      report_global_tcp_metrics(snmp)
+
+      node_status = NewRelic::F5Plugin::Nodes.get_status(snmp)
+      node_status.each_key { |m|
+        report_metric m, node_status[m][:label], node_status[m][:count]
+      }
+
+      snmp.close
+    rescue => e
+      $stderr.puts "#{e}: #{e.backtrace.join("\n  ")}"
+    end
+
+
+    #
+    # You do not have to specify the SNMP port in the yaml if you don't want to.
+    #
+    def port
+      @port || 161
+    end
+
+
+    #
+    # Helper function to create and keep track of all the counters
+    #
+    def report_counter_metric(metric, type, value)
+      @processors ||= {}
+
+      if @processors[metric].nil?
+        @processors[metric] = NewRelic::Processor::EpochCounter.new
+      end
+
+      report_metric metric, type, @processors[metric].process(value)
+    end
+
+
+    #
+    # Gather CPU Related metrics and report them
+    #
+    def report_global_cpu_metrics(snmp)
+      # Create the OIDs if they do not exist
+      @oid_sysGlobalHostCpuUser1m    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.20.22.0")
+      @oid_sysGlobalHostCpuNice1m    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.20.23.0")
+      @oid_sysGlobalHostCpuSystem1m  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.20.24.0")
+      #@oid_sysGlobalHostCpuIdle1m    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.20.25.0") # Ignoring the idle time
+      @oid_sysGlobalHostCpuIrq1m     ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.20.26.0")
+      @oid_sysGlobalHostCpuSoftirq1m ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.20.27.0")
+      @oid_sysGlobalHostCpuIowait1m  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.20.28.0")
+      @oid_sysGlobalHostCpuCount     ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.20.4.0")
+
+      if snmp
+        res = snmp.get_value([@oid_sysGlobalHostCpuCount, @oid_sysGlobalHostCpuUser1m, @oid_sysGlobalHostCpuNice1m,
+                              @oid_sysGlobalHostCpuSystem1m, @oid_sysGlobalHostCpuIrq1m, @oid_sysGlobalHostCpuSoftirq1m,
+                              @oid_sysGlobalHostCpuIowait1m, ])
+
+        # In order to show the CPU usage as a total percentage, we divide by the number of cpus
+        cpu_count = res[0].to_i
+        vals = res[1..6].map { |i| i.to_f / cpu_count }
+        report_metric "CPU/Global/User",     "%", vals[0]
+        report_metric "CPU/Global/Nice",     "%", vals[1]
+        report_metric "CPU/Global/System",   "%", vals[2]
+        report_metric "CPU/Global/IRQ",      "%", vals[3]
+        report_metric "CPU/Global/Soft IRQ", "%", vals[4]
+        report_metric "CPU/Global/IO Wait",  "%", vals[5]
+
+        # Add it all up, and send a summary metric
+        report_metric "CPU/Total/Global", "%", vals.inject(0.0){ |a,b| a + b }
+      end
+    end
+
+
+    #
+    # Gather Memory related metrics and report them
+    #
+    def report_global_memory_metrics(snmp)
+      # Create the OIDs if they don't exist
+      @oid_sysStatMemoryUsed ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.45.0")
+      @oid_sysHostMemoryUsed ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.7.1.2.0")
+
+      if snmp
+        res = snmp.get_value([@oid_sysStatMemoryUsed, @oid_sysHostMemoryUsed])
+        report_metric "Memory/TMM",  "bytes", res[0]
+        report_metric "Memory/Host", "bytes", res[1]
+      end
+    end
+
+
+    #
+    # Gather Global connection related metrics and report them
+    #
+    def report_global_connection_metrics(snmp)
+      # Create the OIDs if they don't exist
+      @oid_sysStatClientCurConns    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.8.0")
+      @oid_sysStatServerCurConns    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.15.0")
+      @oid_sysStatClientTotConns    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.7.0")
+      @oid_sysStatServerTotConns    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.14.0")
+      #@oid_sysStatPvaClientCurConns ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.22.0")
+      #@oid_sysStatPvaServerCurConns ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.29.0")
+      # These should be moved to an SSL metric...
+      @oid_sysClientsslStatCurConns ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.9.2.0")
+      @oid_sysServersslStatCurConns ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.10.2.0")
+
+      if snmp
+        res = snmp.get_value([@oid_sysStatClientCurConns, @oid_sysStatServerCurConns, @oid_sysStatClientTotConns,
+                              @oid_sysStatServerTotConns, @oid_sysClientsslStatCurConns, @oid_sysServersslStatCurConns])
+        report_metric         "Connections/Current/Client",     "conn",     res[0]
+        report_metric         "Connections/Current/Server",     "conn",     res[1]
+        report_counter_metric "Connections/Rate/Client",        "conn/sec", res[2]
+        report_counter_metric "Connections/Rate/Server",        "conn/sec", res[3]
+        report_metric         "Connections/Current/Client SSL", "conn",     res[4]
+        report_metric         "Connections/Current/Server SSL", "conn",     res[5]
+      end
+    end
+
+
+    #
+    # Gather Global throughput related metrics and report them
+    #
+    def report_global_throughput_metrics(snmp)
+      # Create the OIDs if they don't exist
+      @oid_sysStatClientBytesIn  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.3.0")
+      @oid_sysStatClientBytesOut ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.5.0")
+      @oid_sysStatServerBytesIn  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.10.0")
+      @oid_sysStatServerBytesOut ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.1.12.0")
+
+      if snmp
+        res = snmp.get_value([@oid_sysStatClientBytesIn, @oid_sysStatClientBytesOut, @oid_sysStatServerBytesIn,
+                              @oid_sysStatServerBytesOut])
+
+        report_counter_metric "Throughput/Client/In",  "bits/sec", (res[0].to_f * 8)
+        report_counter_metric "Throughput/Client/Out", "bits/sec", (res[1].to_f * 8)
+        report_counter_metric "Throughput/Server/In",  "bits/sec", (res[2].to_f * 8)
+        report_counter_metric "Throughput/Server/Out", "bits/sec", (res[3].to_f * 8)
+        tot = 0
+        res.each { |x| tot += x.to_f }
+        report_counter_metric "Throughput/Total",      "bits/sec", (tot * 8)
+      end
+    end
+
+
+    #
+    # Gather Global HTTP related metrics and report them
+    #
+    def report_global_http_metrics(snmp)
+      # Create the OIDs if they don't exist
+      @oid_sysHttpStatResp2xxCnt    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.3.0")
+      @oid_sysHttpStatResp3xxCnt    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.4.0")
+      @oid_sysHttpStatResp4xxCnt    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.5.0")
+      @oid_sysHttpStatResp5xxCnt    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.6.0")
+      @oid_sysHttpStatNumberReqs    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.7.0")
+      @oid_sysHttpStatGetReqs       ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.8.0")
+      @oid_sysHttpStatPostReqs      ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.9.0")
+      @oid_sysHttpStatV9Reqs        ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.10.0")
+      @oid_sysHttpStatV10Reqs       ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.11.0")
+      @oid_sysHttpStatV11Reqs       ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.12.0")
+      @oid_sysHttpStatV9Resp        ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.13.0")
+      @oid_sysHttpStatV10Resp       ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.14.0")
+      @oid_sysHttpStatV11Resp       ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.15.0")
+      @oid_sysHttpStatRespBucket1k  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.17.0")
+      @oid_sysHttpStatRespBucket4k  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.18.0")
+      @oid_sysHttpStatRespBucket16k ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.19.0")
+      @oid_sysHttpStatRespBucket32k ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.4.20.0")
+
+      if snmp
+        res = snmp.get_value([@oid_sysHttpStatResp2xxCnt,    @oid_sysHttpStatResp3xxCnt,    @oid_sysHttpStatResp4xxCnt,
+                              @oid_sysHttpStatResp5xxCnt,    @oid_sysHttpStatNumberReqs,    @oid_sysHttpStatGetReqs,
+                              @oid_sysHttpStatPostReqs,      @oid_sysHttpStatV9Reqs,        @oid_sysHttpStatV10Reqs,
+                              @oid_sysHttpStatV11Reqs,       @oid_sysHttpStatV9Resp,        @oid_sysHttpStatV10Resp,
+                              @oid_sysHttpStatV11Resp,       @oid_sysHttpStatRespBucket1k,  @oid_sysHttpStatRespBucket4k,
+                              @oid_sysHttpStatRespBucket16k, @oid_sysHttpStatRespBucket32k, ])
+
+        report_counter_metric "HTTP/Response Code/2xx", "resp/sec", res[0]
+        report_counter_metric "HTTP/Response Code/3xx", "resp/sec", res[1]
+        report_counter_metric "HTTP/Response Code/4xx", "resp/sec", res[2]
+        report_counter_metric "HTTP/Response Code/5xx", "resp/sec", res[3]
+
+        report_counter_metric "HTTP/Method/All",            "req/sec",  res[4]
+        report_counter_metric "HTTP/Method/Get",            "req/sec",  res[5]
+        report_counter_metric "HTTP/Method/Post",           "req/sec",  res[6]
+        report_counter_metric "HTTP/Version/v0.9/Request",  "req/sec",  res[7]
+        report_counter_metric "HTTP/Version/v1.0/Request",  "req/sec",  res[8]
+        report_counter_metric "HTTP/Version/v1.1/Request",  "req/sec",  res[9]
+        report_counter_metric "HTTP/Version/v0.9/Response", "resp/sec", res[10]
+        report_counter_metric "HTTP/Version/v1.0/Response", "resp/sec", res[11]
+        report_counter_metric "HTTP/Version/v1.1/Response", "resp/sec", res[12]
+
+        report_counter_metric "HTTP/Response Size/1k Bucket",  "resp/sec", res[13]
+        report_counter_metric "HTTP/Response Size/4k Bucket",  "resp/sec", res[14]
+        report_counter_metric "HTTP/Response Size/16k Bucket", "resp/sec", res[15]
+        report_counter_metric "HTTP/Response Size/32k Bucket", "resp/sec", res[16]
+      end
+    end
+
+
+    #
+    # HTTP Compression Stats
+    #
+    def report_global_http_compression_metrics(snmp)
+      @oid_sysHttpCompressionStatPrecompressBytes       ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.2.0")
+      @oid_sysHttpCompressionStatPostcompressBytes      ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.3.0")
+      @oid_sysHttpCompressionStatHtmlPrecompressBytes   ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.5.0")
+      @oid_sysHttpCompressionStatHtmlPostcompressBytes  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.6.0")
+      @oid_sysHttpCompressionStatCssPrecompressBytes    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.7.0")
+      @oid_sysHttpCompressionStatCssPostcompressBytes   ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.8.0")
+      @oid_sysHttpCompressionStatJsPrecompressBytes     ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.9.0")
+      @oid_sysHttpCompressionStatJsPostcompressBytes    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.10.0")
+      @oid_sysHttpCompressionStatXmlPrecompressBytes    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.11.0")
+      @oid_sysHttpCompressionStatXmlPostcompressBytes   ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.12.0")
+      @oid_sysHttpCompressionStatSgmlPrecompressBytes   ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.13.0")
+      @oid_sysHttpCompressionStatSgmlPostcompressBytes  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.14.0")
+      @oid_sysHttpCompressionStatPlainPrecompressBytes  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.15.0")
+      @oid_sysHttpCompressionStatPlainPostcompressBytes ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.16.0")
+      @oid_sysHttpCompressionStatOctetPrecompressBytes  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.17.0")
+      @oid_sysHttpCompressionStatOctetPostcompressBytes ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.18.0")
+      @oid_sysHttpCompressionStatImagePrecompressBytes  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.19.0")
+      @oid_sysHttpCompressionStatImagePostcompressBytes ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.20.0")
+      @oid_sysHttpCompressionStatVideoPrecompressBytes  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.21.0")
+      @oid_sysHttpCompressionStatVideoPostcompressBytes ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.22.0")
+      @oid_sysHttpCompressionStatAudioPrecompressBytes  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.23.0")
+      @oid_sysHttpCompressionStatAudioPostcompressBytes ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.24.0")
+      @oid_sysHttpCompressionStatOtherPrecompressBytes  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.25.0")
+      @oid_sysHttpCompressionStatOtherPostcompressBytes ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.22.26.0")
+
+      if snmp
+        res = snmp.get_value([@oid_sysHttpCompressionStatPrecompressBytes, @oid_sysHttpCompressionStatPostcompressBytes,
+                              @oid_sysHttpCompressionStatHtmlPrecompressBytes, @oid_sysHttpCompressionStatHtmlPostcompressBytes,
+                              @oid_sysHttpCompressionStatCssPrecompressBytes, @oid_sysHttpCompressionStatCssPostcompressBytes,
+                              @oid_sysHttpCompressionStatJsPrecompressBytes, @oid_sysHttpCompressionStatJsPostcompressBytes,
+                              @oid_sysHttpCompressionStatXmlPrecompressBytes, @oid_sysHttpCompressionStatXmlPostcompressBytes,
+                              @oid_sysHttpCompressionStatSgmlPrecompressBytes, @oid_sysHttpCompressionStatSgmlPostcompressBytes,
+                              @oid_sysHttpCompressionStatPlainPrecompressBytes, @oid_sysHttpCompressionStatPlainPostcompressBytes,
+                              @oid_sysHttpCompressionStatOctetPrecompressBytes, @oid_sysHttpCompressionStatOctetPostcompressBytes,
+                              @oid_sysHttpCompressionStatImagePrecompressBytes, @oid_sysHttpCompressionStatImagePostcompressBytes,
+                              @oid_sysHttpCompressionStatVideoPrecompressBytes, @oid_sysHttpCompressionStatVideoPostcompressBytes,
+                              @oid_sysHttpCompressionStatAudioPrecompressBytes, @oid_sysHttpCompressionStatAudioPostcompressBytes,
+                              @oid_sysHttpCompressionStatOtherPrecompressBytes, @oid_sysHttpCompressionStatOtherPostcompressBytes, ])
+
+        vals = res.map { |i| i.to_f * 8 } # Convert to bits
+        report_counter_metric "HTTP/Compression/Total/Pre",       "bits/sec",  vals[0]
+        report_counter_metric "HTTP/Compression/Total/Post",      "bits/sec",  vals[1]
+        report_counter_metric "HTTP/Compression/HTML/Pre",        "bits/sec",  vals[2]
+        report_counter_metric "HTTP/Compression/HTML/Post",       "bits/sec",  vals[3]
+        report_counter_metric "HTTP/Compression/CSS/Pre",         "bits/sec",  vals[4]
+        report_counter_metric "HTTP/Compression/CSS/Post",        "bits/sec",  vals[5]
+        report_counter_metric "HTTP/Compression/Javascript/Pre",  "bits/sec",  vals[6]
+        report_counter_metric "HTTP/Compression/Javascript/Post", "bits/sec",  vals[7]
+        report_counter_metric "HTTP/Compression/XML/Pre",         "bits/sec",  vals[8]
+        report_counter_metric "HTTP/Compression/XML/Post",        "bits/sec",  vals[9]
+        report_counter_metric "HTTP/Compression/SGML/Pre",        "bits/sec",  vals[10]
+        report_counter_metric "HTTP/Compression/SGML/Post",       "bits/sec",  vals[11]
+        report_counter_metric "HTTP/Compression/Plain/Pre",       "bits/sec",  vals[12]
+        report_counter_metric "HTTP/Compression/Plain/Post",      "bits/sec",  vals[13]
+        report_counter_metric "HTTP/Compression/Octet/Pre",       "bits/sec",  vals[14]
+        report_counter_metric "HTTP/Compression/Octet/Post",      "bits/sec",  vals[15]
+        report_counter_metric "HTTP/Compression/Image/Pre",       "bits/sec",  vals[16]
+        report_counter_metric "HTTP/Compression/Image/Post",      "bits/sec",  vals[17]
+        report_counter_metric "HTTP/Compression/Video/Pre",       "bits/sec",  vals[18]
+        report_counter_metric "HTTP/Compression/Video/Post",      "bits/sec",  vals[19]
+        report_counter_metric "HTTP/Compression/Audio/Pre",       "bits/sec",  vals[20]
+        report_counter_metric "HTTP/Compression/Audio/Post",      "bits/sec",  vals[21]
+        report_counter_metric "HTTP/Compression/Other/Pre",       "bits/sec",  vals[22]
+        report_counter_metric "HTTP/Compression/Other/Post",      "bits/sec",  vals[23]
+      end
+    end
+
+    #
+    # SSL Stats
+    #
+    def report_global_ssl_metrics(snmp)
+      @oid_sysClientsslStatTotNativeConns ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.9.6.0")
+      @oid_sysClientsslStatTotCompatConns ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.9.9.0")
+      @oid_sysServersslStatTotNativeConns ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.10.6.0")
+      @oid_sysServersslStatTotCompatConns ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.10.9.0")
+
+      if snmp
+        res = snmp.get_value([@oid_sysClientsslStatTotNativeConns, @oid_sysClientsslStatTotCompatConns, @oid_sysServersslStatTotNativeConns,
+                              @oid_sysServersslStatTotCompatConns])
+        vals = res.map { |i| i.to_i }
+        report_counter_metric "SSL/Global/Client/Native", "trans/sec", vals[0]
+        report_counter_metric "SSL/Global/Client/Compat", "trans/sec", vals[1]
+        report_counter_metric "SSL/Global/Server/Native", "trans/sec", vals[2]
+        report_counter_metric "SSL/Global/Server/Compat", "trans/sec", vals[3]
+        report_counter_metric "SSL/Global/Total/Client",  "trans/sec", (vals[0] + vals[1])
+        report_counter_metric "SSL/Global/Total/Server",  "trans/sec", (vals[2] + vals[3])
+        report_counter_metric "SSL/Global/Total/All",     "trans/sec", vals.inject(0) { |t,i| t + i }
+      end
+    end
+
+
+    #
+    # Gather TCP Statistics and report them
+    #
+    def report_global_tcp_metrics(snmp)
+      # Create the OIDs if they don't exist
+      @oid_sysTcpStatOpen      ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.2.0")  # "The number of current open connections."
+      @oid_sysTcpStatCloseWait ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.3.0")  # "The number of current connections in CLOSE-WAIT/LAST-ACK."
+      @oid_sysTcpStatFinWait   ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.4.0")  # "The number of current connections in FIN-WAIT/CLOSING."
+      @oid_sysTcpStatTimeWait  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.5.0")  # "The number of current connections in TIME-WAIT."
+      @oid_sysTcpStatAccepts   ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.6.0")  # "The number of connections accepted."
+      # @oid_sysTcpStatAcceptfails  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.7.0")   # "The number of connections not accepted."
+      # @oid_sysTcpStatConnects     ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.8.0")   # "The number of connections established."
+      # @oid_sysTcpStatConnfails    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.9.0")   # "The number of connection failures."
+      # @oid_sysTcpStatExpires      ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.10.0")  # "The number of connections expired due to idle timeout."
+      # @oid_sysTcpStatAbandons     ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.11.0")  # "The number of connections abandoned connections due to retries/keep-alives."
+      # @oid_sysTcpStatRxrst        ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.12.0")  # "The number of received RST."
+      # @oid_sysTcpStatRxbadsum     ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.13.0")  # "The number of bad checksum."
+      # @oid_sysTcpStatRxbadseg     ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.14.0")  # "The number of malformed segments."
+      # @oid_sysTcpStatRxooseg      ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.15.0")  # "The number of out of order segments."
+      # @oid_sysTcpStatRxcookie     ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.16.0")  # "The number of received SYN-cookies."
+      # @oid_sysTcpStatRxbadcookie  ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.17.0")  # "The number of bad SYN-cookies."
+      # @oid_sysTcpStatSyncacheover ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.18.0")  # "The number of SYN-cache overflow."
+      # @oid_sysTcpStatTxrexmits    ||= SNMP::ObjectId.new("1.3.6.1.4.1.3375.2.1.1.2.12.19.0")  # "The number of retransmitted segments."
+      if snmp
+        res = snmp.get_value([@oid_sysTcpStatOpen, @oid_sysTcpStatCloseWait, @oid_sysTcpStatFinWait,
+                              @oid_sysTcpStatTimeWait, @oid_sysTcpStatAccepts, ])
+
+        report_metric         "TCP/Connection State/Open",       "conn",     res[0]
+        report_metric         "TCP/Connection State/Wait/Close", "conn",     res[1]
+        report_metric         "TCP/Connection State/Wait/FIN",   "conn",     res[2]
+        report_metric         "TCP/Connection State/Wait/TIME",  "conn",     res[3]
+        report_counter_metric "TCP/Accepts",                     "conn/sec", res[4]
+      end
+    end
+
+  end
+end
+

data/lib/newrelic_f5_plugin/nodes.rb

@@ -0,0 +1,61 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'bundler/setup'
+require 'newrelic_plugin'
+require 'snmp'
+
+
+module NewRelic
+  module F5Plugin
+
+    module Nodes
+      NODE_MONITOR_STATES = {
+        0  => 'unchecked',
+        1  => 'checking',
+        2  => 'inband',
+        3  => 'forced-up',
+        4  => 'up',
+        19 => 'down',
+        20 => 'forced-down',
+        21 => 'maint',
+        22 => 'irule-down',
+        23 => 'inband-down',
+        24 => 'down-manual-resume',
+        25 => 'disabled',
+      }
+
+      #
+      # Node Naming in SNMP
+      #
+      # vb.name = SNMPv2-SMI::enterprises.3375.2.2.4.1.2.1.7.{name length}.{name in dot seperated ASCII code} (because why not...)
+      #tmp_name = vb.name.to_s.gsub(/SNMPv2-SMI::enterprises\.3375\.2\.2\.4\.1\.2\.1\.7\.\d+\./, '').split('.').collect! { |c| c.to_i.chr }  # Create an array of the ASCII chars of the node name
+      #name = tmp_name.join
+
+      #
+      # Gather Node Status and report
+      #
+      def self.get_status(snmp)
+        if snmp
+          # Init all the states with zeros so we always get them
+          base_name = "Nodes/Monitor Status"
+          metrics = { }
+          NODE_MONITOR_STATES.each do |key,value|
+            metrics["#{base_name}/#{value}"] = { :label => "nodes", :count => 0 }
+          end
+
+          # ltmNodeAddrMonitorStatus
+          snmp.walk(["1.3.6.1.4.1.3375.2.2.4.1.2.1.7"]) do |row|
+            row.each do |vb|
+              metric_name = "#{base_name}/#{NODE_MONITOR_STATES[vb.value.to_i]}"
+              metrics[metric_name][:count]  += 1
+            end
+          end
+
+          return metrics
+        end
+      end
+    end
+  end
+end
+

data/newrelic_f5_plugin.gemspec

@@ -0,0 +1,89 @@
+## This is the rakegem gemspec template. Make sure you read and understand
+## all of the comments. Some sections require modification, and others can
+## be deleted if you don't need them. Once you understand the contents of
+## this file, feel free to delete any comments that begin with two hash marks.
+## You can find comprehensive Gem::Specification documentation, at
+## http://docs.rubygems.org/read/chapter/20
+Gem::Specification.new do |s|
+  s.specification_version = 2 if s.respond_to? :specification_version=
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.rubygems_version = '1.3.5'
+
+  ## Leave these as is they will be modified for you by the rake gemspec task.
+  ## 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.0'
+  s.date              = '2013-06-18'
+  s.rubyforge_project = 'newrelic_f5_plugin'
+
+  ## Make sure your summary is short. The description may be as long
+  ## as you like.
+  s.summary     = "New Relic F5 plugin"
+  s.description = <<-EOF
+This is the New Relic plugin for monitoring F5 devices developed by New Relic, Inc.
+  EOF
+
+  ## List the primary authors. If there are a bunch of authors, it's probably
+  ## better to set the email to an email list or something. If you don't have
+  ## a custom homepage, consider using your GitHub URL or the like.
+  s.authors  = ["Jonathan Thurman"]
+  s.email    = 'support@newrelic.com'
+  s.homepage = 'http://newrelic.com'
+
+  ## This gets added to the $LOAD_PATH so that 'lib/NAME.rb' can be required as
+  ## require 'NAME.rb' or'/lib/NAME/file.rb' can be as require 'NAME/file.rb'
+  s.require_paths = %w[lib]
+
+  ## This sections is only necessary if you have C extensions.
+  # s.require_paths << 'ext'
+  # s.extensions = %w[ext/extconf.rb]
+
+  ## If your gem includes any executables, list them here.
+  s.executables = ["f5_monitor"]
+
+  ## Specify any RDoc options here. You'll want to add your README and
+  ## LICENSE files to the extra_rdoc_files list.
+  s.rdoc_options = ["--charset=UTF-8",
+                    "--main", "README.rdoc"]
+  s.extra_rdoc_files = %w[README.rdoc LICENSE CHANGES]
+
+  ## 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('snmp', ">= 1.1.0")
+
+  s.post_install_message = <<-EOF
+To get started with this plugin, create a working directory and do 
+  f5_monitor -h
+to find out how to install and run the plugin agent.
+  EOF
+
+  ## Leave this section as-is. It will be automatically generated from the
+  ## contents of your Git repository via the gemspec task. DO NOT REMOVE
+  ## THE MANIFEST COMMENTS, they are used as delimiters by the task.
+  # = MANIFEST =
+  s.files = %w[
+    CHANGES
+    Gemfile
+    LICENSE
+    NOTES
+    README.rdoc
+    Rakefile
+    bin/f5_monitor
+    config/newrelic_plugin.yml
+    lib/newrelic_f5_plugin.rb
+    lib/newrelic_f5_plugin/agent.rb
+    lib/newrelic_f5_plugin/nodes.rb
+    newrelic_f5_plugin.gemspec
+    test/f5_monitor_test.rb
+    test/plugin_test.rb
+    test/test_helper.rb
+  ]
+  # = MANIFEST =
+
+  ## Test files will be grabbed from the file list. Make sure the path glob
+  ## matches what you actually use.
+  s.test_files = s.files.select { |path| path =~ /^test\/test_.*\.rb/ }
+end

data/test/f5_monitor_test.rb

@@ -0,0 +1,35 @@
+require 'test_helper.rb'
+class F5MonitorTest < Test::Unit::TestCase
+
+  context "f5_monitor" do
+
+    setup do
+      @verbose = $VERBOSE
+      $VERBOSE = nil
+      @file = File.expand_path("../../bin/f5_monitor", __FILE__)
+    end
+
+    teardown do
+      $VERBOSE = @verbose
+    end
+
+    should "show help" do
+      `#{@file} -h` =~ /Usage:/
+    end
+
+    should "run" do
+      ::ARGV = %w[run]
+      NewRelic::F5Plugin.expects :run
+      load @file
+    end
+
+    should "install" do
+      ::ARGV = %w[install --license LICENSE_KEY]
+      FileUtils.expects :mkdir_p
+      File.expects :open
+      load @file
+    end
+  end
+
+end
+

data/test/plugin_test.rb

@@ -0,0 +1,79 @@
+require 'test_helper.rb'
+class PluginTest < Test::Unit::TestCase
+
+  context "Plugin" do
+
+    setup do
+      NewRelic::F5Plugin
+      NewRelic::Plugin::Config.config_yaml = <<-EOF
+newrelic:
+  license_key: 'test_license_key'
+  verbose: 0
+  host: "localhost"
+agents:
+  f5:
+    -
+      name:           'My F5 LTM'
+      hostname:       'my-f5'
+      port:           161
+      snmp_community: 'public'
+      EOF
+      NewRelic::Plugin::Setup.install_agent :f5, NewRelic::F5Plugin
+    end
+
+    should "create a run" do
+      # The run loop is stubbed out so this just verifies the agent initializes correctly.
+      NewRelic::Plugin::Run.any_instance.expects :setup_from_config
+      NewRelic::Plugin::Run.any_instance.expects :loop_forever
+      NewRelic::F5Plugin.run
+    end
+
+    # This mimics NewRelic::Plugin::Run.setup_and_run except for the loop_forever part
+    context "run" do
+      setup do
+        NewRelic::Plugin::Run.any_instance.stubs :loop_forever
+        @run = NewRelic::Plugin::Run.new
+        @run.setup_from_config
+        agents = @run.configured_agents
+        assert_equal 1, agents.size
+        @agent = agents.first
+      end
+
+      should "have one configured agent" do
+        assert_equal "My F5 LTM", @agent.name
+      end
+
+      #context "test db" do
+      #  setup do
+      #    # Setup a test database
+      #    @client = Mysql2::Client.new :host => 'localhost', :username => 'root'
+      #    @client.query "create database nr_mysql_plugin" rescue nil
+      #    @client.query "create table nr_mysql_plugin.example (id int)"
+      #    @client.query "create table nr_mysql_plugin.ignored (id int)"
+      #    @client.query "insert into nr_mysql_plugin.example values (1),(2),(3),(4),(5)"
+      #  end
+      #  teardown do
+      #    @client.query "drop database nr_mysql_plugin" rescue nil
+      #  end
+      #  should "get table stats" do
+      #    schemas = @agent.mysql_table_stats
+      #    assert_equal 1, schemas.size
+      #    tables = schemas['nr_mysql_plugin']
+      #    assert_equal 1, tables.size
+      #    rec = tables.first
+      #    assert_equal "example", rec.name
+      #    assert_equal 5, rec.rows
+      #  end
+      #  should "poll" do
+      #    # This stubs out the remote connection--we're not testing the plugin agent here
+      #    NewRelic::Plugin::DataCollector.any_instance.stubs :process
+      #    @agent.run 60 # seconds
+      #  end
+      #end
+
+    end
+
+  end
+
+end
+

data/test/test_helper.rb

@@ -0,0 +1,6 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'newrelic_f5_plugin'
+require 'test-unit'
+require 'shoulda'
+require 'mocha/setup'
+

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: newrelic_f5_plugin
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Jonathan Thurman
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-18 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
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.2.11
+- !ruby/object:Gem::Dependency
+  name: snmp
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !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.0
+description: ! 'This is the New Relic plugin for monitoring F5 devices developed by
+  New Relic, Inc.
+
+'
+email: support@newrelic.com
+executables:
+- f5_monitor
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+- LICENSE
+- CHANGES
+files:
+- CHANGES
+- Gemfile
+- LICENSE
+- NOTES
+- README.rdoc
+- Rakefile
+- bin/f5_monitor
+- config/newrelic_plugin.yml
+- lib/newrelic_f5_plugin.rb
+- lib/newrelic_f5_plugin/agent.rb
+- lib/newrelic_f5_plugin/nodes.rb
+- newrelic_f5_plugin.gemspec
+- test/f5_monitor_test.rb
+- test/plugin_test.rb
+- test/test_helper.rb
+homepage: http://newrelic.com
+licenses: []
+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
+- 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
+signing_key: 
+specification_version: 2
+summary: New Relic F5 plugin
+test_files:
+- test/test_helper.rb