CoffeeSaint 4.8

CoffeeSaint is a Nagios status viewer. It grabs the status from a Nagios server and displays it in a fullscreen GUI.

CoffeeSaint is written in Java so it should run on all platforms (tested on Linux and Windows XP).

CoffeeSaint works with Nagios versions 1, 2 and 3.

How to use it

Invoking

Status from a file

This way is used if you can reach the nagios status-file (look for 'status_file' in the Nagios configuration-file nagios.cfg) via either NFS or the local filesystem.
You might need to replace '/var/cache/nagios3/status.dat': see the file configured in nagios.cfg with the status_file-statement.

java -jar CoffeeSaint.jar --file /var/cache/nagios3/status.dat
 --interval 30 --image http://198.92.142.133/jpg/image.jpg
 --version 3 --nrows 10

Status via an URL

For this you need to make the Nagios status-file available via a webserver. E.g. ln -s /var/cache/nagios3/status.dat /var/www/htdocs.

java -jar CoffeeSaint.jar --url http://keetweej.vanheusden.com/status.dat
 --interval 30 --image http://www.xs4all.nl/~gemgouda/stadhuis.jpg
 --nrows 12

Status via a network connection

java -jar CoffeeSaint.jar --host keetweej.vanheusden.com --port 33333
 --interval 30 --image http://pwa.sonologic.nl/cam/dvcam.jpg?ts=224937
 --nrows 12

Replace 'keetweej.vanheusden.com' with the host-address of your Nagios server, same thing for '33333'. Interval is in seconds. '--image' selects one or more webcams to view in the background (can be omitted to get a green/gray (depends on state) background). '--version' selects the Nagios version; this can be either 1, 2 or 3. '--nrows 10' will make the program show at must 9 statusses.

Invoke with '--help' to see a complete list of options.

Configuring your Nagios server (for status via a network connection)
Add the following line to /etc/inetd.conf:

33333 stream tcp nowait root /usr/sbin/tcpd /bin/cat /var/cache/nagios3/status.dat

You might need to replace '/var/cache/nagios3/status.dat': see the file configured in nagios.cfg with the status_file-statement.
Then, restart inetd (on Debian that can be accomplished with: /etc/init.d/openbsd-inetd restart).

This configures inetd to serve the Nagios status on port 33333.

When the program is loading the current status, a blue block is displayed in the upper-right corner. If there was a problem loading the status, a red block will appear.

The values in the row at the top tell you the number of critical-, warning-, ok-, up-, down-, unreachable- and pending- statusses.


Product's homepage

Here are some key features of "CoffeeSaint":

· Can prioritize configurable hosts/services (using a file with regular expression patterns).
· Can display an image on the background (this can be an URL so you can display webcam images as well)
· Handles all Nagios versions
· Can retrieve remotely Nagios statuses
· Can play a sound if the status goes to error
· Written in Java so should run on all systems (linux, microsoft windows, apple mac)
· Font/font size/background color/number of rows displayed are configurable
· Configurable via build-in webserver

Requirements:

· Java 2 Standard Edition Runtime Environment
· Nagios

What's New in This Release: [ read full changelog ]

· Can now set a minimum height per row so that if more than '--nrows' problems are to be displayed, the height of the rows is adjusted