Package weblogic.management.runtime

Interface WLDFInstrumentationRuntimeMBean

All Superinterfaces:

javax.management.DynamicMBean, javax.management.MBeanRegistration, javax.management.NotificationBroadcaster, RuntimeMBean, WebLogicMBean

public interface WLDFInstrumentationRuntimeMBean
extends RuntimeMBean

This interface defines various methods for accessing runtime information about the diagnostic instrumentation system.

Method Summary

Modifier and Type	Method	Description
int	getCallJoinpointCount()	The number of affected CALL joinpoints for all classes that were inspected.
int	getClassweaveAbortCount()	Number of classes for which the class weaving aborted with some exceptional situation.
int	getExecutionJoinpointCount()	The number of affected EXECUTION joinpoints for all classes that were inspected.
int	getInspectedClassesCount()	The number of classes inspected for weaving (weaving is the insertion of diagnostic code).
long	getMaxWeavingTime()	For all classes, the weaving time in nanoseconds for the class that required the most time to process (includes the time spent both for inspection and for modification).
java.util.Map	getMethodInvocationStatistics()	Map containing the method invocation statistics for this scope.
java.lang.Object	getMethodInvocationStatisticsData(java.lang.String expr)	Drills down into the nested MethodInvocationStatistics Map structure and returns the object at the specified level.
java.util.Map	getMethodMemoryAllocationStatistics()	Map containing the method memory allocation statistics for this scope.
java.lang.Object	getMethodMemoryAllocationStatisticsData(java.lang.String expr)	Drills down into the nested MethodMemoryAllocationStatistics Map structure and returns the object at the specified level.
long	getMinWeavingTime()	For all classes, the weaving time in nanoseconds for the class that required the least time to process (includes the time spent both for inspection and for modification).
int	getModifiedClassesCount()	The number of modified classes (classes where diagnostic code has been inserted).
long	getTotalWeavingTime()	For all classes, the total weaving time in nanoseconds for processing (includes the time spent both for inspection and for modification).
void	resetMethodInvocationStatisticsData(java.lang.String expr)	Resets the nested MethodInvocationStatistics structure and reinitializes the underlying metrics.
void	resetMethodMemoryAllocationStatisticsData(java.lang.String expr)	Resets the nested MethodMemoryAllocationStatistics structure and reinitializes the underlying metrics.

Methods inherited from interface javax.management.DynamicMBean

getAttribute, getAttributes, invoke, setAttribute, setAttributes

Methods inherited from interface javax.management.MBeanRegistration

postDeregister, postRegister, preRegister

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Methods inherited from interface weblogic.management.runtime.RuntimeMBean

addPropertyChangeListener, removePropertyChangeListener

Methods inherited from interface weblogic.management.WebLogicMBean

getMBeanInfo, getName, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setName, setParent

Method Detail

getInspectedClassesCount

int getInspectedClassesCount()

The number of classes inspected for weaving (weaving is the insertion of diagnostic code).

Returns:

the number of inspected classes for weaving

getModifiedClassesCount

int getModifiedClassesCount()

The number of modified classes (classes where diagnostic code has been inserted).

Returns:

the number of modified classes

getMinWeavingTime

long getMinWeavingTime()

For all classes, the weaving time in nanoseconds for the class that required the least time to process (includes the time spent both for inspection and for modification).

Returns:

Minimum weaving time for a class in nanoseconds

getMaxWeavingTime

long getMaxWeavingTime()

For all classes, the weaving time in nanoseconds for the class that required the most time to process (includes the time spent both for inspection and for modification).

Returns:

the maximum weaving time for a class in nano-seconds

getTotalWeavingTime

long getTotalWeavingTime()

For all classes, the total weaving time in nanoseconds for processing (includes the time spent both for inspection and for modification).

Returns:

Total weaving time in nanoseconds for all classes

getExecutionJoinpointCount

int getExecutionJoinpointCount()

