Table of Contents

Name

cacti_remote_by_http - cacti command for getting remote values by http

Synopsis

cacti_remote_by_http [ -D ] -H ip-address -p port [ -u unit ] key

Description

cacti_remote_by_http is a cacti plugin for remote checking hosts by (simplified) http. It was written as a (fast) alternative to net-snmp and it is designed to work with knoerre, a small http-server.
cacti_remote_by_http sends according to the given key a HTTP request to the remote server. Then it expects a value as a result of the remote check. It takes the value from the last line of the remote HTTP response. The value will be interpreted as a positive integer with up to 63 bits.
key is a string sent as http GET request to the remote server and depends on the type of the remote http server. If i.e. the key load1 is specified then the following request is sent:

GET /load1 HTTP/1.0

If you use i.e. knoerre as remote http server then you will get a http response with the current load-per-1-minute as remote check value in the last line.

Options

-H ip-address
Specify the IP address of the remote server to check.

-p port
Specify the port of the http server on the remote host.

-u unit
Specify an optional unit string which is placed with a colon before the remote value.

-D
Use TCP_DEFER_ACCEPT (see tcp(7) ). This can speed up our http-communication by approx. 10 percent, but it breaks tcp-communication by RFC - like many others too. It can also cause trouble with loadbalancers like F5 which send "early" ACK packets to the server before ACK from client.

See Also

check_remote_by_http(1) , knoerre(1)

http://downloads.tuxad.de/nagios-fwb

Examples

One example of cacti_remote_by_http with knoerre as remote http server:

# cacti_remote_by_http -H 172.16.1.1 -p 8888 -u load1 load1
load1:0.33

Author

Frank Bergmann, http://www.tuxad.com


Table of Contents