Find file History
Latest commit cd2cebd Jul 17, 2013 @maxtor maxtor Added logos

README.md

New Relic Haproxy monitoring Plugin

The New Relic Haproxy Plugin enables monitoring of HAProxy – a TCP/HTTP load balancer – and reports the following data for a specified proxy:

  • Error Rate (per-min)
  • Proxy Status
  • Request Rate (per-min)
  • Active Servers
  • Sessions Active
  • Sessions Queued

Requirements

The Haproxy monitoring Plugin for New Relic requires the following:

  • A New Relic account. Signup for a free account at http://newrelic.com
  • You need a host to install the plugin on that is able to poll the desired Haproxy server. That host also needs Ruby (tested with 1.8.7, 1.9.3), and support for rubygems.

Instructions for running the Haproxy agent

  1. Install this gem from RubyGems:

    sudo gem install newrelic_haproxy_agent

  2. Install config, execute

    sudo newrelic_haproxy_agent install - it will create /etc/newrelic/newrelic_haproxy_agent.yml file for you.

  3. Edit the /etc/newrelic/newrelic_haproxy_agent.yml file generated in step 2.

    3.1. replace YOUR_LICENSE_KEY_HERE with your New Relic license key. Your license key can be found under Account Settings at https://rpm.newrelic.com, see https://newrelic.com/docs/subscriptions/license-key for more help.

    3.2. add the URI of the haproxy CSV stats url

  4. Execute

    newrelic_haproxy_agent run

  5. Go back to the Plugins list and after a brief period you will see the Haproxy Plugin listed in your New Relic account

Keep this process running

You can use services like these to manage this process and run it as a daemon.

Also you can use foreman for daemonization.

Foreman can be useful if you want to use Heroku for run your agent. Just add Procfile and push to Heroku.

monitor_daemon: newrelic_haproxy_agent run -c config/newrelic_plugin.yml

Support

Please use Github issues for support.