|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.management.NotificationBroadcasterSupport
com.sun.management.oss.impl.factory.measurement.JmxJVTPerformanceMonitorSession
The class JmxJVTPerformanceMonitorSession
implements the JVTPerformanceMonitorSession
interface. It is a JMX dynamic MBean that is a factory of
PerformanceMonitorJob objects (Measurement jobs) that interact with observable objects of
a data model whose interface is implemented with a PerformanceGenericModel
object. This implementation object is passed at construction time of the factory, as a parameter of the constructor.
For a better understanding of what this factory is able to do, please first of
all refer to the com.sun.management.oss.pm.measurement.JVTPerformanceMonitorSession
description page
and read at least the main description and the createPerformanceMonitorByValue()
method description.
Here after we explain what are the characteristics specific to this
implementation of the JVTPerformanceMonitorSession
interface:
Job types:
This implementation supports both possible types of jobs: PerformanceMonitorByObjectsValue.VALUE_TYPE
('by objects') jobs and PerformanceMonitorByClassesValue.VALUE_TYPE
('by classes') jobs.
Once created, the jobs are entities that live forever regardless of the availability of the underlying objects they care about. Only an order of deletion can remove a job.
For creating a 'by objects' job, you provide the factory with list of the ObjectName of the objects you want to create a measurement job on. For creating a 'by classes' job, you provide the factory with the list of classes you want to care about. A 'by classes' job listens to MBeans registration/unregistration events. If the event is about an object of a class the job handles, the job adds/removes this object from the object instance list he cares about.
Job report modes:
The jobs managed by this factory are able to run in both possible report modes: 'by
event' mode and 'by file' mode. Each job may use only one or both of the
possible report modes (at least one mode is mandatory). Supported 'by event' mode is ReportMode.EVENT_SINGLE
and supported 'by file' mode is ReportMode.FILE_SINGLE
as far as report modes are concerned
(ReportMode.FILE_MULTIPLE
and ReportMode.EVENT_MULTIPLE
are not supported by this implementation).
Thus, each generated report (included in a file or an event) is only refering to
one single job, whereas included data may be data regarding many sampling time.
For a PerformanceMonitorByClassesValue.VALUE_TYPE
('by classes')
job, if no instance of any of the classes he cares about is present, no file
report will be generated and no event will be sent until one proper object is available
(registered in the JMX server).
Job report format:
There is only one report format supported by this factory. This format is
defined like this:
Job report period:
The report period is a factor that is used to know how many sampling periods
(defined by the job granularity) the job must wait before generating an event
(if the job is a 'by event' one) containing the report(s), or before generating
an event (if the job is a 'by file' one) containing the file report url(s). For
instance, if the granularity period of a job is 30 seconds and the job is a 'by
event' as well a a 'by file' one and the report period is set to 2: sampling will occur every 30 seconds
and every minutes, an event will be fired containing 2 reports (the 'by event'
event) and at the same time, another event (the 'by file' one) will be fired and
will contain 2 urls pointing to the 2 file reports that have been generated
(these files contain the same data than the 2 embedded reports in the 'by event'
event). If the report period is set to 1, events are generated as often as the
sampling occurs and events ('by event' and 'by file' ones) contain data related
to only one sampling.
Job file reports:
Whatever the report period of a 'by file' job is, there is one file generated
for each sample the job took at each granularity period start. The path to the
generated measurement reports is defined by a property you can find at the com.sun.management.oss.impl.tools.CmsConfig
description page.
The report files respect a naming convention that is briefly described here
after:
B<sampling_period_start_time>-<sampling_period_end_time>_<originator_job_primary_key>_<originator_job_name>.xml
Date format for <sampling_period_start_time> and
<sampling_period_end_time>: yyyyMMdd.HHmmss
Here is a valid report file name example:
B20040514.133005-20040514.133010_8320c443819db375019ea173d228993b_MeasurementCIBAplication.xml
This file name format is inspired from the 3GPP TS 32.401 V5.1.0 (2002-09) specification.
The 'by file' mode of the jobs has a life time feature. That is, it is possible
to have the generated file reports being automatically deleted after a certain
amount of hours (it is also possible to have these reports never deleted). For
setting the report life time of the file reports, please refer to the
com.sun.management.oss.impl.tools.CmsConfig
description page.
Optional methods:
All the optional methods of the JVTPerformanceMonitorSession
interface are implemented in this implementation:
JVTPerformanceMonitorSessionOptionalOpt.GET_CURRENT_RESULT_REPORT
JVTPerformanceMonitorSessionOptionalOpt.RESUME_PERFORMANCE_MONITOR_BY_KEY
JVTPerformanceMonitorSessionOptionalOpt.SUSPEND_PERFORMANCE_MONITOR_BY_KEY
JVTPerformanceMonitorSessionOptionalOpt.TRY_CREATE_PERFORMANCE_MONITORS_BY_VALUES
JVTPerformanceMonitorSessionOptionalOpt.TRY_REMOVE_PERFORMANCE_MONITORS_BY_KEYS
JVTPerformanceMonitorSessionOptionalOpt.TRY_RESUME_PERFORMANCE_MONITORS_BY_KEYS
JVTPerformanceMonitorSessionOptionalOpt.TRY_SUSPEND_PERFORMANCE_MONITORS_BY_KEYS
Job queries:
This implementation supports both QueryPerformanceMonitorValue.QUERY_TYPE
and QueryByDNValue.QUERY_TYPE
query types.
Job naming:
The name of a job is not a mandatory parameter to provide at job creation time.
However, if a name is provided, it has to be unique in the context of the
factory instance. If no name is provided, the name of the job will be affected
the same value as the primary key computed for the job. Thus, a job has always a name, and the names
of the jobs are unique.
Job granularities:
Regarding the possible granularities used for the jobs, any strictly positive value is
accepted (no limitation): the getSupportedGranularities()
method is implemented
but is useless as other values returned by this method may be valid.
Copyright (c) 2001 Ericsson
Copyright (c) 2004 Sun microsystems
JVTPerformanceMonitorSession
Field Summary | |
static java.util.logging.Logger |
logger
One log for the whole session. |
static java.util.Properties |
properties
Hold the values from the properties that are given at constructor time. |
Fields inherited from interface com.sun.management.oss.pm.measurement.JVTPerformanceMonitorSession |
OSS_QOS_VERSION_R1 |
Constructor Summary | |
JmxJVTPerformanceMonitorSession()
Constructor for the JmxJVTPerformanceMonitorSession object. |
Method Summary | |
PerformanceMonitorKey |
createPerformanceMonitorByValue(PerformanceMonitorValue pmValue)
See JVTPerformanceMonitorSession.createPerformanceMonitorByValue(PerformanceMonitorValue
pmValue) .
|
java.lang.Object |
getAttribute(java.lang.String attribute_name)
See javax.management.DynamicMBean.getAttribute(String attribute_name) |
javax.management.AttributeList |
getAttributes(java.lang.String[] attributeNames)
See javax.management.DynamicMBean.getAttributes(String[] attributeNames) |
ReportFormat |
getCurrentReportFormat()
See JVTPerformanceMonitorSession.getCurrentReportFormat() .
|
CurrentResultReport |
getCurrentResultReport(PerformanceMonitorKey pmKey,
ReportFormat format)
See JVTPerformanceMonitorSession.getCurrentResultReport(PerformanceMonitorKey pmKey, ReportFormat
format) .
|
EventPropertyDescriptor |
getEventDescriptor(java.lang.String eventType)
See JVTSession.getEventDescriptor(String eventType) . |
java.lang.String[] |
getEventTypes()
See JVTSession.getEventTypes() .
|
PerformanceMonitorJob |
getJob(java.lang.String key)
Get a job from the job list. |
java.util.Enumeration |
getJobs()
Get all jobs from the job list. |
java.lang.String[] |
getManagedEntityTypes()
See JVTSession.getManagedEntityTypes() .
|
javax.management.MBeanInfo |
getMBeanInfo()
See javax.management.DynamicMBean.getMBeanInfo() |
javax.management.MBeanNotificationInfo[] |
getNotificationInfo()
Get informatrion about the notification sent by this factory. |
PerformanceAttributeDescriptor[] |
getObservableAttributes(java.lang.String observableObjectClassName)
See JVTPerformanceMonitorSession.getObservableAttributes(String
observableObjectClassName) .
|
ObservableObjectClassIterator |
getObservableObjectClasses()
See JVTPerformanceMonitorSession.getObservableObjectClasses() .
|
ObservableObjectIterator |
getObservableObjects(java.lang.String observableObjectClassName,
javax.management.ObjectName base)
See JVTPerformanceMonitorSession.getObservableObjects(String observableObjectClassName, String
base) .
|
PerformanceMonitorValue |
getPerformanceMonitorByKey(PerformanceMonitorKey pmKey,
java.lang.String[] attributes)
See JVTPerformanceMonitorSession.getPerformanceMonitorByKey(PerformanceMonitorKey pmKey, String[]
attributes) . |
PerformanceMonitorValueIterator |
getPerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKey,
java.lang.String[] attributes)
See JVTPerformanceMonitorSession.getPerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKey, String[]
attributes) . |
ReportInfoIterator |
getPerformanceReportInfo(PerformanceMonitorKey pmKey,
java.util.Calendar date)
See JVTPerformanceMonitorSession.getPerformanceReportInfo(PerformanceMonitorKey pmKey, java.util.Calendar
date) . |
java.lang.String[] |
getQueryTypes()
See JVTSession.getQueryTypes() .
|
ReportFormat[] |
getReportFormats()
See JVTPerformanceMonitorSession.getReportFormats() .
|
int[] |
getReportModes()
See JVTPerformanceMonitorSession.getReportModes() .
|
int[] |
getSupportedGranularities(PerformanceMonitorValue pmValue)
Deprecated. This method is implemented, but useless as any positive integer value will work as far as the granularity period is concerned: we do not want to limit possibilities. |
javax.management.ObjectName[] |
getSupportedObservableObjects(javax.management.ObjectName[] dnList)
See JVTPerformanceMonitorSession.getSupportedObservableObjects(ObjectName[]
dnList) . |
java.lang.String[] |
getSupportedOptionalOperations()
See JVTSession.getSupportedOptionalOperations() .
|
java.lang.String[] |
getVersion()
See JVTPerformanceMonitorSession.getVersion() . |
void |
handleNotification(javax.management.Notification notification,
java.lang.Object handback)
Get the Jobs' events and forward them to interested clients |
java.lang.Object |
invoke(java.lang.String operationName,
java.lang.Object[] params,
java.lang.String[] signature)
See javax.management.DynamicMBean.invoke(String operationName, Object[] params, String[] signature) |
ManagedEntityValue |
makeManagedEntityValue(java.lang.String valueType)
See JVTSession.makeManagedEntityValue(String valueType) .
|
PerformanceMonitorValue |
makePerformanceMonitorValue(java.lang.String value)
See JVTPerformanceMonitorSession.makePerformanceMonitorValue(String
value) . |
QueryValue |
makeQueryValue(java.lang.String type)
See JVTSession.makeQueryValue(String type) .
|
void |
postDeregister()
See javax.management.MBeanRegistration.postDeregister() |
void |
postRegister(java.lang.Boolean registrationDone)
See javax.management.MBeanRegistration.postRegister(Boolean registrationDone) |
void |
preDeregister()
See javax.management.MBeanRegistration.preDeregister() |
javax.management.ObjectName |
preRegister(javax.management.MBeanServer server,
javax.management.ObjectName name)
Allows the MBean to perform any operations it needs before being registered in the MBean server. |
void |
putJob(java.lang.String key,
PerformanceMonitorJob aPerformanceMonitorJob)
Put a job in the job list. |
ManagedEntityValueIterator |
queryManagedEntities(QueryValue query,
java.lang.String[] attrNames)
See JVTSession.queryManagedEntities(QueryValue query, String[]
attrNames) .
|
PerformanceMonitorValueIterator |
queryPerformanceMonitors(QueryValue query,
java.lang.String[] attrNames)
See JVTPerformanceMonitorSession.queryPerformanceMonitors(QueryValue query , String[]
attrNames) .
|
void |
removeJob(java.lang.String key)
Remove a job from the job list. |
void |
removePerformanceMonitorByKey(PerformanceMonitorKey pmKey)
See JVTPerformanceMonitorSession.removePerformanceMonitorByKey(PerformanceMonitorKey
pmKey) . |
void |
resumePerformanceMonitorByKey(PerformanceMonitorKey pmKey)
See JVTPerformanceMonitorSession.resumePerformanceMonitorByKey(PerformanceMonitorKey
pmKey) . |
void |
setAttribute(javax.management.Attribute attribute)
See javax.management.DynamicMBean.setAttribute(Attribute attribute) |
javax.management.AttributeList |
setAttributes(javax.management.AttributeList attributes)
See javax.management.DynamicMBean.setAttributes(AttributeList attributes) |
void |
suspendPerformanceMonitorByKey(PerformanceMonitorKey pmKey)
See JVTPerformanceMonitorSession.suspendPerformanceMonitorByKey(PerformanceMonitorKey
pmKey) . |
PerformanceMonitorKeyResult[] |
tryCreatePerformanceMonitorsByValues(PerformanceMonitorValue[] pmValues)
See JVTPerformanceMonitorSession.tryCreatePerformanceMonitorsByValues(PerformanceMonitorValue[]
pmValues) . |
PerformanceMonitorKeyResult[] |
tryRemovePerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKeys)
See JVTPerformanceMonitorSession.tryRemovePerformanceMonitorsByKeys(PerformanceMonitorKey[]
pmKeys) . |
PerformanceMonitorKeyResult[] |
tryResumePerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKeys)
See JVTPerformanceMonitorSession.tryResumePerformanceMonitorsByKeys(PerformanceMonitorKey[]
pmKeys) . |
PerformanceMonitorKeyResult[] |
trySuspendPerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKeys)
See JVTPerformanceMonitorSession.trySuspendPerformanceMonitorsByKeys(PerformanceMonitorKey[]
pmKeys) . |
Methods inherited from class javax.management.NotificationBroadcasterSupport |
addNotificationListener, removeNotificationListener, removeNotificationListener, sendNotification |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static java.util.logging.Logger logger
public static java.util.Properties properties
Constructor Detail |
public JmxJVTPerformanceMonitorSession()
Method Detail |
public java.lang.String[] getManagedEntityTypes()
JVTSession.getManagedEntityTypes()
.
This implementation supports both PerformanceMonitorByObjectsValue.VALUE_TYPE
and
PerformanceMonitorByClassesValue.VALUE_TYPE
job types.
getManagedEntityTypes
in interface JVTSession
PerformanceMonitorByObjectsValue.VALUE_TYPE
and
PerformanceMonitorByClassesValue.VALUE_TYPE
.JVTSession.getManagedEntityTypes()
public java.lang.String[] getVersion()
JVTPerformanceMonitorSession.getVersion()
.
getVersion
in interface JVTPerformanceMonitorSession
JVTPerformanceMonitorSession.getVersion()
public java.lang.String[] getSupportedOptionalOperations()
JVTSession.getSupportedOptionalOperations()
.
This implementation supports every optional operations:
JVTPerformanceMonitorSessionOptionalOpt.GET_CURRENT_RESULT_REPORT
JVTPerformanceMonitorSessionOptionalOpt.RESUME_PERFORMANCE_MONITOR_BY_KEY
JVTPerformanceMonitorSessionOptionalOpt.SUSPEND_PERFORMANCE_MONITOR_BY_KEY
JVTPerformanceMonitorSessionOptionalOpt.TRY_CREATE_PERFORMANCE_MONITORS_BY_VALUES
JVTPerformanceMonitorSessionOptionalOpt.TRY_REMOVE_PERFORMANCE_MONITORS_BY_KEYS
JVTPerformanceMonitorSessionOptionalOpt.TRY_RESUME_PERFORMANCE_MONITORS_BY_KEYS
JVTPerformanceMonitorSessionOptionalOpt.TRY_SUSPEND_PERFORMANCE_MONITORS_BY_KEYS
getSupportedOptionalOperations
in interface JVTSession
JVTPerformanceMonitorSessionOptionalOpt.GET_CURRENT_RESULT_REPORT
,
JVTPerformanceMonitorSessionOptionalOpt.RESUME_PERFORMANCE_MONITOR_BY_KEY
,
JVTPerformanceMonitorSessionOptionalOpt.SUSPEND_PERFORMANCE_MONITOR_BY_KEY
,
JVTPerformanceMonitorSessionOptionalOpt.TRY_CREATE_PERFORMANCE_MONITORS_BY_VALUES
,
JVTPerformanceMonitorSessionOptionalOpt.TRY_REMOVE_PERFORMANCE_MONITORS_BY_KEYS
,
JVTPerformanceMonitorSessionOptionalOpt.TRY_RESUME_PERFORMANCE_MONITORS_BY_KEYS
,
JVTPerformanceMonitorSessionOptionalOpt.TRY_SUSPEND_PERFORMANCE_MONITORS_BY_KEYS
.JVTSession.getSupportedOptionalOperations()
public java.lang.String[] getEventTypes()
JVTSession.getEventTypes()
.
This implementation supports both PerformanceDataEventDescriptor.OSS_EVENT_TYPE_VALUE
and PerformanceDataEventDescriptor.OSS_EVENT_TYPE_VALUE
event
types.
getEventTypes
in interface JVTSession
PerformanceDataEventDescriptor.OSS_EVENT_TYPE_VALUE
and PerformanceDataEventDescriptor.OSS_EVENT_TYPE_VALUE
.JVTSession.getEventTypes()
public EventPropertyDescriptor getEventDescriptor(java.lang.String eventType) throws java.lang.IllegalArgumentException
JVTSession.getEventDescriptor(String eventType)
.
getEventDescriptor
in interface JVTSession
eventType
- Fully qualified name of the leaf node Event interface. It can be:
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTSession.getEventDescriptor(String eventType)
public PerformanceMonitorValue makePerformanceMonitorValue(java.lang.String value) throws java.lang.IllegalArgumentException
JVTPerformanceMonitorSession.makePerformanceMonitorValue(String
value)
.
makePerformanceMonitorValue
in interface JVTPerformanceMonitorSession
value
- The name of one of the supported value types that are returned by getManagedEntityTypes()
.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTPerformanceMonitorSession.makePerformanceMonitorValue(String value)
public java.lang.String[] getQueryTypes()
JVTSession.getQueryTypes()
.
This implementation supports both QueryPerformanceMonitorValue.QUERY_TYPE
and QueryByDNValue.QUERY_TYPE
query types.
getQueryTypes
in interface JVTSession
QueryPerformanceMonitorValue.QUERY_TYPE
and
QueryByDNValue.QUERY_TYPE
.JVTSession.getQueryTypes()
public QueryValue makeQueryValue(java.lang.String type) throws java.lang.IllegalArgumentException
JVTSession.makeQueryValue(String type)
.
This implementation supports both QueryPerformanceMonitorValue.QUERY_TYPE
and QueryByDNValue.QUERY_TYPE
query types.
makeQueryValue
in interface JVTSession
type
- Fully qualified name of the leaf node QueryValue interface. It can be:
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTSession.makeQueryValue(String type)
public ReportFormat[] getReportFormats()
JVTPerformanceMonitorSession.getReportFormats()
.
Currently only one report format is supported by this implementation. See the top description of this page for futher information.
getReportFormats
in interface JVTPerformanceMonitorSession
JVTPerformanceMonitorSession.getReportFormats()
public ReportFormat getCurrentReportFormat()
JVTPerformanceMonitorSession.getCurrentReportFormat()
.
Currently only one report format is supported by this implementation. See the top description of this page for futher information.
getCurrentReportFormat
in interface JVTPerformanceMonitorSession
JVTPerformanceMonitorSession.getCurrentReportFormat()
public int[] getReportModes()
JVTPerformanceMonitorSession.getReportModes()
.
This implementation supports both ReportMode.EVENT_SINGLE
and ReportMode.FILE_SINGLE
modes.
getReportModes
in interface JVTPerformanceMonitorSession
ReportMode.EVENT_SINGLE
and ReportMode.FILE_SINGLE
.JVTPerformanceMonitorSession.getReportModes()
public ObservableObjectClassIterator getObservableObjectClasses()
JVTPerformanceMonitorSession.getObservableObjectClasses()
.
The returned classes depend on the PerformanceGenericModel
implentation object the factory is using.
getObservableObjectClasses
in interface JVTPerformanceMonitorSession
JVTPerformanceMonitorSession.getObservableObjectClasses()
public ObservableObjectIterator getObservableObjects(java.lang.String observableObjectClassName, javax.management.ObjectName base) throws java.lang.IllegalArgumentException
JVTPerformanceMonitorSession.getObservableObjects(String observableObjectClassName, String
base)
.
The returned observable objects depend on the PerformanceGenericModel
implentation object the factory is using.
getObservableObjects
in interface JVTPerformanceMonitorSession
observableObjectClassName
- The Java class name (including the package name) of the class whose
objects are to be considered.base
- The JMX pattern under which the objects are to be
considered.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTPerformanceMonitorSession.getObservableObjects(String observableObjectClassName, ObjectName base)
public javax.management.ObjectName[] getSupportedObservableObjects(javax.management.ObjectName[] dnList)
JVTPerformanceMonitorSession.getSupportedObservableObjects(ObjectName[]
dnList)
.
getSupportedObservableObjects
in interface JVTPerformanceMonitorSession
dnList
- The list of object names you want to know if they are monitorable (i.e: jobs can
be created for these objects).
dnList
parameter.JVTPerformanceMonitorSession.getSupportedObservableObjects(ObjectName[] dnList)
public PerformanceAttributeDescriptor[] getObservableAttributes(java.lang.String observableObjectClassName) throws java.lang.IllegalArgumentException
JVTPerformanceMonitorSession.getObservableAttributes(String
observableObjectClassName)
.
The returned observable attributes depend on the PerformanceGenericModel
implentation object the factory is using.
getObservableAttributes
in interface JVTPerformanceMonitorSession
observableObjectClassName
- The name of the observable object class we want to get monitorable attributes.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTPerformanceMonitorSession.getObservableAttributes(String observableObjectClassName)
public int[] getSupportedGranularities(PerformanceMonitorValue pmValue) throws java.lang.IllegalArgumentException
JVTPerformanceMonitorSession.getSupportedGranularities(PerformanceMonitorValue
pmValue)
.
This method is implemented but is useless, as the current implementation of this factory allow the use any strictly positive value for the job granularity. Thus, there is no restriction regarding the granularity except performance aspects.
getSupportedGranularities
in interface JVTPerformanceMonitorSession
pmValue
- The attributes of the measurement job except the granularity period. Currently,
the implementation of this method returns the same values, whatever the chosen job
is.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTPerformanceMonitorSession.getSupportedGranularities(PerformanceMonitorValue pmValue)
public ReportInfoIterator getPerformanceReportInfo(PerformanceMonitorKey pmKey, java.util.Calendar date) throws java.lang.IllegalArgumentException, ObjectNotFoundException
JVTPerformanceMonitorSession.getPerformanceReportInfo(PerformanceMonitorKey pmKey, java.util.Calendar
date)
.
getPerformanceReportInfo
in interface JVTPerformanceMonitorSession
pmKey
- The primary key of a measurement job, that shall be included in the reports.date
- Specifies the minimum creation date for the reports.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.
ObjectNotFoundException
- Is raised if the measurement job was not found.JVTPerformanceMonitorSession.getPerformanceReportInfo(PerformanceMonitorKey pmKey, java.util.Calendar date)
public PerformanceMonitorValue getPerformanceMonitorByKey(PerformanceMonitorKey pmKey, java.lang.String[] attributes) throws ObjectNotFoundException, java.lang.IllegalArgumentException
JVTPerformanceMonitorSession.getPerformanceMonitorByKey(PerformanceMonitorKey pmKey, String[]
attributes)
.
getPerformanceMonitorByKey
in interface JVTPerformanceMonitorSession
pmKey
- Primary key of the measurement job.attributes
- A list of the attributes to be returned.
ObjectNotFoundException
- Is raised if the measurement job was not found.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTPerformanceMonitorSession.getPerformanceMonitorByKey(PerformanceMonitorKey pmKey, String[] attributes)
public PerformanceMonitorValueIterator getPerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKey, java.lang.String[] attributes) throws FinderException, java.lang.IllegalArgumentException
JVTPerformanceMonitorSession.getPerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKey, String[]
attributes)
.
getPerformanceMonitorsByKeys
in interface JVTPerformanceMonitorSession
pmKey
- Primary keys of the measurement jobs.attributes
- A list of the attributes to be returned.
FinderException
- Is raised if one or several measurement jobs where not found.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTPerformanceMonitorSession.getPerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKey, String[] attributes)
public PerformanceMonitorValueIterator queryPerformanceMonitors(QueryValue query, java.lang.String[] attrNames) throws java.lang.IllegalArgumentException
JVTPerformanceMonitorSession.queryPerformanceMonitors(QueryValue query , String[]
attrNames)
.
This implementation supports both QueryPerformanceMonitorValue.QUERY_TYPE
and QueryByDNValue.QUERY_TYPE
query types.
queryPerformanceMonitors
in interface JVTPerformanceMonitorSession
query
- Search attributes with values to be match in each measurement job.attrNames
- A list of the attributes to be returned.
java.lang.IllegalArgumentException
- Is raised if the query type is not supported or the attribute names is not supported.JVTPerformanceMonitorSession.queryPerformanceMonitors(QueryValue query , String[] attrNames)
public PerformanceMonitorKey createPerformanceMonitorByValue(PerformanceMonitorValue pmValue) throws CreateException, DuplicateKeyException, java.lang.IllegalArgumentException
JVTPerformanceMonitorSession.createPerformanceMonitorByValue(PerformanceMonitorValue
pmValue)
.
See also the top description of this page for the supported parameters you can
use in your PerformanceMonitorValue
object parameter and futher
information.
createPerformanceMonitorByValue
in interface JVTPerformanceMonitorSession
pmValue
- The input parameters to create a measurement job.
CreateException
- Is raised if the measurement job could not be created.
DuplicateKeyException
- Is raised if a measurement job cannot be created because a measurement job with the same key already exists.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTPerformanceMonitorSession.createPerformanceMonitorByValue(PerformanceMonitorValue pmValue)
public PerformanceMonitorKeyResult[] tryCreatePerformanceMonitorsByValues(PerformanceMonitorValue[] pmValues) throws java.lang.IllegalArgumentException, UnsupportedOperationException, DuplicateKeyException
JVTPerformanceMonitorSession.tryCreatePerformanceMonitorsByValues(PerformanceMonitorValue[]
pmValues)
.
tryCreatePerformanceMonitorsByValues
in interface JVTPerformanceMonitorSession
pmValues
- The input parameters to create measurement jobs.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.
UnsupportedOperationException
- Is raised if this operation is not supported.
DuplicateKeyException
- Is raised if an measurement job cannot be created because a measurement job with the same key already exists.JVTPerformanceMonitorSession.tryCreatePerformanceMonitorsByValues(PerformanceMonitorValue[] pmValues)
public void removePerformanceMonitorByKey(PerformanceMonitorKey pmKey) throws java.lang.IllegalArgumentException, ObjectNotFoundException, RemoveException
JVTPerformanceMonitorSession.removePerformanceMonitorByKey(PerformanceMonitorKey
pmKey)
.
removePerformanceMonitorByKey
in interface JVTPerformanceMonitorSession
pmKey
- Primary key of the measurement job to be removed.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.
ObjectNotFoundException
- Is raised if the measurement job was not found.
RemoveException
- Is raied if the measurement job could not be removed.JVTPerformanceMonitorSession.removePerformanceMonitorByKey(PerformanceMonitorKey pmKey)
public PerformanceMonitorKeyResult[] tryRemovePerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKeys) throws UnsupportedOperationException, java.lang.IllegalArgumentException
JVTPerformanceMonitorSession.tryRemovePerformanceMonitorsByKeys(PerformanceMonitorKey[]
pmKeys)
.
tryRemovePerformanceMonitorsByKeys
in interface JVTPerformanceMonitorSession
pmKeys
- List of primary keys of the measurement jobs to delete.
UnsupportedOperationException
- Is raised if this operation is not supported.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTPerformanceMonitorSession.tryRemovePerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKeys)
public void suspendPerformanceMonitorByKey(PerformanceMonitorKey pmKey) throws UnsupportedOperationException, ObjectNotFoundException, java.lang.IllegalArgumentException
JVTPerformanceMonitorSession.suspendPerformanceMonitorByKey(PerformanceMonitorKey
pmKey)
.
suspendPerformanceMonitorByKey
in interface JVTPerformanceMonitorSession
pmKey
- Primary key of the measurement job to be suspended.
UnsupportedOperationException
- Is raised if this operation is not supported.
ObjectNotFoundException
- Is raised if the measurement job was not found.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTPerformanceMonitorSession.suspendPerformanceMonitorByKey(PerformanceMonitorKey pmKey)
public PerformanceMonitorKeyResult[] trySuspendPerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKeys) throws java.lang.IllegalArgumentException, UnsupportedOperationException
JVTPerformanceMonitorSession.trySuspendPerformanceMonitorsByKeys(PerformanceMonitorKey[]
pmKeys)
.
trySuspendPerformanceMonitorsByKeys
in interface JVTPerformanceMonitorSession
pmKeys
- List of primary keys of the measurement jobs to be suspended.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.
UnsupportedOperationException
- Is raised if this operation is not supported.JVTPerformanceMonitorSession.trySuspendPerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKeys)
public void resumePerformanceMonitorByKey(PerformanceMonitorKey pmKey) throws java.lang.IllegalArgumentException, UnsupportedOperationException, ObjectNotFoundException
JVTPerformanceMonitorSession.resumePerformanceMonitorByKey(PerformanceMonitorKey
pmKey)
.
resumePerformanceMonitorByKey
in interface JVTPerformanceMonitorSession
pmKey
- Primary key of the measurement job to be resumed.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.
UnsupportedOperationException
- Is raised if this operation is not supported.
ObjectNotFoundException
- Is raised if the measurement job was not found.JVTPerformanceMonitorSession.resumePerformanceMonitorByKey(PerformanceMonitorKey pmKey)
public PerformanceMonitorKeyResult[] tryResumePerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKeys) throws java.lang.IllegalArgumentException, UnsupportedOperationException
JVTPerformanceMonitorSession.tryResumePerformanceMonitorsByKeys(PerformanceMonitorKey[]
pmKeys)
.
tryResumePerformanceMonitorsByKeys
in interface JVTPerformanceMonitorSession
pmKeys
- List of primary keys of the measurement jobs to be resumed.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.
UnsupportedOperationException
- Is raised if this operation is not supported.JVTPerformanceMonitorSession.tryResumePerformanceMonitorsByKeys(PerformanceMonitorKey[] pmKeys)
public CurrentResultReport getCurrentResultReport(PerformanceMonitorKey pmKey, ReportFormat format) throws java.lang.IllegalArgumentException, UnsupportedOperationException, java.lang.IllegalStateException, ObjectNotFoundException
JVTPerformanceMonitorSession.getCurrentResultReport(PerformanceMonitorKey pmKey, ReportFormat
format)
.
This method forces a report generation with immediate data measurement. That means, that if the job is not suspended, a measurement will be done on excactly the same attributes on the same objects/classes the job is caring about. The generated report contains only data for one sampling (one only value for each attribute, one only sampling time).
getCurrentResultReport
in interface JVTPerformanceMonitorSession
pmKey
- Primary key of the measurement job.format
- Defines the report format of the current measurement values.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.
UnsupportedOperationException
- Is raised if this operation is not supported.
java.lang.IllegalStateException
- Is raised if the measurement job is suspended.
ObjectNotFoundException
- Is raised if the measurement job was not found.JVTPerformanceMonitorSession.getCurrentResultReport(PerformanceMonitorKey pmKey, ReportFormat format)
public ManagedEntityValue makeManagedEntityValue(java.lang.String valueType) throws java.lang.IllegalArgumentException
JVTSession.makeManagedEntityValue(String valueType)
.
This implementation supports both PerformanceMonitorByObjectsValue.VALUE_TYPE
and
PerformanceMonitorByClassesValue.VALUE_TYPE
job types.
makeManagedEntityValue
in interface JVTSession
valueType
- Fully qualified name of the leaf managed entity value interface. It can be:
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTSession.makeManagedEntityValue(String valueType)
public ManagedEntityValueIterator queryManagedEntities(QueryValue query, java.lang.String[] attrNames) throws java.lang.IllegalArgumentException
JVTSession.queryManagedEntities(QueryValue query, String[]
attrNames)
.
This implementation supports both QueryPerformanceMonitorValue.QUERY_TYPE
and QueryByDNValue.QUERY_TYPE
query types.
queryManagedEntities
in interface JVTSession
query
- A QueryValue object representing the query.attrNames
- Names of attributes which should be populated in the ManagedEntityValue objects returned by the ManagedEntityValueIterator.
java.lang.IllegalArgumentException
- Is raised if an arguement has a wrong format/value.JVTSession.queryManagedEntities(QueryValue query, String[] attrNames)
public javax.management.MBeanNotificationInfo[] getNotificationInfo()
getNotificationInfo
in interface javax.management.NotificationBroadcaster
public void handleNotification(javax.management.Notification notification, java.lang.Object handback)
handleNotification
in interface javax.management.NotificationListener
notification
- The notification that arrived.handback
- The cookie used by the notification emitter.public void putJob(java.lang.String key, PerformanceMonitorJob aPerformanceMonitorJob)
This method is public for other packages access purpose. However, no factory client has to call this method.
key
- Primary key of the job to store.aPerformanceMonitorJob
- The PerformanceMonitorJob
object to be stored in the job list.PerformanceMonitorJob
public PerformanceMonitorJob getJob(java.lang.String key)
This method is public for other packages access purpose. However, no factory client has to call this method.
key
- Primary key of the job to get.
PerformanceMonitorJob
object asked. Null is returned if the job not
found.PerformanceMonitorJob
public java.util.Enumeration getJobs()
This method is public for other packages access purpose. However, no factory client has to call this method.
public void removeJob(java.lang.String key)
This method is public for other packages access purpose. However, no factory client has to call this method.
key
- Primary key of the job to remove.public java.lang.Object getAttribute(java.lang.String attribute_name) throws javax.management.AttributeNotFoundException, javax.management.MBeanException, javax.management.ReflectionException
getAttribute
in interface javax.management.DynamicMBean
attribute_name
- The name of the attribute to be retrieved.
javax.management.AttributeNotFoundException
- Is raised if attribute attribute_name
is not found.
javax.management.MBeanException
- Wraps a java.lang.Exception
thrown by the MBean's getter.
javax.management.ReflectionException
- Wraps a java.lang.Exception
thrown while trying to invoke the getter.DynamicMBean.getAttribute(String attribute_name)
public void setAttribute(javax.management.Attribute attribute) throws javax.management.AttributeNotFoundException, javax.management.InvalidAttributeValueException, javax.management.MBeanException, javax.management.ReflectionException
setAttribute
in interface javax.management.DynamicMBean
attribute
- The identification of the attribute to be set and the value it is to be set to.
javax.management.AttributeNotFoundException
- Is raised if attribute attribute
is not found.
javax.management.InvalidAttributeValueException
- Is raised if attribute
has a wrong value.
javax.management.MBeanException
- raps a java.lang.Exception
thrown by the MBean's setter.
javax.management.ReflectionException
- Wraps a java.lang.Exception
thrown while trying to invoke the setter.DynamicMBean.setAttribute(Attribute attribute)
public javax.management.AttributeList getAttributes(java.lang.String[] attributeNames)
getAttributes
in interface javax.management.DynamicMBean
attributeNames
- A list of the attributes to be retrieved.
DynamicMBean.getAttributes(String[] attributeNames)
public javax.management.AttributeList setAttributes(javax.management.AttributeList attributes)
setAttributes
in interface javax.management.DynamicMBean
attributes
- A list of attributes: The identification of the attributes to be set and the values they are to be set to.
DynamicMBean.setAttributes(AttributeList attributes)
public java.lang.Object invoke(java.lang.String operationName, java.lang.Object[] params, java.lang.String[] signature) throws javax.management.MBeanException, javax.management.ReflectionException
invoke
in interface javax.management.DynamicMBean
operationName
- The name of the action to be invoked.params
- An array containing the parameters to be set when the action is invoked.signature
- An array containing the signature of the action. The class objects will be loaded through the same class loader as the one used for loading the MBean on which the action is invoked.
javax.management.MBeanException
- Wraps a java.lang.Exception
thrown by the MBean's invoked method.
javax.management.ReflectionException
- Wraps a java.lang.Exception
thrown while trying to invoke the methodDynamicMBean.invoke(String operationName, Object[] params, String[] signature)
public javax.management.MBeanInfo getMBeanInfo()
getMBeanInfo
in interface javax.management.DynamicMBean
MBeanInfo
allowing all attributes and actions exposed by this Dynamic MBean to be retrieved.DynamicMBean.getMBeanInfo()
public void postDeregister()
postDeregister
in interface javax.management.MBeanRegistration
MBeanRegistration.postDeregister()
public void postRegister(java.lang.Boolean registrationDone)
postRegister
in interface javax.management.MBeanRegistration
registrationDone
- Indicates whether or not the MBean has been successfully registered in the MBean server. The value false means that the registration phase has failed.MBeanRegistration.postRegister(Boolean registrationDone)
public void preDeregister()
preDeregister
in interface javax.management.MBeanRegistration
MBeanRegistration.preDeregister()
public javax.management.ObjectName preRegister(javax.management.MBeanServer server, javax.management.ObjectName name) throws java.lang.Exception
preRegister
in interface javax.management.MBeanRegistration
java.lang.Exception
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |