This is an automated email from the ASF dual-hosted git repository.
markt-asf pushed a commit to branch 9.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/9.0.x by this push:
new 0b55c14730 Document Tribes status information provided by JMX.
0b55c14730 is described below
commit 0b55c14730efe724cefcbb88db66248b5d55887e
Author: Mark Thomas <[email protected]>
AuthorDate: Fri Oct 2 17:56:17 2026 +0100
Document Tribes status information provided by JMX.
Based on PR #1071 by sainadh777
---
webapps/docs/changelog.xml | 9 ++++++++
webapps/docs/tribes/status.xml | 47 ++++++++++++++++++++++++++++++++++++++++--
2 files changed, 54 insertions(+), 2 deletions(-)
diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index 7bc9e6f41c..24c8a2b114 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -258,6 +258,15 @@
</add>
</changelog>
</subsection>
+ <subsection name="Tribes">
+ <changelog>
+ <docs>
+ Document Tribes channel, membership, transport and replication
+ status available through JMX. Based on pull request <pr>1071</pr> by
+ sainadh777. (markt)
+ </docs>
+ </changelog>
+ </subsection>
<subsection name="Other">
<changelog>
<update>
diff --git a/webapps/docs/tribes/status.xml b/webapps/docs/tribes/status.xml
index a89060738a..4cd0451b20 100644
--- a/webapps/docs/tribes/status.xml
+++ b/webapps/docs/tribes/status.xml
@@ -28,9 +28,52 @@
<body>
-
<section name="Status">
- <p>TODO</p>
+ <p>Tribes exposes the state of a running channel through JMX. Use a JMX
+ client to inspect the channel and its components. See the
+ <a href="../monitoring.html">Tomcat monitoring documentation</a> for
+ ways to connect a JMX client.</p>
+
+ <p>The channel's <code>jmxEnabled</code> attribute controls registration and
+ defaults to <code>true</code>. The default JMX domain is
+ <code>ClusterChannel</code>; <code>jmxDomain</code> and
+ <code>jmxPrefix</code> can change the object names. Each object name
+ includes <code>type=Channel</code>, the channel name, and a
+ <code>component</code> property. A channel must have a name for its
+ components to register. See the
+ <a href="../config/cluster-channel.html">channel configuration</a> for
+ these attributes.</p>
+</section>
+
+<section name="Membership">
+ <p>The <code>component=Membership</code> MBean exposes the the members known
+ to this node. Multicast, static, and cloud membership services expose
+ <code>hasMembers</code> and <code>getMembersByName</code>. A single node
+ cluster has no remote members.</p>
+</section>
+
+<section name="Message transport">
+ <p>The <code>component=Receiver</code> MBean for an NIO receiver exposes
+ <code>Listening</code>, <code>ActiveCount</code>, and
+ <code>PoolSize</code>. The <code>component=Sender</code> MBean exposes
+ properties of the configured sender.</p>
+
+ <p>If a <code>ThroughputInterceptor</code> is configured, its
+ <code>component=Interceptor</code> MBean exposes transmitted and received
+ message counts and transmit errors. A
+ <code>MessageDispatchInterceptor</code> exposes <code>CurrentSize</code>
+ and worker counts for its asynchronous send queue. Interceptor MBeans are
+ present only for configured interceptors.</p>
+</section>
+
+<section name="Session replication">
+ <p>When Tribes is used by a Tomcat cluster, the session manager provides
+ additional replication statistics. For example, a
+ <code>DeltaManager</code> with statistics enabled exposes counters for
+ sent and received session events and state transfers. These are manager
+ statistics, separate from the channel component MBeans. See the
+ <a href="../config/cluster-manager.html">cluster manager
+ configuration</a> for the <code>enableStatistics</code> attribute.</p>
</section>
</body>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
