apache / apache/fluss

When enabled, JMX metrics reporter throws exception on startup

Open Beginner friendly
#2,712 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Java
Stars
2.1k
Forks
625
Avg merge
3d 14h
Merged PRs (30d)
97

Description

### Search before asking

- [x] I searched in the [issues](https://github.com/apache/fluss/issues) and found nothing similar.

### Fluss version

main (development)

### Please describe the bug 🐞

When enabled, the JMX reporters fails with following error:

```
2026-02-24 15:26:40,487 ERROR org.apache.fluss.metrics.reporter.ReporterSetup [] - Could not instantiate MetricReporter with name jmx. Metrics might not be exposed/reported.
java.lang.IllegalAccessError: superclass access check failed: class org.apache.fluss.metrics.jmx.JMXServer$JmxRegistry (in unnamed module @0x41294f8) cannot access class sun.rmi.registry.RegistryImpl (in module java.rmi) because module java.rmi does not export sun.rmi.registry to unnamed module @0x41294f8
at java.lang.ClassLoader.defineClass1(Native Method) ~[?:?]
at java.lang.ClassLoader.defineClass(Unknown Source) ~[?:?]
at java.security.SecureClassLoader.defineClass(Unknown Source) ~[?:?]
at java.net.URLClassLoader.defineClass(Unknown Source) ~[?:?]
at java.net.URLClassLoader$1.run(Unknown Source) ~[?:?]
at java.net.URLClassLoader$1.run(Unknown Source) ~[?:?]
at java.security.AccessController.doPrivileged(Unknown Source) ~[?:?]
at java.net.URLClassLoader.findClass(Unknown Source) ~[?:?]
at java.lang.ClassLoader.loadClass(Unknown Source) ~[?:?]
at org.apache.fluss.classloading.ComponentClassLoader.loadClassFromComponentOnly(ComponentClassLoader.java:153) ~[fluss-server-0.8.0-incubating.jar:0.8.0-incubating]
at org.apache.fluss.classloading.ComponentClassLoader.loadClassFromOwnerFirst(ComponentClassLoader.java:175) ~[fluss-server-0.8.0-incubating.jar:0.8.0-incubating]
at org.apache.fluss.classloading.ComponentClassLoader.loadClass(ComponentClassLoader.java:110) ~[fluss-server-0.8.0-incubating.jar:0.8.0-incubating]
at java.lang.ClassLoader.loadClass(Unknown Source) ~[?:?]
at org.apache.fluss.metrics.jmx.JMXServer.internalStart(JMXServer.java:94) ~[?:?]
at org.apache.fluss.metrics.jmx.JMXServer.start(JMXServer.java:62) ~[?:?]
at org.apache.fluss.metrics.jmx.JMXService.startJMXServerWithPortRanges(JMXService.java:90) ~[?:?]
at org.apache.fluss.metrics.jmx.JMXService.startInstance(JMXService.java:59) ~[?:?]
at org.apache.fluss.metrics.jmx.JMXReporter.(JMXReporter.java:75) ~[?:?]
at org.apache.fluss.metrics.jmx.JMXReporterPlugin.createMetricReporter(JMXReporterPlugin.java:32) ~[?:?]
at org.apache.fluss.metrics.jmx.JMXReporterPlugin.createMetricReporter(JMXReporterPlugin.java:25) ~[?:?]
at org.apache.fluss.metrics.reporter.ReporterSetup.setUpReporters(ReporterSetup.java:131) [fluss-server-0.8.0-incubating.jar:0.8.0-incubating]
at org.apache.fluss.metrics.reporter.ReporterSetup.fromConfiguration(ReporterSetup.java:59) [fluss-server-0.8.0-incubating.jar:0.8.0-incubating]
at org.apache.fluss.metrics.registry.MetricRegistry.create(MetricRegistry.java:72) [fluss-server-0.8.0-incubating.jar:0.8.0-incubating]
at org.apache.fluss.server.coordinator.CoordinatorServer.startServices(CoordinatorServer.java:164)
```

### Solution

Use `LocateRegistry.createRegistry` factory that uses JDK internals from inside the JDK module.

### Are you willing to submit a PR?

- [x] I'm willing to submit a PR!

Contributor guide

No contributing guide indexed for this repository

Research direction

Start at org.apache.fluss.metrics.jmx.JMXServer.internalStart, reported at JMXServer.java:94, and trace the startup path from JMXService.startJMXServerWithPortRanges. Review the JMX reporter setup and verify the behavior with JMX metrics enabled. Done means startup no longer throws the java.rmi module access error and the JMX reporter is available.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
observability
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.