com.sun.management.oss.pm.measurement
Interface PerformanceMonitorByObjectsValue

All Superinterfaces:
AttributeAccess, java.lang.Cloneable, ManagedEntityValue, PerformanceMonitorValue, java.io.Serializable, SerializerFactory

public interface PerformanceMonitorByObjectsValue
extends PerformanceMonitorValue

This interface is the value representation of a measurement job that monitor a set of specified attributes on a set of observable object instances.

This interface extends the PerformanceMonitorValue interface with a new attribute:

The new attributes, of the value object, are a list of observed object instances that shall be monitored and an optional list of measurement attributes, that identify what is monitored by the measurement job. If the measurement attribute list is omitted, all measurement attributes in the observed object instances will be monitored (scanned). The observable object instances should be of the same type.

Version:
0.9, 2001-10-25
Author:
Stefan Aberg
See Also:
JVTPerformanceMonitorSession

Field Summary
static java.lang.String MEASUREMENT_ATTRIBUTES
          Constant for attribute measurement attributes.
static java.lang.String OBSERVED_OBJECTS
          Constant for attribute observable object.
static java.lang.String VALUE_TYPE
          Constant that can be used to match what is returned from PerormanceMonitor::getPerformanceMonitorTypes().
 
Fields inherited from interface com.sun.management.oss.pm.measurement.PerformanceMonitorValue
GRANULARITY_PERIOD, NAME, REPORT_BY_EVENT, REPORT_BY_FILE, REPORT_FORMAT, REPORTING_PERIOD, SCHEDULE, STATE
 
Fields inherited from interface com.sun.management.oss.ManagedEntityValue
KEY
 
Method Summary
 PerformanceAttributeDescriptor[] getMeasurementAttributes()
          Returns a list of measurement attributes.
 javax.management.ObjectName[] getObservedObjects()
          Returns a list of observable object distinguished names.
 PerformanceAttributeDescriptor makePerformanceAttributeDescriptor()
          Creates a new instance of the PerformanceAttributeDescriptor interface.
 void setMeasurementAttributes(PerformanceAttributeDescriptor[] measurmentAttributeNames)
          Sets the measurement attributes to be monitored.
 void setObservedObjects(javax.management.ObjectName[] observedObjects)
          Sets the observable object that shall be monitored.
 
Methods inherited from interface com.sun.management.oss.pm.measurement.PerformanceMonitorValue
getGranularityPeriod, getName, getPerformanceMonitorKey, getReportByEvent, getReportByFile, getReportFormat, getReportPeriod, getSchedule, getState, makePerformanceMonitorKey, makeReportFormat, makeSchedule, setGranularityPeriod, setName, setPerformanceMonitorKey, setReportByEvent, setReportByFile, setReportFormat, setReportPeriod, setSchedule, setState
 
Methods inherited from interface com.sun.management.oss.ManagedEntityValue
clone, getLastUpdateVersionNumber, getManagedEntityKey, getSettableAttributeNames, makeManagedEntityKey, setLastUpdateVersionNumber, setManagedEntityKey
 
Methods inherited from interface com.sun.management.oss.AttributeAccess
getAllPopulatedAttributes, getAttributeNames, getAttributeValue, getAttributeValues, getPopulatedAttributeNames, getSupportedOptionalAttributeNames, isFullyPopulated, isPopulated, setAttributeValue, setAttributeValues, unpopulateAllAttributes, unpopulateAttribute
 
Methods inherited from interface com.sun.management.oss.SerializerFactory
getSupportedSerializerTypes, makeSerializer
 

Field Detail

VALUE_TYPE

public static final java.lang.String VALUE_TYPE
Constant that can be used to match what is returned from PerormanceMonitor::getPerformanceMonitorTypes().

See Also:
Constant Field Values

MEASUREMENT_ATTRIBUTES

public static final java.lang.String MEASUREMENT_ATTRIBUTES
Constant for attribute measurement attributes.

See Also:
Constant Field Values

OBSERVED_OBJECTS

public static final java.lang.String OBSERVED_OBJECTS
Constant for attribute observable object.

See Also:
Constant Field Values
Method Detail

makePerformanceAttributeDescriptor

public PerformanceAttributeDescriptor makePerformanceAttributeDescriptor()
Creates a new instance of the PerformanceAttributeDescriptor interface.

Returns:
PerformanceAttributeDescriptor The created object. The object is empty.

getMeasurementAttributes

public PerformanceAttributeDescriptor[] getMeasurementAttributes()
                                                          throws java.lang.IllegalStateException
Returns a list of measurement attributes.

Returns:
PerformanceAttributeDescriptor[] List of measurement attribute.
Throws:
java.lang.IllegalStateException - Is raised if the attribute is not populated.
See Also:
setMeasurementAttributes(com.sun.management.oss.pm.measurement.PerformanceAttributeDescriptor[])

setMeasurementAttributes

public void setMeasurementAttributes(PerformanceAttributeDescriptor[] measurmentAttributeNames)
                              throws java.lang.IllegalArgumentException
Sets the measurement attributes to be monitored.

The supplied measurement attribute must be supported of all monitored objects.

The measurement attributes will be validated when the value object is passed to the performance monitor bean.

If the measurement attribute list shall be omitted, an empty list must be set.

Parameters:
measurmentAttributeNames - List of measurement attribute.
Throws:
java.lang.IllegalArgumentException - Is raised if the input parameters are not valid.
See Also:
getMeasurementAttributes()

getObservedObjects

public javax.management.ObjectName[] getObservedObjects()
                                                 throws java.lang.IllegalStateException
Returns a list of observable object distinguished names.

Returns:
ObjectName[] List of observable object distinguished names.
Throws:
java.lang.IllegalStateException - Is raised if the attribute is not populated.
See Also:
setObservedObjects(javax.management.ObjectName[])

setObservedObjects

public void setObservedObjects(javax.management.ObjectName[] observedObjects)
                        throws java.lang.IllegalArgumentException
Sets the observable object that shall be monitored.

The observable objects will be validated when the value object is passed to the performance monitor bean. Only fully qualified ObjectName instances are accepted (no patterns).

The supported observable objects can be retrieved by using the PerformanceMonitor.getObservableObjects

Parameters:
observedObjects - List of observable object distinguished names.
Throws:
java.lang.IllegalArgumentException - Is raised if the input parameters are not valid.
See Also:
getObservedObjects()