This is an automated email from the ASF dual-hosted git repository.
remm pushed a commit to branch 11.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/11.0.x by this push:
new a4ee31b031 Improve status manager information
a4ee31b031 is described below
commit a4ee31b0313f784c4f5093b8f01f11682ba5416d
Author: remm <r...@apache.org>
AuthorDate: Thu Nov 21 10:16:44 2024 +0100
Improve status manager information
---
webapps/docs/manager-howto.xml | 23 +++++++++++++++--------
1 file changed, 15 insertions(+), 8 deletions(-)
diff --git a/webapps/docs/manager-howto.xml b/webapps/docs/manager-howto.xml
index f9678f415e..e90a35e52a 100644
--- a/webapps/docs/manager-howto.xml
+++ b/webapps/docs/manager-howto.xml
@@ -1043,22 +1043,27 @@
href="config/listeners.html#StoreConfig_Lifecycle_Listener_-_org.apache.catalina
<section name="Server Status">
<p>From the following links you can view Status information about the server.
-Any one of <strong>manager-xxx</strong> roles allows access to this page.</p>
+The <code>manager-status</code> role or any one of the other
+<strong>manager-xxx</strong> roles allow access to this page.</p>
<source>http://localhost:8080/manager/status
http://localhost:8080/manager/status/all</source>
<p>Displays server status information in HTML format.</p>
-<source>http://localhost:8080/manager/status?XML=true
-http://localhost:8080/manager/status/all?XML=true</source>
+<source>http://localhost:8080/manager/status?XML=true</source>
-<p>Displays server status information in XML format.</p>
+<p>Displays server status information in XML format. The XML format does
+not include the detailed per web application statistics.</p>
<source>http://localhost:8080/manager/status?JSON=true
http://localhost:8080/manager/status/all?JSON=true</source>
-<p>Displays server status information in JSON format.</p>
+<p>Displays server status information in JSON format. The JSON format does
+not include the per thread state information. If using a client visualization
+tool for active monitoring and server status alerts (such as Grafana), the JSON
+output provided by the Manager will likely provide the easiest and most secure
+solution.</p>
<p>First, you have the server and JVM version number, JVM provider, OS name
and number followed by the architecture type.</p>
@@ -1073,8 +1078,9 @@ The same information is available for both of them :
current thread count and current thread busy.</p></li>
<li><p>Request information : Max processing time and processing time,
request and error count, bytes received and sent.</p></li>
- <li><p>A table showing Stage, Time, Bytes Sent, Bytes Receive, Client,
- VHost and Request. All existing threads are listed in the table.
+ <li><p>If not using the JSON format, the state of threads with Stage,
+ Time, Bytes Sent, Bytes Receive, Client, VHost and Request.
+ All existing threads are listed in the table.
Here is the list of the possible thread stages :</p>
<ul>
<li><p><em>"Parse and Prepare Request"</em> : The request headers are
@@ -1101,7 +1107,8 @@ The same information is available for both of them :
</ul>
<p>If you are using <code>/status/all</code> command, additional information
-on each of deployed web applications will be available.</p>
+on each of deployed web applications will be available, except for the XML
+format.</p>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
