httping - measure the lateceny and throughput of a webserver
httping [options] options: [-g url] [-h hostname] [-p portnumber] [-x proxyhost:port] [-c count] [-i interval] [-t timeout] [-s] [-G] [-b] [-L xferlimit] [-X] [-l] [-z] [-f] [-m] [-o rc,...] [-e string] [-I useragent string] [-R referer string] [-r] [-n warn,crit] [-N mode] [-q] [-V]
HTTPING(1) General Commands Manual HTTPING(1)
NAME
httping - measure the lateceny and throughput of a webserver
SYNOPSIS
httping [options]
options: [-g url] [-h hostname] [-p portnumber] [-x proxyhost:port] [-c
count] [-i interval] [-t timeout] [-s] [-G] [-b] [-L xferlimit] [-X]
[-l] [-z] [-f] [-m] [-o rc,...] [-e string] [-I useragent string] [-R
referer string] [-r] [-n warn,crit] [-N mode] [-q] [-V]
DESCRIPTION
The program httping lets you measure the latency of a webserver. Since
version 1.0.6 also the throughput can be measured.
OPTIONS
-g url This selects the url to probe. E.g.: http://localhost/
-h hostname
Instead of '-g' one can also set a hostname to probe with -h: -h
localhost
-p portnumber
-p can be used together with -h. -p selects the portnumber to
probe.
-x proxyhost:port]
Probe using a proxyserver. Note that you're also measuring the
latency of the proxyserver!
-c count
How many probes to send before exiting.
-i interval
How many seconds to sleep between every probe sent.
-t timeout
How long to wait for answer from the other side.
-S Split measured latency in time to connect and time to exchange a
request with the HTTP server.
-s When a successfull transaction was done, show the HTTP status-
code (200, 404, etc.).
-G Do a GET request instead of a HEAD request: this means that also
the complete page/file must be transferred. Note that in this
case you're no longer measuring the latency!
-b Use this switch together with '-G'. When this option is used,
the transferspeed (in KB/s) is shown.
-B Use this switch together with '-G'. Ask the HTTP server to com-
press the returned data: this will reduce the influence of the
bandwidth of your connection while increasing the influence of
the processorpower of the HTTP server.
-L x Use this switch together with '-G'. Limit the amount of data
transferred to 'x'. Note that this only affects the content of
the page/file and not the headerdata.
-X Use this switch together with '-G'. For each "ping" show the
amount of data transferred (excluding the headers).
-l Connect using SSL: for this to work you need to give a
'https'-url or a 443 portnumber.
-z When connecting using SSL, display the fingerprint of the X509
certificate(s) of the peer.
-a Audible ping
-f Flood ping: do not sit idle between each ping but ping as fast
as the computer and network allow you to.
-m Show machine readable output (also check '-o' and '-e').
-o x,x,...
This selects the HTTP status-codes which are regarded as an OK-
state.
-e str When the status-code differs from the ones selected with '-o',
the given string is displayed.
-I str UserAgent-string to send to the webserver (instead of 'HTTPing
<version>').
-R str Referer-string to send to the webserver.
-r Only resolve the hostname once: this takes the resolving out of
the loop so that the latency of the DNS is not measured. Also
usefull when you want to measure only 1 webserver while the DNS
returns a different ip-address for each resolve ('roundrobin').
-n warn,crit
Switches HTTPing to Nagios-plugin mode 1: return exitcode '1'
when the average response time is bigger then 'warn', return
exitcode '2' when the the average response time is bigger then
'crit'. In all other cases return exitcode '0'.
-N x Switches HTTPing to Nagios-plugin mode 2: return 0 when every-
thing is fine, 'x' when anything fails. E.g.: 1 => Nagios warn-
ing state, 2 => Nagios critical state.
-q Be quiet, only return an exit-code.
-A,U,P Activate the basic authentication, Username follow the -U, Pass-
word the -P.
-V Show the version and exit.
KEYS
Press <CTRL> + <c> to exit the program. It will display a summary of
what was measured.
EXAMPLES
httping -g http://localhost/
Ping the webserver on host 'localhost'.
httping -h localhost -p 1000
Ping the webserver on host 'localhost' and portnumber 1000.
httping -l -g https://localhost/
Ping the webserver on host 'localhost' using an SSL connection.
httping -g http://localhost/ -A -U username -P password
Ping the webserver on host 'localhost' using the Basic HTTP
Authentication.
BUGS
None. This program is totally bug-free.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+---------------+--------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------+
|Availability | diagnostic/httping |
+---------------+--------------------+
|Stability | Uncommitted |
+---------------+--------------------+
SEE ALSO
http://www.vanheusden.com/httping/
NOTES
This page describes httping as found in the httping-1.0.8 package;
other versions may differ slightly. Please mail corrections and addi-
tions to folkert@vanheusden.com. Report bugs in the program to folk-
ert@vanheusden.com. Consider using PGP. My PGP key-id is: 0x1f28d8ae
This software was built from source available at
https://java.net/projects/solaris-userland. The original community
source was downloaded from http://www.vanheus-
den.com/httping/httping-1.4.4.tgz
Further information about this software can be found on the open source
community website at http://www.vanheusden.com/httping/.
httping 2005-11 HTTPING(1)