Hiya. nagfs is an event broker module, which implements a filesystem interface to the current status of a running Nagios daemon. This means in a nutshell that you can query the status of a given service or set of services using everyday shell tools like find and grep.
Each host is represented as a directory in the filesystem. Each host directory contains a file for each service nagios is monitoring on that host. Each file contains a single number representing the state of that service. For example, once nagfs is running, you can list all the services currently in a critical state by typing: grep -rl "2" /usr/share/nagios/status/local The numbers are what you'd expect ( 0:OK, 1:Warning, 2:Critical, 3,Unknown). If the service is in a soft state a "servicename.soft" file is created with the soft state status number. Each host directory also contains a HOST file which contains the current status of the host itself. As a second example, you could get a list of all the services Nagios is checking with: find /usr/share/nagios/status/local -type f This is a handy thing, and much easier than scraping html for the same info. nagfs registers for SERVICE_STATUS_DATA and HOST_STATUS_DATA updates from the Nagios server, which means that the nagfs filesystem is immediately brought up to date upon Nagios startup, and is always perfectly in sync with Nagios's memory state. It's released under the BSD license. The tarball is available on nagios exchange, and my blog http://www.skeptech.org Nagfs was originally the brainchild of Jeremy Blosser, who implemented it as a collection of shell scripts called via global event handlers. I found it so useful, and became so attached to it that I eventually forgot it wasn't actually part of the core Nagios package. I later re-implemented it as an event broker module as an object lesson for the addison wesley nagios book I authored, and refined it as part of a larger nagios clustering project called "nagimesh", which is not yet complete. However, I find nagfs so indispensable that I decided to release the source as a stand-alone NEB module, in the hope that you may too someday forget the time you've already spent without it. Check INSTALL in the tarball for installation instructions. It is assumed that you have a working Nagios implementation which has been compiled with the --enable-event-broker configure switch. I have several Nagios servers running versions of Nagios from 2.0alpha1 to 2.8, and nagfs works with all of them, so it ought to work for you if you haven't ventured into 3.0 territory yet. I haven't taken a look at the 3.0 event broker code yet, so for all I know it could work (if you try it and it works for you let me know). Have fun! -dave josephsen. ------------------------------------------------------------------------- Take Surveys. Earn Cash. Influence the Future of IT Join SourceForge.net's Techsay panel and you'll get the chance to share your opinions on IT & business topics through brief surveys-and earn cash http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV _______________________________________________ Nagios-users mailing list Nagios-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/nagios-users ::: Please include Nagios version, plugin version (-v) and OS when reporting any issue. ::: Messages without supporting info will risk being sent to /dev/null
