check_end2end.pl – automate a website navigation

Project Notes

check_end2end.pl is a plugin allowing automation of web navigation through the
definition of a list of steps to be performed.
It is based upon LWP::UserAgent and Monitoring::Plugin modules, available from
CPAN.

It checks overall status of the process, can check total and/or individual
duration of steps and search for strings/regexps inside response body.

Since version 1.5.0 check_end2end.pl can make requests through proxy and
supports basic http authentication.

License: Perl 5 license.

check_end2end.pl comes with a MANUAL PAGE.
TO SEE FULL DOCUMENTATION:
- run
perldoc check_end2end.pl
- or run
check_end2end.pl -M
(the latter may not work if you don't have all the prerequisites installed).

All the steps to be performed are configured in a separate configuration file,
specified with the "-f" flag. The configuration file format is similar to the
one used by apache httpd:

<Step "StepName">
url = http://...
...
</Step>

specify as many steps as you want, they will be performed in alphabetical order.
See the MAN PAGE for the full list of configuration parameters and the manual of
Config::General for the details of the format.

SYNOPSYS
$ check_end2end.pl -h
check_end2end.pl v1.6.1

This nagios plugin is free software, and comes with ABSOLUTELY NO WARRANTY.
It may be used, redistributed and/or modified under the terms of the GNU
General Public Licence (see http://www.fsf.org/licensing/licenses/gpl.txt).

This plugin uses LWP::UserAgent to fake a website navigation as configured in the named configuration file.

Usage: check_end2end.pl [-v|--verbose] [-t <timeout>] [-d|--debug] [-M|--manual] [-D|--dumpPages=/dump/directory] [-e|--useEnvVars] [-E|--allowEmptyVars] [-c|--critical=<threshold>] [-w|--warning=<threshold>] [-C|--totcritical=<threshold>] [-W|--totwarning=<threshold>] [--var VAR=VALUE [--var VAR2=VALUE2 [ ... ] ] ] -f|--configFile=<cfgfile>

-?, --usage
Print usage information
-h, --help
Print detailed help screen
-V, --version
Print version information
--extra-opts=[section][@file]
Read options from an ini file. See https://www.monitoring-plugins.org/doc/extra-opts.html
for usage and examples.
-d, --debug
Print debugging messages to STDERR. Package Data::Dumper is required for debug.
-D, --dumpPages=/dump/directory
Writes the output of each step into a file under the named destination directory. The name of the file will be the same as the name of the corresponding step. Path::Tiny is required to dump page content.
-w, --warning=INTEGER:INTEGER
Warning threshold for each single step.
See https://www.monitoring-plugins.org/doc/guidelines.html#THRESHOLDFORMAT for the threshold format, or run check_end2end.pl -M (requires perldoc executable).
-c, --critical=INTEGER:INTEGER
Critical threshold for each single step.
See https://www.monitoring-plugins.org/doc/guidelines.html#THRESHOLDFORMAT for the threshold format, or run check_end2end.pl -M (requires perldoc executable).
-W, --totwarning=INTEGER:INTEGER
Warning threshold for the whole process.
See https://www.monitoring-plugins.org/doc/guidelines.html#THRESHOLDFORMAT for the threshold format, or run check_end2end.pl -M (requires perldoc executable).
-C, --totcritical=INTEGER:INTEGER
Critical threshold for the whole process.
See https://www.monitoring-plugins.org/doc/guidelines.html#THRESHOLDFORMAT for the threshold format, or run check_end2end.pl -M (requires perldoc executable).
-f, --configFile=/path/to/file.
Configuration of the steps to be performed by this plugin. See "perldoc check_end2end.pl" for details con configuration format, or run check_end2end.pl -M
-e, --useEnvVars
Interpolate variables in configuration file using enviroment variables also. Default: NO.
-E, --allowEmptyVars
By default, Config::General will croak if it tries to interpolate an undefined variable. Use this option to turn off this behaviour.
--var <VAR=VALUE>
Specify this option (even multiple times) to pass variables to this plugin on the command line. These variables will be interpolated in the configuration file, as if they were found inside environment. This automatically turns on --useEnvVars flag.
-P, --useEnvProxy
Get proxy configuration from environment variables (you can use --var to pass environment variables like http_proxy/https_proxy, and so on, if they're not in your environment already)
-M, --manual
Show plugin manual (requires perldoc executable).
-t, --timeout=INTEGER
Seconds before plugin times out (default: 15)
-v, --verbose
Show details for command-line debugging (can repeat up to 3 times)