Skip to content

Commit 692ecbb

Browse files
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) <noreply@anthropic.com>
1 parent c308407 commit 692ecbb

4 files changed

Lines changed: 6 additions & 23 deletions

File tree

src/site/xdoc/docs/http2-transport-additions.xml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -278,8 +278,9 @@ sender negotiates HTTP/2 framing and flow control automatically.</p>
278278

279279
<h3>Performance Monitoring</h3>
280280

281-
<p>HTTP/2 transport performance can be monitored via JMX or application-level
282-
logging. Enable JMX in the JVM startup flags (see the JVM Tuning section).</p>
281+
<p>For production monitoring, use Micrometer with Prometheus/Grafana or
282+
Spring Boot Actuator endpoints. Application-level logging via the
283+
Axis2 log configuration provides per-request timing details.</p>
283284

284285
<p>Available metrics include:</p>
285286
<ul>

src/site/xdoc/docs/openapi-rest-advanced-http2-userguide.xml

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -406,14 +406,8 @@ export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.coyote.http2.Http2Protocol.ini
406406
# Note: Axis2 HTTP/2 and OpenAPI are configured in axis2.xml, not via
407407
# system properties. No -Daxis2.* flags are needed.
408408

409-
# Performance Monitoring
410-
export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote"
411-
export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.port=9999"
412-
export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.ssl=false"
413-
export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.authenticate=false"
414-
415-
# Tomcat HTTP/2 Metrics
416-
export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.coyote.http2.Http2Protocol.jmxMetrics=true"
409+
# For production monitoring, use Micrometer with Prometheus/Grafana
410+
# or Spring Boot Actuator endpoints rather than raw JMX.
417411
</pre>
418412

419413
</body>

src/site/xdoc/docs/spring-boot-starter.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ new configurator implementation — work that is planned but not yet complete.</
7878
long-running, stateful service deployments typical of Axis2 workloads:</p>
7979

8080
<ul>
81-
<li>Container-managed thread pools, connection pools, and JMX monitoring</li>
81+
<li>Container-managed thread pools, connection pools, and monitoring (Actuator/Micrometer)</li>
8282
<li>Hot-redeploy via exploded WAR without JVM restart</li>
8383
<li>Central TLS/certificate management (Tomcat's <code>server.xml</code>, WildFly's Elytron)</li>
8484
<li>Established operational tooling (WildFly CLI, Tomcat Manager, deployment scanners)</li>

src/site/xdoc/docs/tomcat-http2-integration-guide.xml

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -282,18 +282,6 @@ export CATALINA_OPTS="$CATALINA_OPTS -Daxis2.json.moshi.h2.async.threshold=10485
282282
Compression:%{Accept-Encoding}i" /&gt;
283283
</pre>
284284

285-
<h4>JMX Monitoring Integration</h4>
286-
<pre>
287-
# Enable JMX for HTTP/2 metrics monitoring
288-
export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote"
289-
export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.port=9999"
290-
export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.ssl=false"
291-
export CATALINA_OPTS="$CATALINA_OPTS -Dcom.sun.management.jmxremote.authenticate=false"
292-
293-
# HTTP/2 specific metrics
294-
export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.coyote.http2.Http2Protocol.jmxMetrics=true"
295-
</pre>
296-
297285
<h2>Production Deployment Guide</h2>
298286

299287
<h3>1. Step-by-Step Deployment</h3>

0 commit comments

Comments
 (0)