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

Interface Statistics

Virtual Server Statistics

Pool Statistics

iRule Statistics

Global SSL Statistics

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, 1.9.3, and 2.0.0), and support for rubygems.

F5

This plugin has been tested with F5 LTM versions 11.2.x, 11.3.x, and 11.5.1. 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 version 2c is supported.

Installation and Running

  1. Install this gem from RubyGems:

    gem install newrelic_f5_plugin
    
  2. Create an installation directory (like /opt/newrelic/f5 ).

  3. In the installation directory, execute

    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 3. Setup name/hostname/port/snmp_community for each F5 you wish to monitor.

  5. Execute

    f5_monitor run
    

Additional Configuration

To configure proxy settings, add to the newrelic_plugin.yml file:

newrelic:
  proxy:
    address: PROXY_ADDRESS
    port: PROXY_PORT
    user: PROXY_USER
    password: PROXY_PASSWORD

Installation with Chef/Puppet

The F5 plugin can also be installed with Chef and Puppet. For Chef and Puppet support see the New Relic plugin's Chef Cookbook and Puppet Module.

Additional information on using Chef and Puppet with New Relic is available in New Relic's documentation.

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

  2. Install bundler and run:

    bundle install
    
  3. Run rake -T to see rake options, including tests.

Contributing

You are welcome to send pull requests to us - however, by doing so you agree that you are granting New Relic a non-exclusive, non-revokable, no-cost license to use the code, algorithms, patents, and ideas in that code in our products if we so choose. You also agree the code is provided as-is and you provide no warranties as to its fitness or correctness for any purpose.