Nagios/Icinga Plugin to check for DokuWiki Updates (v2,2015-09-05)
Nagios/Icinga can also serve to send you friendly reminders, like for example that you need to perform software updates.
Here’s my little contribution, a simple plugin to monitor a given DokuWiki site and check against the release server for any upgrades.
Just fetch the check_dokuwiki-0.1 check_dokuwiki-0.2 tarball and extract the check_dokuwiki script to your Nagios/Icinga plugin directory.
The latest plugin update (0.2, 2015-09-06) catches up with latest updates on Dokuwikis web page, and now incorporates upstream checks using the same mechanism that Dokuwiki uses internally. Also it adds some (although not yet well tested) support for http authentication.
Please check out the cli help for more details on specific arguments:
check_dokuwiki v (nagios-plugins 1.4.15) The nagios plugins come with ABSOLUTELY NO WARRANTY. You may redistribute copies of the plugins under the terms of the GNU General Public License. For more information about these matters, see the file named COPYING. Copyright (c) 2012 Gianpaolo Del Matto Usage: check_dokuwiki -H check_dokuwiki [-h | --help] check_dokuwiki [-V | --version] more arguments -a | --use-auth enable http authentication mode -r name | --realm=name use given realm with http auth -u user | --username=user use given username for http auth -p pass | --password=pass use given password for http auth -s | --use-ssl enable SSL mode (uses TCP:443 as default, see --tcp-port -p num | --tcp-port num use non-standard port if not given, defaults to TCP:80 (or TCP:443 if --use-ssl is used) give any valid DokuWiki hostname to fetch the 'VERSION' file from. Note: HTTP AUTH is currently not supported. Send email to nagios-users@lists.sourceforge.net if you have questions regarding use of this software. To submit patches or suggest improvements, send email to nagiosplug-devel@lists.sourceforge.net. Please include version information with all correspondence (when possible, use output from the --version option of the plugin itself).
Register the plugin with a command definition like this:
# 'check_dokuwiki' command definition define command{ command_name check_dokuwiki command_line /usr/local/libexec/nagios/check_dokuwiki -H $HOSTNAME }
Then simply add a service to one or more of your DokuWiki hosts (or hostgroups, whatever you prefer).
define service{ use generic-service host_name your_wiki_host_objects_list_here service_description dokuwiki_version check_command check_dokuwiki max_check_attempts 5 check_interval 5 retry_interval 3 check_period 24x7 notification_interval 0 notification_period 24x7 notification_options w,c,r }
Restart Nagios/Icinga and you’re done.
Happy monitoring 🙂