httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From humbed...@apache.org
Subject svn commit: r1307795 - in /httpd/httpd/branches/2.2.x/docs/manual/programs: ab.html.en ab.xml
Date Sat, 31 Mar 2012 12:58:14 GMT
Author: humbedooh
Date: Sat Mar 31 12:58:14 2012
New Revision: 1307795

URL: http://svn.apache.org/viewvc?rev=1307795&view=rev
Log:
Backport to 2.2:
Add example ab output
Submitted by: druggeri

Modified:
    httpd/httpd/branches/2.2.x/docs/manual/programs/ab.html.en
    httpd/httpd/branches/2.2.x/docs/manual/programs/ab.xml

Modified: httpd/httpd/branches/2.2.x/docs/manual/programs/ab.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/programs/ab.html.en?rev=1307795&r1=1307794&r2=1307795&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/programs/ab.html.en (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/programs/ab.html.en Sat Mar 31 12:58:14 2012
@@ -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> |

Modified: httpd/httpd/branches/2.2.x/docs/manual/programs/ab.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/programs/ab.xml?rev=1307795&r1=1307794&r2=1307795&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/programs/ab.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/programs/ab.xml Sat Mar 31 12:58:14 2012
@@ -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>



Mime
View raw message