= zenoss_client: A Ruby library for REST access to Zenoss This is a work-in-progress to create an easy to use client REST API for Zenoss (http://www.zenoss.com) written in Ruby. I love Zenoss as a product, but I am much more efficient in Ruby than Python so I decided to start hacking this library together. It is very incomplete and I am just adding functionality as I need it or it is requested. Cheers, Dan Wanek == REQUIREMENTS: Gems: * tzinfo: For Python DateTime to Ruby DateTime conversion == UNSUPPORTED REST METHODS: Some methods within Zope are unsupported due to type conversion issues. I have created a work-around but you must add a custom Python script to Zope in order to do this. Please see this blog post for information on how add the custom script: http://distributed-frostbite.blogspot.com/2010/04/using-ruby-with-zenoss-part-1.html UPDATE: The script itself is now part of the source tree and can be found here: tools/callZenossMethod.py It should still be installed in the same fashion as the blog post steps through. == TO USE: A gem is now available. 'gem install zenoss_client' require 'zenoss' # You must set the URI before doing anything else Zenoss.uri 'https://zenhost:port/zport/dmd/' # Add the appropriate credentials Zenoss.set_auth('user','pass') # This returns the base DeviceClass '/zport/dmd/Devices' # It is the equivilent in zendmd of 'dmd.Devices' devices = Zenoss.devices # Search for a device dev = devices.find_device_path('devname') # List all implemented REST methods for this object puts dev.zenoss_methods.sort.join(', ') # Get the uptime of the device dev.sys_uptime # Get a list of events for this system dev.get_events Have fun and let me know what needs to be fixed / added.