RubyXymon Build Status

A simple gem for Xymon

Thanks to Greg Faust

Installation

Add this line to your application's Gemfile:

gem 'xymon'

And then execute:

$ bundle

Or install it yourself as:

$ gem install xymon

Usage

In its current state, the gem is simple to use. You can set two configuration variables, host and port, like this:

RubyXymon.config[:host] = 'localhost' RubyXymon.config[:port] = '1984' The values in the example are the defaults. You can also set the configuration at once, using either a Hash or a String, which points to a file: RubyXymon.config = { :host => 'localhost' } RubyXymon.config = "/some/dir/xymon.yml"

You can send a raw Xymon message using the send method:

RubyXymon.send("status www.http green date Web OK")

For more information on Xymon, see the [Xymon man page]

Future improvements:

  • methods based on Xymon messages. Each message has its own syntax, e.g. RubyXymon.status(lifetime, group, hostname, testname, color, txt)
  • methods to read from Xymon, e.g. "query" message

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request