Michael Gregorowicz > Apache-HealthCheck-0.01 > Apache::HealthCheck

Download:
Apache-HealthCheck-0.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.01   Source  

NAME ^

Apache::HealthCheck - Checks a set of urls for conditions and puts up whatever page you want

SYNOPSIS ^

 <Location /health-check/>
    SetHander perl-script
    PerlModule Apache::HealthCheck
    PerlHandler Apache::HealthCheck
    PerlAddVar CheckURL "http://appserver1.example.com/ 404"
    PerlAddVar CheckURL "http://appserver1.example.com:8085/ 302"
    PerlAddVar CheckURL "http://component1.example.com:4424/ 403"
    PerlSetVar ReturnCodeSuccess 403
    PerlSetVar ReturnCodeFail 500
 </Location>

DESCRIPTION ^

Checks a list of urls for specific return codes and then returns a code / header / page of it's own. This is useful for web server clusters where you might have a switch or a web server performing periodic health checks on an application. This module allows you to harness the checks of all the urls (web services) a specific node might have in one easy to "check" URL.

If any of the URLs specified in the CheckURL directives fails to return the specified return code, the attempt is treated as failed, otherwise its treated as a success.

CONFIGURATION ^

Configuration must take place in the Apache config file using the PerlAddVar (or PerlSetVar) directives.

SEE ALSO ^

The Apache Documentation (http://httpd.apache.org/docs/1.3/), the mod_perl documentation (http://perl.apache.org/docs/1.0/)

AUTHOR ^

Michael Gregorowicz <mike@mg2.org>

COPYRIGHT AND LICENSE ^

Copyright (C) 2006 by Michael Gregorowicz

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.6.1 or, at your option, any later version of Perl 5 you may have available.

syntax highlighting: