You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-commits@axis.apache.org by ro...@apache.org on 2026/05/11 12:49:59 UTC
(axis-axis2-java-core) 05/06: docs: Remove JMX monitoring sections from HTTP/2 guides
This is an automated email from the ASF dual-hosted git repository.
robertlazarski pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/axis-axis2-java-core.git
commit 692ecbbe1160be308e73b7edcc73faed4f15dc4e
Author: Robert Lazarski <ro...@gmail.com>
AuthorDate: Sun May 10 14:48:36 2026 -1000
docs: Remove JMX monitoring sections from HTTP/2 guides
JMX is obsolete for production monitoring in 2026. The documented
examples used -Dcom.sun.management.jmxremote with ssl=false and
authenticate=false — a security anti-pattern. The Http2Protocol.jmxMetrics
property does not exist in Tomcat.
Modern alternative: Micrometer + Prometheus/Grafana or Spring Boot
Actuator endpoints, which provide HTTP-accessible metrics without
opening unauthenticated JMX ports.
Co-Authored-By: Claude Opus 4.6 (1M context) <no...@anthropic.com>
---
src/site/xdoc/docs/http2-transport-additions.xml | 5 +++--
src/site/xdoc/docs/openapi-rest-advanced-http2-userguide.xml | 10 ++--------
src/site/xdoc/docs/spring-boot-starter.xml | 2 +-
src/site/xdoc/docs/tomcat-http2-integration-guide.xml | 12 ------------
4 files changed, 6 insertions(+), 23 deletions(-)
diff --git a/src/site/xdoc/docs/http2-transport-additions.xml b/src/site/xdoc/docs/http2-transport-additions.xml
index bbbfb370ab..a96f1f1bf1 100644
--- a/src/site/xdoc/docs/http2-transport-additions.xml
+++ b/src/site/xdoc/docs/http2-transport-additions.xml
@@ -278,8 +278,9 @@ sender negotiates HTTP/2 framing and flow control automatically.</p>
<h3>Performance Monitoring</h3>
-<p>HTTP/2 transport performance can be monitored via JMX or application-level
-logging. Enable JMX in the JVM startup flags (see the JVM Tuning section).</p>
+<p>For production monitoring, use Micrometer with Prometheus/Grafana or
+Spring Boot Actuator endpoints. Application-level logging via the
+Axis2 log configuration provides per-request timing details.</p>
<p>Available metrics include:</p>
<ul>
diff --git a/src/site/xdoc/docs/openapi-rest-advanced-http2-userguide.xml b/src/site/xdoc/docs/openapi-rest-advanced-http2-userguide.xml
index 06163eeab1..4a7bc32600 100644
--- a/src/site/xdoc/docs/openapi-rest-advanced-http2-userguide.xml
+++ b/src/site/xdoc/docs/openapi-rest-advanced-http2-userguide.xml
@@ -406,14 +406,8 @@ export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.coyote.http2.Http2Protocol.ini
# Note: Axis2 HTTP/2 and OpenAPI are configured in axis2.xml, not via
# system properties. No -Daxis2.* flags are needed.
-# Performance Monitoring
-export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote"
-export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.port=9999"
-export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.ssl=false"
-export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.authenticate=false"
-
-# Tomcat HTTP/2 Metrics
-export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.coyote.http2.Http2Protocol.jmxMetrics=true"
+# For production monitoring, use Micrometer with Prometheus/Grafana
+# or Spring Boot Actuator endpoints rather than raw JMX.
</pre>
</body>
diff --git a/src/site/xdoc/docs/spring-boot-starter.xml b/src/site/xdoc/docs/spring-boot-starter.xml
index 0c25a501b5..cb9facfb12 100644
--- a/src/site/xdoc/docs/spring-boot-starter.xml
+++ b/src/site/xdoc/docs/spring-boot-starter.xml
@@ -78,7 +78,7 @@ new configurator implementation — work that is planned but not yet complete.</
long-running, stateful service deployments typical of Axis2 workloads:</p>
<ul>
-<li>Container-managed thread pools, connection pools, and JMX monitoring</li>
+<li>Container-managed thread pools, connection pools, and monitoring (Actuator/Micrometer)</li>
<li>Hot-redeploy via exploded WAR without JVM restart</li>
<li>Central TLS/certificate management (Tomcat's <code>server.xml</code>, WildFly's Elytron)</li>
<li>Established operational tooling (WildFly CLI, Tomcat Manager, deployment scanners)</li>
diff --git a/src/site/xdoc/docs/tomcat-http2-integration-guide.xml b/src/site/xdoc/docs/tomcat-http2-integration-guide.xml
index 5a3f1cf2b9..e3d0e5acfc 100644
--- a/src/site/xdoc/docs/tomcat-http2-integration-guide.xml
+++ b/src/site/xdoc/docs/tomcat-http2-integration-guide.xml
@@ -282,18 +282,6 @@ export CATALINA_OPTS="$CATALINA_OPTS -Daxis2.json.moshi.h2.async.threshold=10485
Compression:%{Accept-Encoding}i" />
</pre>
-<h4>JMX Monitoring Integration</h4>
-<pre>
-# Enable JMX for HTTP/2 metrics monitoring
-export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote"
-export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.port=9999"
-export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.ssl=false"
-export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.authenticate=false"
-
-# HTTP/2 specific metrics
-export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.coyote.http2.Http2Protocol.jmxMetrics=true"
-</pre>
-
<h2>Production Deployment Guide</h2>
<h3>1. Step-by-Step Deployment</h3>