DOC: management: update stream vs session

Indicate for some commands such as "show sess" that we now dump streams
and not sessions.
This commit is contained in:
Willy Tarreau 2023-12-05 09:30:44 +01:00
parent a7777bbf79
commit ba168dcf18

View File

@ -2716,8 +2716,8 @@ show errors [<iid>|<proxy>] [request|response]
names. The report precisely indicates what exact character violated the names. The report precisely indicates what exact character violated the
protocol. Other important information such as the exact date the error was protocol. Other important information such as the exact date the error was
detected, frontend and backend names, the server name (when known), the detected, frontend and backend names, the server name (when known), the
internal session ID and the source address which has initiated the session internal transaction ID and the source address which has initiated the
are reported too. session are reported too.
All characters are returned, and non-printable characters are encoded. The All characters are returned, and non-printable characters are encoded. The
most common ones (\t = 9, \n = 10, \r = 13 and \e = 27) are encoded as one most common ones (\t = 9, \n = 10, \r = 13 and \e = 27) are encoded as one
@ -2751,11 +2751,11 @@ show errors [<iid>|<proxy>] [request|response]
In the example above, we see that the backend "http-in" which has internal In the example above, we see that the backend "http-in" which has internal
ID 2 has blocked an invalid response from its server s2 which has internal ID 2 has blocked an invalid response from its server s2 which has internal
ID 1. The request was on session 54 initiated by source 127.0.0.1 and ID 1. The request was on transaction 54 (called "session" here) initiated
received by frontend fe-eth0 whose ID is 1. The total response length was by source 127.0.0.1 and received by frontend fe-eth0 whose ID is 1. The
213 bytes when the error was detected, and the error was at byte 23. This total response length was 213 bytes when the error was detected, and the
is the slash ('/') in header name "header/bizarre", which is not a valid error was at byte 23. This is the slash ('/') in header name
HTTP character for a header name. "header/bizarre", which is not a valid HTTP character for a header name.
show events [<sink>] [-w] [-n] show events [<sink>] [-w] [-n]
With no option, this lists all known event sinks and their types. With an With no option, this lists all known event sinks and their types. With an
@ -3194,24 +3194,24 @@ show servers state [<backend>]
srv_agent_port: Server health agent port. srv_agent_port: Server health agent port.
show sess show sess
Dump all known sessions. Avoid doing this on slow connections as this can Dump all known active streams (formerly called "sessions"). Avoid doing this
be huge. This command is restricted and can only be issued on sockets on slow connections as this can be huge. This command is restricted and can
configured for levels "operator" or "admin". Note that on machines with only be issued on sockets configured for levels "operator" or "admin". Note
quickly recycled connections, it is possible that this output reports less that on machines with quickly recycled connections, it is possible that this
entries than really exist because it will dump all existing sessions up to output reports less entries than really exist because it will dump all
the last one that was created before the command was entered; those which existing streams up to the last one that was created before the command was
die in the mean time will not appear. entered; those which die in the mean time will not appear.
show sess <id> | older <age> | susp | all show sess <id> | older <age> | susp | all
Display a lot of internal information about the matching sessions. In the Display a lot of internal information about the matching streams. In the
first form, only the session matching the specified session identifier will first form, only the stream matching the specified stream identifier will
be shown. This identifier is the first field at the beginning of the lines in be shown. This identifier is the first field at the beginning of the lines in
the dumps of "show sess" (it corresponds to the session pointer). In the the dumps of "show sess" (it corresponds to the stream pointer). In the
second form, only sessions older than <age> (in seconds by default) will be second form, only streams older than <age> (in seconds by default) will be
shown. Passing "susp" instead will only report entries that are considered as shown. Passing "susp" instead will only report entries that are considered as
suspicious by the developers based on criteria that may in time or vary along suspicious by the developers based on criteria that may in time or vary along
versions. If "all" is used instead, then all sessions will be dumped. Dumping versions. If "all" is used instead, then all streams will be dumped. Dumping
many sessions can produce a huge output, take a lot of time and be CPU many streams can produce a huge output, take a lot of time and be CPU
intensive, so it's always better to only dump the minimum needed. Those intensive, so it's always better to only dump the minimum needed. Those
information are useless to most users but may be used by haproxy developers information are useless to most users but may be used by haproxy developers
to troubleshoot a complex bug. The output format is intentionally not to troubleshoot a complex bug. The output format is intentionally not
@ -3808,17 +3808,17 @@ shutdown frontend <frontend>
level "admin". level "admin".
shutdown session <id> shutdown session <id>
Immediately terminate the session matching the specified session identifier. Immediately terminate the stream matching the specified stream identifier.
This identifier is the first field at the beginning of the lines in the dumps This identifier is the first field at the beginning of the lines in the dumps
of "show sess" (it corresponds to the session pointer). This can be used to of "show sess" (it corresponds to the stream pointer). This can be used to
terminate a long-running session without waiting for a timeout or when an terminate a long-running stream without waiting for a timeout or when an
endless transfer is ongoing. Such terminated sessions are reported with a 'K' endless transfer is ongoing. Such terminated streams are reported with a 'K'
flag in the logs. flag in the logs.
shutdown sessions server <backend>/<server> shutdown sessions server <backend>/<server>
Immediately terminate all the sessions attached to the specified server. This Immediately terminate all the streams attached to the specified server. This
can be used to terminate long-running sessions after a server is put into can be used to terminate long-running streams after a server is put into
maintenance mode, for instance. Such terminated sessions are reported with a maintenance mode, for instance. Such terminated streams are reported with a
'K' flag in the logs. 'K' flag in the logs.
trace trace