From: Daniel Gruno
Date: Sat, 31 Mar 2012 12:51:54 +0000 (+0000)
Subject: Merge r1307790 from trunk:
X-Git-Tag: 2.4.2~51
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=608c3c5abd589f1e77788e1287b9c0ed3358a06a;p=apache
Merge r1307790 from trunk:
Add example ab output
Submitted by: druggeri
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1307793 13f79535-47bb-0310-9956-ffa450edef68
---
diff --git a/docs/manual/programs/ab.xml b/docs/manual/programs/ab.xml
index 11b0f88d13..52f7b86b9c 100644
--- a/docs/manual/programs/ab.xml
+++ b/docs/manual/programs/ab.xml
@@ -216,4 +216,129 @@
would measure the ab
performance rather than the server's.
+Example Output
+
+ Sample output is provided here.
+ 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)
+
+ The output may vary depending on the command line parameters given.
+ Possible output with a brief explanation of each element is listed below.
+
+
+
+ - Server Software
+ - The value, if any, returned in the server 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.
+
+ - Server Hostname
+ - The DNS or IP address given on the command line
+
+ - Server Port
+ - 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.
+
+ - SSL/TLS Protocol
+ - The protocol parameters negotiated between the client and server.
+ This will only be printed if SSL is used.
+
+ - Document Path
+ - The request URI parsed from the command line string.
+
+ - Document Length
+ - This is size in bytes of the first succesfully returning document.
+ If the document length changes during testing, the response is
+ considered an error.
+
+ - Concurrency Level
+ - The number of concurrent clients used during the test
+
+ - Time taken for tests
+ - This is the time taken from the moment the first socket connection
+ is created to the moment the last response is recieved
+
+ - Complete requests
+ - The number of successful responses recieved
+
+ - Failed requests
+ - 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.
+
+ - Write errors
+ - The number of errors that failed during write (broken pipe).
+
+ - Non-2xx responses
+ - The number of responses that were not in the 200 series of response
+ codes. If all responses were 200, this field is not printed.
+
+ - Keep-Alive requests
+ - The number of connections that resulted in Keep-Alive requests
+
+ - Total body sent
+ - 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.
+
+ - Total transferred
+ - The total number of bytes received from the server. This number
+ is essentially the number of bytes sent over the wire.
+
+ - HTML transferred
+ - The total number of document bytes received from the server. This
+ number excludes bytes received in HTTP headers
+
+ - Requests per second
+ - This is the number of requests per second. This value is the result
+ of dividing the number of requests by the total time taken
+
+ - Time per request
+ - The average time spent per request. The first value is calculated
+ with the formula
concurrency * timetaken * 1000 / done
+ while the second value is calculated with the formula
+ timetaken * 1000 / done
+
+ - Transfer rate
+ - The rate of transfer as calculated by the formula
+
totalread / 1024 / timetaken
+
+