cmwb

NAME

cmwb - utilite for Communiware benchmarking

SYNOPSIS

 cmwb [options] file(s)

DESCRIPTION

This utilite accepts from standard input data in format

 freq1 url1
 freq2 ur2
 . . .

where freqs are relative probabilites of calling corresponding url. Such data are similar to output of 'uniq -c' program and may be got as a result of processing some log files.

The utilite does HTTP requests to to all given urls and calculates various time parameters, such as total time, average time per request and so other.

The probability of requesting some url is its freq divided by sum of all freqs.

After executing the utilite prints summary report and (optionally) report for each visited url. Here is a sample of such a report:

 Reqs  Succ    Elapsed   Bytes    Sec/Req    Req/Sec  Bytes/Sec Url
    7     7   5.199022   21959   0.742717   1.346407    4223.68 http://tolikus.hq.aaanet.ru/default/tolik
    3     3   2.730876    7854   0.910292   1.098549    2876.00 http://tolikus.hq.aaanet.ru/default/login_t
    5     5   6.214929   50360   1.242986   0.804514    8103.07 http://tolikus.hq.aaanet.ru/default/default
    5     5  13.139167   88775   2.627833   0.380542    6756.52 http://tolikus.hq.aaanet.ru/default/guide_r
   20    20  27.283994  168948   1.364200   0.733031    6192.20 TOTAL

Values in columns are:

Reqs
Total number of requests to this url.

Succ
Number of successful responses, with status == 200.

Elapsed
Total time spent to these requests.

Bytes
Tolal bytes transferred from server.

Sec/Req
Average time spent for single request.

Req/Sec
Average number of requests per second.

Bytes/Sec
Average speed of data transferring.

Url
Url was requested or the word 'TOTAL' for general results, for all requested urls.

Options

-n number
Total number of requests, default 100.

-c number
Concurrency level, default one. If it is greater than one then -c concurrent child processes are started and each of them performs -n requests.

-p prefix
Url prefix, common part of urls in list.

-b backend_host_and_port
Value of this option must be Communiware backend hostname and port joined by colon, for example 'localhost:8888'. If this option is given then cmwb sends requestes directly to backend and appends proper 'X-Host' header to them.

-r sort_order
Does include in report each visited url and sets sort order. Sort order is string containing letters 's', 'r' and 'b' in both lower and upper case. They meaning is:
s
Sort by seconds per request.

r
Sort by requests per second.

b
Sort by bytes per second.

If letter(s) are in lower case then sort by increasing else by decreasing.

-l login:password
Performs Communiware authenification before benchmarking. Value of this option is Communiware user login and his password joined by colon.

-v number
After every number requests the utilite prints message to STDERR. Default 10. Does not print if number is zero.

16 октябрь 2007 13:45