added cgi-bin/nagiosstatus.sh

README.md

@@ -1,10 +1,10 @@
 nagios-plugins
 ==============
 This repository contains my collection of modified and custom written check
-plugins for [Nagios](http://www.nagios.org).
+plugins and scripts for [Nagios](http://www.nagios.org).
 
-Most of these are modified versions of standard plugins or very custom so
-distributing them through [NagiosExchange](https://exchange.nagios.org/) is
+Most of these are very custom solutions or modified versions of standard plugins
+so distributing them through [NagiosExchange](https://exchange.nagios.org/) is
 not really appropriate.  I am publishing them separately so that others may
 benefit from these as well. Use them freely and please let me know is you
 encounter any issues or require changes.
@@ -18,7 +18,7 @@ License, see [below](#license)
 
 plugins/check_memory
 --------------------
-nagios check script to monitor the memory on Linux systems. Due to changes in
+Nagios check script to monitor the memory on Linux systems. Due to changes in
 the output of procps v3.3 (the changelog refers to it as modernizing it), it's
 output changed and breaks the the check_memory script as shipped with many linux
 distributions. This version supports both the old and the new format so that
@@ -26,6 +26,20 @@ is indifferent of which version of procps (to date) is used. No other changes
 were made to the script.
 
 
+cgi-bin/nagiosstatus.sh
+-----------------------
+Very simplistic CGI-BIN script that checkes whether nagios is still running and
+still updating its status. It wil always return an HTTP Status 200 (OK) and a
+simple text page with one of the following texts:
+ - STOPPED - in case the nagios process is not running
+ - STALLED - in case the nagios status file has not been updated for 5 minutes
+ - OK - when Nagios is running and updated its status file < 5 minutes ago
+
+I wrote this script to be used with an external monitoring system, I use it with
+the free subscription from [Pingdom](http://www.pingdom.com) to get alerts when
+my Nagios monitoring system is no longer reachable.
+
+
 <a name="license">License</a>
 -----------------------------
 These scripts, documentation & configration examples are free software: you can