At the core of Grizzly monitoring are three simple artifacts in the org.glassfish.grizzly.monitoring package. The first being called MonitoringAware which denotes an entity may be monitored:

  1 /**
  2  * General interface for the objects, which could be monitored during the lifecycle.
  3  * 
  4  * @author Alexey Stashok
  5  */
  6 public interface MonitoringAware<E> {
  7     /**
  8      * Return the object associated {@link MonitoringConfig}.
  9      *
 10      * @return the object associated {@link MonitoringConfig}.
 11      */
 12     MonitoringConfig<E> getMonitoringConfig();
 13 }

Entities such a MemoryManager, Transport, etc are all MonitoringAware. As seen by the interface definition, all MonitoringAware entities return a MonitoringConfig object with which you can register monitoring probes.

  1 /**
  2  * General monitoring configuration interface.
  3  *
  4  * @author Alexey Stashok
  5  */
  6 public interface MonitoringConfig<E> {
  7     /**
  8      * Add the monitoring probes, which will be notified about object's lifecycle events.
  9      *
 10      * @param probes the monitoring probes.
 11      */
 12     public void addProbes(E... probes);
 13 
 14     /**
 15      * Remove the monitoring probes.
 16      *
 17      * @param probes the monitoring probes.
 18      */
 19     public boolean removeProbes(E... probes);
 20 
 21     /**
 22      * Get the the monitoring probes, which are registered on the objet.
 23      * Please note, it's not appropriate to modify the returned array's content.
 24      * Please use {@link #addProbes(Object[])} and
 25      * {@link #removeProbes(Object[])} instead.
 26      *
 27      * @return the the monitoring probes, which are registered on the object.
 28      */
 29     public E[] getProbes();
 30 
 31     /**
 32      * Removes all the monitoring probes, which are registered on the object.
 33      */
 34     public void clearProbes();
 35 }
 36 

Since MonitoringConfig is really nothing more than a simplified collection, Grizzly provides a default implementation called org.glassfish.grizzly.monitoring.MonitoringConfigImpl. This should be able to satisfied most developer needs.

Monitoring probes, as seen in the code example above, can be of any type. Grizzly provides probe interfaces for all MonitoringAware entites within the framework.