Commit 271ac8e3 authored by Daniel Gruno's avatar Daniel Gruno
Browse files

Backport to 2.2: 

Add example ab output
Submitted by: druggeri

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@1307795 13f79535-47bb-0310-9956-ffa450edef68
parent e786bc2b

docs/manual/programs/ab.html.en

+127 −0
Original line number Diff line number Diff line
@@ -32,6 +32,7 @@ 
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#bugs">Bugs</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#output">Example Output</a></li>

</ul><h3>See also</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li></ul></div>

<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="section">
@@ -211,6 +212,132 @@ 
    of responses. The rather heavy use of <code>strstr(3)</code> shows up top

    in profile, which might indicate a performance problem; <em>i.e.</em>, you

    would measure the <code>ab</code> performance rather than the server's.</p>

</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="section">

<h2><a name="output" id="output">Example Output</a></h2>



    <p>Sample output is provided here.</p>

    <div class="note"><pre>Server Software:        Apache/2.2.17

Server Hostname:        testserver.com

Server Port:            80



Document Path:          /index.html

Document Length:        787 bytes



Concurrency Level:      5

Time taken for tests:   0.436 seconds

Complete requests:      1000

Failed requests:        0

Write errors:           0

Total transferred:      1026000 bytes

HTML transferred:       787000 bytes

