GlassFish Wiki : MonitoringReference

Engineering

External

Blogs

Management API - Public APIs and annotations - external to glassfish

Probe Provider annotations, Stats Provider Manager API** Use to define Probe Providers
- Use to register with GlassFish Monitoring Framework
Statistic APIs - standard Statistic objects returned by the StatsProvider getSomeStatistic methods.

Monitoring API - public APIs

v3/common/glassfish-api/src/main/java/org/glassfish/api/monitoring
- ContainerMonitoring.java - for pluggability. Refer to How to Create a Pluggable Container

Monitoring Infrastructure

v3/admin/monitor/src/main/java/org/glassfish/admin/monitor
- MonitoringBootstrap.java - Discovers probe providers. Listens/handles monitoring configuration.
- StatsProviderManagerDelegateImpl.java - Creates monitoring tree. Registers StatsProviders with Flashlight, GMBAL.
- StatsProviderRegistry.java

Tree Node API/Implementation
- v3/admin/monitor/src/main/java/org/glassfish/flashlight/
- v3/common/internal-api/src/main/java/org/glassfish/flashlight/

Reporter for asadmin get -m command
- v3/core/kernel/src/main/java/com/sun/enterprise/v3/admin/MonitoringReporter.java

AMX** AMX loads MBeans (all MBeans or none) lazily in response to:
- - an MEJB connection
  - JMXConnector client connection
  - explicit call to bootAMX()
  - AmxPref.getAutoLoad() is true

BTrace - byte code instrumentation - http://kenai.com/projects/btrace/pages/DeveloperGuide
GMBAL - APIs/annotations to create AMX MBeans - http://gmbal.kenai.com/

You can step through with the Netbeans debugger in the monitoring code, except in the flashlight area and on a probe. The JVM will crash.
Set monitoring logging level to FINE in logging.properties
javax.enterprise.system.tools.monitor.level=FINE
Add jvm option to server-config domain.xml to turn on BTrace debugging
<jvm-options>-javaagent:<gf install>/glassfish/target/glassfish3/glassfish/lib/monitor/btrace-agent.jar=dumpClasses=true,dumpDir=c:\tmp\dump2,debug=true,unsafe=true,noServer=true</jvm-options>
GMBAL debugging - In v3/admin/monitor/src/main/java/org/glassfish/admin/monitor/StatsProviderManagerDelegateImpl.java at line 722, you can change debug to true
- mom.setJMXRegistrationDebug(false);

Admin Devtests
{{cd appserv-tests/devtests/admin/cli
ant -Dteststorun=monitoring clean all}}
Module-specific Devtests