The number of affected EXECUTION joinpoints for all classes that were inspected. (EXECUTION joinpoints are on the callee side.)

Returns:

the number of affected EXECUTION joinpoints

getCallJoinpointCount

int getCallJoinpointCount()

The number of affected CALL joinpoints for all classes that were inspected. (CALL joinpoints are on the caller side.)

Returns:

the number of affected CALL joinpoints

getClassweaveAbortCount

int getClassweaveAbortCount()

Number of classes for which the class weaving aborted with some exceptional situation.

Returns:

Number of classes for which weaving failed with some exceptional situation

getMethodInvocationStatistics

java.util.Map getMethodInvocationStatistics()

Map containing the method invocation statistics for this scope. It is a nested Map structure. The first level Map is keyed by the fully qualified class names within the instrumentation scope. It yields another Map containing the method data within an instrumented class. The method data Map is keyed by the method name and it yields another Map structure that is keyed by the method signatures. Method signature key is represented by a comma separated list of the input parameters. Each method signature key's value is the ultimate statistics Map object that contains entries with predefined keys: count, min, max, avg, sum, sum_of_squares, and std_deviation. The value for these keys indicate the associated metric.

When specifying this attribute as part of a variable within a WLDF policy expression, you must explicitly declare the WLDFInstrumentationRuntime type. Otherwise, the system can't determine the type when validating the attribute expression, and the expression won't work.

Returns:

Map containing the method invocation statistics for this scope.

getMethodInvocationStatisticsData

java.lang.Object getMethodInvocationStatisticsData(java.lang.String expr)
                                            throws ManagementException

Drills down into the nested MethodInvocationStatistics Map structure and returns the object at the specified level.

Parameters:

expr - Expression conforming to the harvester syntax for the MethodInvocationStatistics property without the attribute name prefix.

Throws:

ManagementException

resetMethodInvocationStatisticsData

void resetMethodInvocationStatisticsData(java.lang.String expr)
                                  throws ManagementException

Resets the nested MethodInvocationStatistics structure and reinitializes the underlying metrics.

Parameters:

expr - Expression conforming to the harvester syntax for the MethodInvocationStatistics property without the attribute name prefix.

Throws:

ManagementException

getMethodMemoryAllocationStatistics

java.util.Map getMethodMemoryAllocationStatistics()

Map containing the method memory allocation statistics for this scope. It is a nested Map structure. The first level Map is keyed by the fully qualified class names within the instrumentation scope. It yields another Map containing the method data within an instrumented class. The method data Map is keyed by the method name and it yields another Map structure that is keyed by the method signatures. Method signature key is represented by a comma separated list of the input parameters. Each method signature key's value is the ultimate statistics Map object that contains entries with predefined keys: count, min, max, avg, sum, sum_of_squares, and std_deviation. The value for these keys indicate the associated metric.

When specifying this attribute as part of a variable within a WLDF policy expression, you must explicitly declare the WLDFInstrumentationRuntime type. Otherwise, the system can't determine the type when validating the attribute expression, and the expression won't work.

Returns:

Map containing the method memory allocation statistics for this scope.

getMethodMemoryAllocationStatisticsData

java.lang.Object getMethodMemoryAllocationStatisticsData(java.lang.String expr)
                                                  throws ManagementException

Drills down into the nested MethodMemoryAllocationStatistics Map structure and returns the object at the specified level.

Parameters:

expr - Expression conforming to the harvester syntax for the MethodMemoryAllocationStatistics property without the attribute name prefix.

Throws:

ManagementException

resetMethodMemoryAllocationStatisticsData

void resetMethodMemoryAllocationStatisticsData(java.lang.String expr)
                                        throws ManagementException

Resets the nested MethodMemoryAllocationStatistics structure and reinitializes the underlying metrics.

Parameters:

expr - Expression conforming to the harvester syntax for the MethodMemoryAllocationStatistics property without the attribute name prefix.

Throws:

ManagementException