Skip to content

http-monitor.pod

Latest commit

 

History

History
55 lines (34 loc) · 1.41 KB

http-monitor.pod

File metadata and controls

55 lines (34 loc) · 1.41 KB

NAME

http-monitor - Monitor HTTP status codes on a set of user-defined URLs

APPLICABLE SYSTEMS

Any system with curl installed and from which you would like to monitor HTTP services.

DESCRIPTION

This plugin will send HTTP GET commands to the specified URLs using curl and graph the status codes. All codes below 400 are considered normal and won't be reported. All codes between 400 and 499 signify that the service is running, but an application-level error occurred. This is considered a warning. All codes starting at 500 are considered critical errors. If the URL is completely unreachable, curl responds with code 000. In order to trigger the munin alert, this has been recoded to 999.

CONFIGURATION

The plugin assumes that curl is available under /usr/bin/curl. If it's not available in that location, you can override it with the config variable 'curl_path'

To set the urls to monitor, specify urls. The list should be space-separated.

Here is a config example (including the optional values):

[http-monitor]
    env.curl_path /usr/local/sbin/curl
    env.urls http://domain.tld/app1 http://www.google.com http://domain.tld/path+with%20spaces

INTERPRETATION

See "Description" above.

MAGIC MARKERS

#%# family=auto
#%# capabilities=autoconf

BUGS

None known.

AUTHOR

Michel Albert <michel % albert.lu>

LICENSE

GPLv2