Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Ruby Nagios Check Integration

tag: v0.0.3

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.md

NagiosCheck

Description

NagiosCheck is a simple and efficient tool for building custom probes for the Nagios monitoring system. It alleviates the pain of parsing command line options, writing and formatting the check results according to the Nagios plugin API.

Installation

gem install nagios_check

Features

  • Provide a simple to use DSL for building your own probes.
  • Parse command line options.
  • Report status data to Nagios (handles exceptions as UNKNOWN status).
  • Provide a Nagios like range description format for the WARNING and CRITICAL states.
  • Provide a simple timeout functionality to be more Nagios friendly.
  • Report performance data to Nagios.

Usage and documentation

NagiosCheck is a module. To use it simply include it in a class and declare how the check should behave:

require "nagios_check"

class SimpleCheck
  include NagiosCheck

  on "-H HOST", :mandatory, &store(:host)
  on "-P PORT",            &store(:port, default: 8080, transform: :to_i)

  enable_warning
  enable_critical
  enable_timeout

  def check
    time = do_some_check(options.host, options.port)
    store_value :duration, time
  end
end

SimpleCheck.new.run

The command can then be used by Nagios:

  ruby simple_check.rb -H my_host -P my_port -w 4 -c 8 -t 10

If the value returned by do_some_check is between 0 and 4 inclusive the result is OK. If it is greater than 4 and less than 8 inclusive the result is WARNING. If it is greater than 8 the result is CRITICAL. See Nagios Developer Guidelines for more details on how the arguments of -w and -c are interpreted.

If the check method lasts more than 10 seconds, it times out and the returned value is UNKNOWN.

License

Released under the MIT License. See the MIT-LICENSE file for further details.

Copyright 2011 Dominique Broeglin

Something went wrong with that request. Please try again.