diff --git a/docs/20_Checks/_index.md b/docs/20_Checks/_index.md index 081c6c2aa3bfdfa3ee4765cc41c00035f68924d7..4aed7e2eaa290e5c7348eb4f149a56a6865a9bdb 100644 --- a/docs/20_Checks/_index.md +++ b/docs/20_Checks/_index.md @@ -23,7 +23,7 @@ There is one include script used by all checks: * [check_fs_errors](check_fs_errors.md) * [check_fs_writable](check_fs_writable.md) * [check_haproxy_health](check_haproxy_health.md) -* check_haproxy_status +* [check_haproxy_status](check_haproxy_status.md) * check_memory * check_mysqlserver * check_netio diff --git a/docs/20_Checks/check_haproxy_health.md b/docs/20_Checks/check_haproxy_health.md index 4211e4c2a67bb3846ff86b470c3e9aeb84493816..ca7b59cee1c0c5d401a7bcd6d9f350dbdbbdb0f3 100644 --- a/docs/20_Checks/check_haproxy_health.md +++ b/docs/20_Checks/check_haproxy_health.md @@ -1,4 +1,4 @@ -# Check filesystem errors +# Check HA-Proxy health ## Introduction diff --git a/docs/20_Checks/check_haproxy_status.md b/docs/20_Checks/check_haproxy_status.md new file mode 100644 index 0000000000000000000000000000000000000000..b7b233d0423887de942588d51b8a87840921a1a3 --- /dev/null +++ b/docs/20_Checks/check_haproxy_status.md @@ -0,0 +1,62 @@ +# Check HA-Proxy Status + +## Introduction + +**check_haproxy_health** show status and connections count on frontend and backend. + +## Syntax + +```txt +______________________________________________________________________ + +CHECK_HAPROXY_STATUS +v1.8 + +(c) Institute for Medical Education - University of Bern +Licence: GNU GPL 3 + +https://os-docs.iml.unibe.ch/icinga-checks/Checks/check_haproxy_status.html +______________________________________________________________________ + +Check HA Proxy statistics on frontend and backend. +It shows if the status is OPEN or UP and show counts of current connectons. + +The plugin reads /etc/haproxy/haproxy.cfg to detect the required statistics url and get +csv data. +It requires wget to handle the http request. + +Non OK values occur: + UNKNOWN - if /etc/haproxy/haproxy.cfg cannot be read + - haproxy is not in http mode + - the url wasn't detected + - the detected status url doesn't send a response + ERROR - a frontend status is not OPEN + - a backend status is not UP + +The plugin sends performance data. + +SYNTAX: +check_haproxy_status [-h] + +OPTIONS: + + -h or --help show this help. + +EXAMPLE: + + check_haproxy_status + +``` + +### Parameters + +(none) + +## Examples + +`$ check_haproxy_status` returns + +```txt +OK: FRONT: OPEN OPEN OPEN - 2 (max: 30010) .. BACK: UP UP UP - 0 (max: 3001) +FRONTEND - 2 BACKEND - 0 FRONTEND - 0 FRONTEND - 0 couchdb-0.example.com - 0 BACKEND - 0 couchdb-0.example.com - 0 couchdb-1.example.com - 0 couchdb-2.example.com - 0 BACKEND - 0 |frontend=2;; frontend-max=30010;; frontend-free=30008;; backend=0;; backend-max=3001;; backend-free=3001;; +```