Requests per second:    2292.26 [#/sec] (mean)

Time per request:       2.181 [ms] (mean)

Time per request:       0.436 [ms] (mean, across all concurrent requests)

Transfer rate:          2296.74 [Kbytes/sec] received



Connection Times (ms)

              min  mean[+/-sd] median   max

Connect:        0    1   0.4      1       3

Processing:     1    1   0.4      1       3

Waiting:        0    1   0.5      1       2

Total:          2    2   0.1      2       3



Percentage of the requests served within a certain time (ms)

  50%      2

  66%      2

  75%      2

  80%      2

  90%      2

  95%      2

  98%      2

  99%      3

 100%      3 (longest request)</pre></div>



    <p>The output may vary depending on the command line parameters given.

    Possible output with a brief explanation of each element is listed below.

    </p>



    <dl>

        <dt>Server Software</dt>

        <dd>The value, if any, returned in the <var>server</var> HTTP header

        of the first successful response. This includes all characters in the

        header from beginning to the point a character with decimal value of 32

        (most notably: a space or CR/LF) is detected.</dd>



        <dt>Server Hostname</dt>

        <dd>The DNS or IP address given on the command line</dd>



        <dt>Server Port</dt>

        <dd>The port to which ab is connecting. If no port is given on the

        command line, this will default to 80 for http and 443 for

        https.</dd>



        <dt>SSL/TLS Protocol</dt>

        <dd>The protocol parameters negotiated between the client and server.

        This will only be printed if SSL is used.</dd>



        <dt>Document Path</dt>

        <dd>The request URI parsed from the command line string.</dd>



        <dt>Document Length</dt>

        <dd>This is size in bytes of the first succesfully returning document.

        If the document length changes during testing, the response is

        considered an error.</dd>



        <dt>Concurrency Level</dt>

        <dd>The number of concurrent clients used during the test</dd>



        <dt>Time taken for tests</dt>

        <dd>This is the time taken from the moment the first socket connection

        is created to the moment the last response is recieved</dd>



        <dt>Complete requests</dt>

        <dd>The number of successful responses recieved</dd>



        <dt>Failed requests</dt>

        <dd>The number of requests that were considered a failure. If the

        number is greater than zero, another line will be printed showing the

        numer of requests that failed due to connecting, reading, incorrect

        content length, or exceptions.</dd>



        <dt>Write errors</dt>

        <dd>The number of errors that failed during write (broken pipe).</dd>



        <dt>Non-2xx responses</dt>

        <dd>The number of responses that were not in the 200 series of response

        codes. If all responses were 200, this field is not printed.</dd>



        <dt>Keep-Alive requests</dt>

        <dd>The number of connections that resulted in Keep-Alive requests</dd>



        <dt>Total body sent</dt>

        <dd>If configured to send data as part of the test, this is the total

        number of bytes sent during the tests. This field is omitted if the test

        did not include a body to send.</dd>



        <dt>Total transferred</dt>

        <dd>The total number of bytes received from the server. This number

        is essentially the number of bytes sent over the wire.</dd>



        <dt>HTML transferred</dt>

        <dd>The total number of document bytes received from the server. This

        number excludes bytes received in HTTP headers</dd>



        <dt>Requests per second</dt>

        <dd>This is the number of requests per second. This value is the result

        of dividing the number of requests by the total time taken</dd>



        <dt>Time per request</dt>

        <dd>The average time spent per request. The first value is calculated

        with the formula <code>concurrency * timetaken * 1000 / done</code>

        while the second value is calculated with the formula

        <code>timetaken * 1000 / done</code></dd>



        <dt>Transfer rate</dt>

        <dd>The rate of transfer as calculated by the formula

        <code>totalread / 1024 / timetaken</code></dd>

    </dl>

</div></div>

<div class="bottomlang">

<p><span>Available Languages: </span><a href="../en/programs/ab.html" title="English">&nbsp;en&nbsp;</a> |

docs/manual/programs/ab.xml

+124 −0
Original line number Diff line number Diff line
@@ -211,5 +211,129 @@ 
    in profile, which might indicate a performance problem; <em>i.e.</em>, you

    would measure the <code>ab</code> performance rather than the server's.</p>

</section>

<section id="output"><title>Example Output</title>



    <p>Sample output is provided here.</p>

    <note><pre>Server Software:        Apache/2.2.17

Server Hostname:        testserver.com

Server Port:            80



Document Path:          /index.html

Document Length:        787 bytes



Concurrency Level:      5

Time taken for tests:   0.436 seconds

Complete requests:      1000

Failed requests:        0

Write errors:           0

Total transferred:      1026000 bytes

HTML transferred:       787000 bytes

Requests per second:    2292.26 [#/sec] (mean)

Time per request:       2.181 [ms] (mean)

Time per request:       0.436 [ms] (mean, across all concurrent requests)

Transfer rate:          2296.74 [Kbytes/sec] received



Connection Times (ms)

              min  mean[+/-sd] median   max

Connect:        0    1   0.4      1       3

Processing:     1    1   0.4      1       3

Waiting:        0    1   0.5      1       2

Total:          2    2   0.1      2       3



Percentage of the requests served within a certain time (ms)

  50%      2

  66%      2

  75%      2

  80%      2

  90%      2

  95%      2

  98%      2

  99%      3

 100%      3 (longest request)</pre></note>



    <p>The output may vary depending on the command line parameters given.

    Possible output with a brief explanation of each element is listed below.

    </p>



    <dl>

        <dt>Server Software</dt>

        <dd>The value, if any, returned in the <var>server</var> HTTP header

        of the first successful response. This includes all characters in the

        header from beginning to the point a character with decimal value of 32

        (most notably: a space or CR/LF) is detected.</dd>



        <dt>Server Hostname</dt>

        <dd>The DNS or IP address given on the command line</dd>



        <dt>Server Port</dt>

        <dd>The port to which ab is connecting. If no port is given on the

        command line, this will default to 80 for http and 443 for

        https.</dd>



        <dt>SSL/TLS Protocol</dt>

        <dd>The protocol parameters negotiated between the client and server.

        This will only be printed if SSL is used.</dd>



        <dt>Document Path</dt>

        <dd>The request URI parsed from the command line string.</dd>



        <dt>Document Length</dt>

        <dd>This is size in bytes of the first succesfully returning document.

        If the document length changes during testing, the response is

        considered an error.</dd>



        <dt>Concurrency Level</dt>

        <dd>The number of concurrent clients used during the test</dd>



        <dt>Time taken for tests</dt>

        <dd>This is the time taken from the moment the first socket connection

        is created to the moment the last response is recieved</dd>



        <dt>Complete requests</dt>

        <dd>The number of successful responses recieved</dd>



        <dt>Failed requests</dt>

        <dd>The number of requests that were considered a failure. If the

        number is greater than zero, another line will be printed showing the

        numer of requests that failed due to connecting, reading, incorrect

        content length, or exceptions.</dd>



        <dt>Write errors</dt>

        <dd>The number of errors that failed during write (broken pipe).</dd>



        <dt>Non-2xx responses</dt>

        <dd>The number of responses that were not in the 200 series of response

        codes. If all responses were 200, this field is not printed.</dd>



        <dt>Keep-Alive requests</dt>

        <dd>The number of connections that resulted in Keep-Alive requests</dd>



        <dt>Total body sent</dt>

        <dd>If configured to send data as part of the test, this is the total

        number of bytes sent during the tests. This field is omitted if the test

        did not include a body to send.</dd>



        <dt>Total transferred</dt>

        <dd>The total number of bytes received from the server. This number

        is essentially the number of bytes sent over the wire.</dd>



        <dt>HTML transferred</dt>

        <dd>The total number of document bytes received from the server. This

        number excludes bytes received in HTTP headers</dd>



        <dt>Requests per second</dt>

        <dd>This is the number of requests per second. This value is the result

        of dividing the number of requests by the total time taken</dd>



        <dt>Time per request</dt>

        <dd>The average time spent per request. The first value is calculated

        with the formula <code>concurrency * timetaken * 1000 / done</code>

        while the second value is calculated with the formula

        <code>timetaken * 1000 / done</code></dd>



        <dt>Transfer rate</dt>

        <dd>The rate of transfer as calculated by the formula

        <code>totalread / 1024 / timetaken</code></dd>

    </dl>

</section>

</manualpage>