jrogers512 / newrelic-disk-monitor-plugin

Monitor your hard drives in those cases NewRelic can't help you.

New Relic Disk Monitor Plugin

If you can't see the disk I/O utilization in New Relic it may be because you run your server in a OpenVZ container. New Relic does not support this because an OpenVZ container doesn't behave exactly like a real VM--it's a piece of a machine, not running its own full OS, and they don't have capability to monitor disk because OS-level stats are not accessible from the OpenVZ container.

This plugin allows you to monitor your server's disk usage in a OpenVZ container. It does not provide you with i/o information about reads and writes. The purpose of this plugin is to warn you when your disks are almost full.

Requirements

In order to use this plugin, you must have an active New Relic account.

Plugin should work on any generic Unix environment with the following software components installed:

• Ruby (>= 1.8.7)
• bundler for Ruby: https://github.com/carlhuda/bundler

Instructions for installing or upgrading the agent

1. cd /opt
2. git clone https://github.com/Happyr/NewRelic-Disk-Monitor-plugin.git
3. Run cd /opt/NewRelic-Disk-Monitor-plugin
4. Run bundle install to install required gems
5. Edit config/newrelic_plugin.yml and replace "YOUR_LICENSE_KEY_HERE" with your New Relic license key
6. Copy the init file for your distribution e.g. sudo cp /opt/newrelic-disk-monitor/init.d/debian /etc/init.d/newrelic-disk-monitor
7. Give the init file the correct permissions with sudo chmod +x /etc/init.d/newrelic-disk-monitor
8. Start the plugin by running sudo /etc/init.d/newrelic-disk-monitor start

Troubleshoot

1. Make sure you get a representable response from hostname -f.
2. Make sure to update the init file or /etc/default/newrelic-disk-monitor with a proper path to the repository clone.
3. For some init.d scripts make sure that the newrelic user has a shell - usermod -s /bin/sh newrelic.
4. Check if the plugin has started with ps aux | grep newrelic-disk-monitor. If you don't find any running process (except from the ´pscommand) you may remove the pid file.sudo rm /var/run/newrelic-disk-monitor.pid`.