DOC: expand the docs for the provided stats.

Indicate for each statistic which types may have a value for
that statistic.

Explain some of the provided statistics a little more deeply.
This commit is contained in:
James Westby 2014-07-08 10:14:57 -04:00 committed by Willy Tarreau
parent 70f72e0c90
commit ebe62d645b

View File

@ -13146,44 +13146,76 @@ text is doubled ('""'), which is the format that most tools recognize. Please
do not insert any column before these ones in order not to break tools which do not insert any column before these ones in order not to break tools which
use hard-coded column positions. use hard-coded column positions.
0. pxname: proxy name In brackets after each field name are the types which may have a value for
1. svname: service name (FRONTEND for frontend, BACKEND for backend, any name that field. The types are L (Listeners), F (Frontends), B (Backends), and
for server) S (Servers).
2. qcur: current queued requests
3. qmax: max queued requests 0. pxname [LFBS]: proxy name
4. scur: current sessions 1. svname [LFBS]: service name (FRONTEND for frontend, BACKEND for backend,
5. smax: max sessions any name for server/listener)
6. slim: sessions limit 2. qcur [..BS]: current queued requests. For the backend this reports the
7. stot: total sessions number queued without a server assigned.
8. bin: bytes in 3. qmax [..BS]: max value of qcur
9. bout: bytes out 4. scur [LFBS]: current sessions
10. dreq: denied requests 5. smax [LFBS]: max sessions
11. dresp: denied responses 6. slim [LFBS]: configured session limit
12. ereq: request errors 7. stot [LFBS]: cumulative number of connections
13. econ: connection errors 8. bin [LFBS]: bytes in
14. eresp: response errors (among which srv_abrt) 9. bout [LFBS]: bytes out
15. wretr: retries (warning) 10. dreq [LFB.]: requests denied because of security concerns.
16. wredis: redispatches (warning) - For tcp this is because of a matched tcp-request content rule.
17. status: status (UP/DOWN/NOLB/MAINT/MAINT(via)...) - For http this is because of a matched http-request or tarpit rule.
18. weight: server weight (server), total weight (backend) 11. dresp [LFBS]: responses denied because of security concerns.
19. act: server is active (server), number of active servers (backend) - For http this is because of a matched http-request rule, or
20. bck: server is backup (server), number of backup servers (backend) "option checkcache".
21. chkfail: number of failed checks 12. ereq [LF..]: request errors. Some of the possible causes are:
22. chkdown: number of UP->DOWN transitions - early termination from the client, before the request has been sent.
23. lastchg: last status change (in seconds) - read error from the client
24. downtime: total downtime (in seconds) - client timeout
25. qlimit: queue limit - client closed connection
26. pid: process id (0 for first instance, 1 for second, ...) - various bad requests from the client.
27. iid: unique proxy id - request was tarpitted.
28. sid: service id (unique inside a proxy) 13. econ [..BS]: number of requests that encountered an error trying to
29. throttle: warm up status connect to a backend server. The backend stat is the sum of the stat
30. lbtot: total number of times a server was selected for all servers of that backend, plus any connection errors not
31. tracked: id of proxy/server if tracking is enabled associated with a particular server (such as the backend having no
32. type (0=frontend, 1=backend, 2=server, 3=socket) active servers).
33. rate: number of sessions per second over last elapsed second 14. eresp [..BS]: response errors. srv_abrt will be counted here also.
34. rate_lim: limit on new sessions per second Some other errors are:
35. rate_max: max number of new sessions per second - write error on the client socket (won't be counted for the server stat)
36. check_status: status of last health check, one of: - failure applying filters to the response.
15. wretr [..BS]: number of times a connection to a server was retried.
16. wredis [..BS]: number of times a request was redispatched to another
server. The server value counts the number of times that server was
switched away from.
17. status [LFBS]: status (UP/DOWN/NOLB/MAINT/MAINT(via)...)
18. weight [..BS]: server weight (server), total weight (backend)
19. act [..BS]: server is active (server), number of active servers (backend)
20. bck [..BS]: server is backup (server), number of backup servers (backend)
21. chkfail [...S]: number of failed checks. (Only counts checks failed when
the server is up.)
22. chkdown [..BS]: number of UP->DOWN transitions. The backend counter counts
transitions to the whole backend being down, rather than the sum of the
counters for each server.
23. lastchg [..BS]: number of seconds since the last UP<->DOWN transition
24. downtime [..BS]: total downtime (in seconds). The value for the backend
is the downtime for the whole backend, not the sum of the server downtime.
25. qlimit [...S]: configured maxqueue for the server, or nothing in the
value is 0 (default, meaning no limit)
26. pid [LFBS]: process id (0 for first instance, 1 for second, ...)
27. iid [LFBS]: unique proxy id
28. sid [L..S]: server id (unique inside a proxy)
29. throttle [...S]: current throttle percentage for the server, when
slowstart is active, or no value if not in slowstart.
30. lbtot [..BS]: total number of times a server was selected, either for new
sessions, or when re-dispatching. The server counter is the number
of times that server was selected.
31. tracked [...S]: id of proxy/server if tracking is enabled.
32. type [LFBS]: (0=frontend, 1=backend, 2=server, 3=socket/listener)
33. rate [.FBS]: number of sessions per second over last elapsed second
34. rate_lim [.F..]: configured limit on new sessions per second
35. rate_max [.FBS]: max number of new sessions per second
36. check_status [...S]: status of last health check, one of:
UNK -> unknown UNK -> unknown
INI -> initializing INI -> initializing
SOCKERR -> socket error SOCKERR -> socket error
@ -13200,31 +13232,36 @@ use hard-coded column positions.
L7TOUT -> layer 7 (HTTP/SMTP) timeout L7TOUT -> layer 7 (HTTP/SMTP) timeout
L7RSP -> layer 7 invalid response - protocol error L7RSP -> layer 7 invalid response - protocol error
L7STS -> layer 7 response error, for example HTTP 5xx L7STS -> layer 7 response error, for example HTTP 5xx
37. check_code: layer5-7 code, if available 37. check_code [...S]: layer5-7 code, if available
38. check_duration: time in ms took to finish last health check 38. check_duration [...S]: time in ms took to finish last health check
39. hrsp_1xx: http responses with 1xx code 39. hrsp_1xx [.FBS]: http responses with 1xx code
40. hrsp_2xx: http responses with 2xx code 40. hrsp_2xx [.FBS]: http responses with 2xx code
41. hrsp_3xx: http responses with 3xx code 41. hrsp_3xx [.FBS]: http responses with 3xx code
42. hrsp_4xx: http responses with 4xx code 42. hrsp_4xx [.FBS]: http responses with 4xx code
43. hrsp_5xx: http responses with 5xx code 43. hrsp_5xx [.FBS]: http responses with 5xx code
44. hrsp_other: http responses with other codes (protocol error) 44. hrsp_other [.FBS]: http responses with other codes (protocol error)
45. hanafail: failed health checks details 45. hanafail [...S]: failed health checks details
46. req_rate: HTTP requests per second over last elapsed second 46. req_rate [.F..]: HTTP requests per second over last elapsed second
47. req_rate_max: max number of HTTP requests per second observed 47. req_rate_max [.F..]: max number of HTTP requests per second observed
48. req_tot: total number of HTTP requests received 48. req_tot [.F..]: total number of HTTP requests received
49. cli_abrt: number of data transfers aborted by the client 49. cli_abrt [..BS]: number of data transfers aborted by the client
50. srv_abrt: number of data transfers aborted by the server (inc. in eresp) 50. srv_abrt [..BS]: number of data transfers aborted by the server
51. comp_in: number of HTTP response bytes fed to the compressor (inc. in eresp)
52. comp_out: number of HTTP response bytes emitted by the compressor 51. comp_in [.FB.]: number of HTTP response bytes fed to the compressor
53. comp_byp: number of bytes that bypassed the HTTP compressor (CPU/BW limit) 52. comp_out [.FB.]: number of HTTP response bytes emitted by the compressor
54. comp_rsp: number of HTTP responses that were compressed 53. comp_byp [.FB.]: number of bytes that bypassed the HTTP compressor
55. lastsess: number of seconds since last session assigned to server/backend (CPU/BW limit)
56. last_chk: last health check contents or textual error 54. comp_rsp [.FB.]: number of HTTP responses that were compressed
57. last_agt: last agent check contents or textual error 55. lastsess [..BS]: number of seconds since last session assigned to
58. qtime: the average queue time in ms over the 1024 last requests server/backend
59. ctime: the average connect time in ms over the 1024 last requests 56. last_chk [...S]: last health check contents or textual error
60. rtime: the average response time in ms over the 1024 last requests (0 for TCP) 57. last_agt [...S]: last agent check contents or textual error
61. ttime: the average total session time in ms over the 1024 last requests 58. qtime [..BS]: the average queue time in ms over the 1024 last requests
59. ctime [..BS]: the average connect time in ms over the 1024 last requests
60. rtime [..BS]: the average response time in ms over the 1024 last requests
(0 for TCP)
61. ttime [..BS]: the average total session time in ms over the 1024 last
requests
9.2. Unix Socket commands 9.2. Unix Socket commands