pyr / check-graphite

nagios check for graphite metrics

check_graphite is a nagios module to query graphite

Example

check_graphite -H 'http://my.graphite.host

check_graphite -H "http://your.graphite.host/render" -M collectd.somebox.load.load.midterm -w 1 -c 2 -N load WARNING|load=1.4400000000000002;;;;

check_graphite accepts the following options:

• -H or --endpoint: the graphite HTTP endpoint which can be queried
• -M or --metric: the metric expression which will be queried, it can be an expression
• -F or --from: time frame for which to query metrics, defaults to "30seconds"
• -N or --name: name to give to the metric, defaults to "value"
• -U or --username: username used for basic authentication
• -P or --password: password used for basic authentication
• -w: warning threshold for the metric
• -c: critical threshold for the metric
• -t: timeout after which the metric should be considered unknown
• --ignore-missing: return OK when the metric doesn't exist yet e.g. errors have not occurred

How it works

check_graphite, asks for a small window of metrics, and computes an average over the last valid points collected, it then checks the value against supplied thresholds. Thresholds are expressed in the format given in The Nagios Developer Guidelines.

NaN values are not taken into account in the average

check-graphite's Issues

Syntax Error

I installed it using sudo gen install check_graphite, but when I try and run the command I get the following syntax error:

/usr/lib/ruby/vendor_ruby/1.8/rubygems/custom_require.rb:36:in `gem_original_require': /var/lib/gems/1.8/gems/nagios_check-0.3.0/lib/nagios_check/range.rb:23: syntax error, unexpected kNOT (SyntaxError)
      @inverse ? not(result) : result
                    ^
/var/lib/gems/1.8/gems/nagios_check-0.3.0/lib/nagios_check/range.rb:23: syntax error, unexpected ':', expecting kEND
      @inverse ? not(result) : result
                              ^
    from /usr/lib/ruby/vendor_ruby/1.8/rubygems/custom_require.rb:36:in `require'
    from /var/lib/gems/1.8/gems/nagios_check-0.3.0/lib/nagios_check.rb:6
    from /usr/lib/ruby/vendor_ruby/1.8/rubygems/custom_require.rb:36:in `gem_original_require'
    from /usr/lib/ruby/vendor_ruby/1.8/rubygems/custom_require.rb:36:in `require'
    from /var/lib/gems/1.8/gems/check_graphite-0.2.5/lib/check_graphite.rb:1
    from /usr/lib/ruby/vendor_ruby/1.8/rubygems/custom_require.rb:36:in `gem_original_require'
    from /usr/lib/ruby/vendor_ruby/1.8/rubygems/custom_require.rb:36:in `require'
    from /var/lib/gems/1.8/gems/check_graphite-0.2.5/bin/check_graphite:3
    from /usr/local/bin/check_graphite:19:in `load'
    from /usr/local/bin/check_graphite:19

I don't know ruby very well, how do I go about fixing this?

Add an option to ignore when metrics don't exist (yet)

Nagios shows UNKNOWN when no data is returned for the target metrics, however this could be OK if, for example, an exception hasn't yet been raised and the metric doesn't exist yet in Graphite.

How about an option to the script, e.g. --ignore-missing, which will make it return 0 exit status in the event that no data is returned (no news is good news)?

INTERNAL ERROR: EOFError: end of file reached

We are seeing this error from this plugin intermittently. The graphite shows data being plotted however the plugin fails with this exit code. Any pointers how to troubleshoot this?

INTERNAL ERROR: EOFError: end of file reached

The drop* options aren't explained in the Readme

The script has the options:

-A, --dropfirst N
-Z, --droplast N

These aren't explained in the project README.md file. I would open a pull request but I'm not sure what they do...

trying to test

./bin/check_graphite 
/usr/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require': cannot load such file -- check_graphite (LoadError)
    from /usr/lib/ruby/1.9.1/rubygems/custom_require.rb:36:in `require'
    from ./bin/check_graphite:3:in `<main>'

is that ok?

Missing License information

can you please add License information in Readme or repo