How knbgull/nbgvox works
NbgVox is an embeddable Java monitoring module that exposes host-process status through HTTP. The main workflow is host attachment (directly or as a JVM agent), configuration and runtime initialization, then browser requests to status, JSON, or JVM-detail endpoints. Runtime data includes CPU/thread metrics and registered extension fields; the documented access-sensitive user logging capability is also represented. Several edges rely on source-index references rather than complete excerpts, so uncertain internal wiring is omitted.
Main entry points: NbgVox.java Attach lifecycle · RuntimeInfo.java Runtime metrics · NbgVoxServer.java HTTP server · StatusHandler.java Status page
Components 17
Startup and configuration
- JVM agent
src/main/java/knbgulll/nbgvox/vox/agent/NbgVoxAgent.java - Attach lifecycle
src/main/java/knbgulll/nbgvox/vox/NbgVox.java - Configuration
src/main/java/knbgulll/nbgvox/vox/NbgVoxConfig.java - Bundled defaults
src/main/resources/META-INF/nbgvox-default.properties
Runtime monitoring
- Runtime metrics
src/main/java/knbgulll/nbgvox/vox/data/RuntimeInfo.java
HTTP presentation
- HTTP server
src/main/java/knbgulll/nbgvox/vox/NbgVoxServer.java - Root redirect
src/main/java/knbgulll/nbgvox/vox/handler/RootRedirectHandler.java - Status page
src/main/java/knbgulll/nbgvox/vox/handler/StatusHandler.java - Status JSON
src/main/java/knbgulll/nbgvox/vox/handler/JsonStatusHandler.java - JVM detail tree
src/main/java/knbgulll/nbgvox/vox/handler/JvmAllHandler.java
Extensions and logging
- Provider registry
src/main/java/knbgulll/nbgvox/vox/NbgVoxRegistry.java - Custom data provider
src/main/java/knbgulll/nbgvox/vox/data/NbgVoxDataProvider.java - System logger
src/main/java/knbgulll/nbgvox/vox/log/SystemLogger.java - User activity logger
src/main/java/knbgulll/nbgvox/vox/log/UserLogger.java - Rotating log writer
src/main/java/knbgulll/nbgvox/vox/log/LogWriter.java
Other components
- Host application
- Browser user
Connections 26
- Host application → Attach lifecycle: attaches
README.md - JVM agent → Attach lifecycle: starts
src/main/java/knbgulll/nbgvox/vox/agent/NbgVoxAgent.java - Attach lifecycle → Configuration: loads
src/main/java/knbgulll/nbgvox/vox/NbgVox.java - Configuration → Bundled defaults: loads defaults
src/main/java/knbgulll/nbgvox/vox/NbgVoxConfig.java - Attach lifecycle → Runtime metrics: initializes
src/main/java/knbgulll/nbgvox/vox/NbgVox.java - Attach lifecycle → Provider registry: creates
src/main/java/knbgulll/nbgvox/vox/NbgVox.java - Attach lifecycle → HTTP server: starts
src/main/java/knbgulll/nbgvox/vox/NbgVox.java - Attach lifecycle → System logger: creates
src/main/java/knbgulll/nbgvox/vox/NbgVox.java - Attach lifecycle → User activity logger: creates
src/main/java/knbgulll/nbgvox/vox/NbgVox.java - HTTP server → Root redirect: routes root
src/main/java/knbgulll/nbgvox/vox/NbgVoxServer.java - HTTP server → Status page: routes status
src/main/java/knbgulll/nbgvox/vox/NbgVoxServer.java - HTTP server → Status JSON: routes JSON
src/main/java/knbgulll/nbgvox/vox/NbgVoxServer.java - HTTP server → JVM detail tree: routes details
src/main/java/knbgulll/nbgvox/vox/NbgVoxServer.java - Browser user → Status page: requests page
README.md - Browser user → Status JSON: requests data
README.md - Browser user → JVM detail tree: requests details
README.md - Status page → Status JSON: fetches updates
src/main/java/knbgulll/nbgvox/vox/handler/StatusHandler.java - Status page → Runtime metrics: reads metrics
src/main/java/knbgulll/nbgvox/vox/handler/StatusHandler.java - Status JSON → Runtime metrics: reads metrics
src/main/java/knbgulll/nbgvox/vox/handler/JsonStatusHandler.java - JVM detail tree → Runtime metrics: samples runtime
src/main/java/knbgulll/nbgvox/vox/handler/JvmAllHandler.java - Runtime metrics → Configuration: reads settings
src/main/java/knbgulll/nbgvox/vox/data/RuntimeInfo.java - Runtime metrics → Provider registry: reads providers
src/main/java/knbgulll/nbgvox/vox/data/RuntimeInfo.java - Provider registry → Custom data provider: registers providers
src/main/java/knbgulll/nbgvox/vox/NbgVoxRegistry.java - Status page → Custom data provider: renders fields
src/main/java/knbgulll/nbgvox/vox/handler/StatusHandler.java - System logger → Rotating log writer: writes entries
src/main/java/knbgulll/nbgvox/vox/log/SystemLogger.java - User activity logger → Rotating log writer: writes entries
src/main/java/knbgulll/nbgvox/vox/log/UserLogger.java