sun.jvmstat.perfdata.monitor.v1_0

Class PerfDataBuffer

java.lang.Object

sun.jvmstat.perfdata.monitor.PerfDataBufferImpl

sun.jvmstat.perfdata.monitor.v1_0.PerfDataBuffer

public class PerfDataBuffer
extends PerfDataBufferImpl

The concrete implementation of version 1.0 of the HotSpot PerfData Instrumentation buffer. This class is responsible for parsing the instrumentation memory and constructing the necessary objects to represent and access the instrumentation objects contained in the memory buffer.

Since:

1.5

Author:

Brian Doherty

See Also:

AbstractPerfDataBuffer

Field Summary

Fields inherited from class sun.jvmstat.perfdata.monitor.PerfDataBufferImpl

aliasCache, aliasMap, buffer, lvmid, monitors

Constructor Summary

Constructors

Constructor and Description
PerfDataBuffer(ByteBuffer buffer, int lvmid) Construct a PerfDataBufferImpl instance.

Method Summary

Modifier and Type	Method and Description
protected void	buildMonitorMap(Map<String,Monitor> map) build the map of Monitor objects.
protected void	buildPseudoMonitors(Map<String,Monitor> map) Build the pseudo monitors used to map the prolog data into counters.
protected MonitorStatus	getMonitorStatus(Map<String,Monitor> map) get the list of inserted and removed monitors since last called.
protected void	getNewMonitors(Map<String,Monitor> map) get the new Monitor objects from the Map of Monitor objects.
protected Monitor	getNextMonitorEntry() method to extract the next monitor entry from the instrumentation memory.
protected void	kludge(Map<String,Monitor> map) method to make adjustments for known counter problems.
protected Monitor	pollFor(Map<String,Monitor> map, String name, long timeLimit) Method to poll the instrumentation memory for a counter with the given name.
protected void	synchWithTarget(Map<String,Monitor> map) Method to provide a gross level of synchronization with the target monitored jvm.

Methods inherited from class sun.jvmstat.perfdata.monitor.PerfDataBufferImpl

findByAlias, findByName, findByPattern, getBytes, getCapacity, getLocalVmId, getMonitorStatus

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PerfDataBuffer

public PerfDataBuffer(ByteBuffer buffer,
                      int lvmid)
               throws MonitorException

Construct a PerfDataBufferImpl instance.

This class is dynamically loaded by AbstractPerfDataBuffer.createPerfDataBuffer(java.nio.ByteBuffer, int), and this constructor is called to instantiate the instance.

Parameters:

buffer - the buffer containing the instrumentation data

lvmid - the Local Java Virtual Machine Identifier for this instrumentation buffer.

Throws:

MonitorException

Method Detail

buildMonitorMap

protected void buildMonitorMap(Map<String,Monitor> map)
                        throws MonitorException

build the map of Monitor objects.

Specified by:

buildMonitorMap in class PerfDataBufferImpl

Parameters:

map - the map of Monitors.

Throws:

MonitorException - Thrown if communications errors occur while communicating with the target.

getNewMonitors

protected void getNewMonitors(Map<String,Monitor> map)
                       throws MonitorException

get the new Monitor objects from the Map of Monitor objects.

Specified by:

getNewMonitors in class PerfDataBufferImpl

Parameters:

map - the map of Monitors.

Throws:

MonitorException - Thrown if communications errors occur while communicating with the target.

getMonitorStatus

protected MonitorStatus getMonitorStatus(Map<String,Monitor> map)
                                  throws MonitorException

get the list of inserted and removed monitors since last called.

Specified by:

getMonitorStatus in class PerfDataBufferImpl

Parameters:

map - the map of Monitors.

Throws:

MonitorException - Thrown if communications errors occur while communicating with the target.

buildPseudoMonitors

protected void buildPseudoMonitors(Map<String,Monitor> map)

Build the pseudo monitors used to map the prolog data into counters.

synchWithTarget

protected void synchWithTarget(Map<String,Monitor> map)
                        throws MonitorException

Method to provide a gross level of synchronization with the target monitored jvm. gross synchronization works by polling for the hotspot.rt.hrt.ticks counter, which is the last counter created by the StatSampler initialization code. The counter is updated when the watcher thread starts scheduling tasks, which is the last thing done in vm initialization.

Throws:

MonitorException

pollFor

protected Monitor pollFor(Map<String,Monitor> map,
                          String name,
                          long timeLimit)
                   throws MonitorException

Method to poll the instrumentation memory for a counter with the given name. The polling period is bounded by the timeLimit argument.

Throws:

MonitorException

kludge

protected void kludge(Map<String,Monitor> map)

method to make adjustments for known counter problems. This method depends on the availability of certain counters, which is generally guaranteed by the synchWithTarget() method.

getNextMonitorEntry

protected Monitor getNextMonitorEntry()
                               throws MonitorException

method to extract the next monitor entry from the instrumentation memory. assumes that nextEntry is the offset into the byte array at which to start the search for the next entry. method leaves next entry pointing to the next entry or to the end of data.

Throws:

MonitorException