servload man page

servload.man

.TH SERVLOAD 1 servload\-VERSION
.SH NAME
servload \- service benchmark for HTTP and DNS performance evaluation
.SH SYNOPSIS
.B servload
.I url file
.RI [ method 
.RI [ factor ]]
.SH DESCRIPTION
.B servload
is a lightweight high performance service benchmark which supports the protocols HTTP and DNS. servload uses requests and responses to determine performance metrics. Furthermore servload loads (and may modify) a given log file and issues (replay) the resulting requests.
.SH OPTIONS
.TP
.I url
url of target system. Use
.B http://
or
.B dns://
to specify target service.
.TP
.I file
log file to replay.
.TP
.I method
method to modify the log file.
.TP
.I factor
tuning parameter for method, if supported.
.SH USAGE
servload expects the 
.I common 
or
.I combined 
log format for HTTP and for DNS a log file from a 
.I bind channel-to-file
setup as input.
.P
The following methods are available to modify logs:
.TP
.I fast
Replay logs as fast as possible (e.g. ignore timestamps).
.TP
.I multiply factor
Multiply every request by factor.
.TP
.I peak factor
Multiply every request by factor, if the number of requests with the same timestamp is greater or equal the median number of request per second.
.TP
.I score factor
Assigns every session a score value from 0 to 25 for each of the following session characteristics: session length, session duration, median thinktime and median transfered bytes. Session characteristics are normalized through the calculation of the average absolute deviation from median. If the value of a characteristic is greater than the average absolute deviation the session obtains a score relative to the maximum value of this characteristic. The maximum score for a session is 100 and every session which achieves a score greater than 50 is multiplied by the given factor.
.SH EXAMPLES
.TP
$ servload http://www.example.com httpd.log
Replay HTTP requests according to timestamps from log file.
.TP
$ servload dns://8.8.8.8 bind.log fast
Replay DNS request ignoring timestamps from log file.
.TP
$ servload http://www.example.com httpd.log multiply 2
Replay HTTP requests from modified log file where every request is
doubled.