Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.1.3)

Part Number E41849-02

weblogic.management.runtime
Interface WLDFInstrumentationRuntimeMBean

All Superinterfaces:
DynamicMBean, MBeanRegistration, NotificationBroadcaster, RuntimeMBean, WebLogicMBean

public interface WLDFInstrumentationRuntimeMBean
extends RuntimeMBean

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


Method Summary
 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).
 Map getMethodInvocationStatistics()
          Map containing the method invocation statistics for this scope.
 Object getMethodInvocationStatisticsData(String expr)
          Drills down into the nested MethodInvocationStatistics Map structure and returns the object at the specified level.
 Map getMethodMemoryAllocationStatistics()
          Map containing the method memory allocation statistics for this scope.
 Object getMethodMemoryAllocationStatisticsData(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(String expr)
          Resets the nested MethodInvocationStatistics structure and reinitializes the underlying metrics.
 void resetMethodMemoryAllocationStatisticsData(String expr)
          Resets the nested MethodMemoryAllocationStatistics structure and reinitializes the underlying metrics.
 
Methods inherited from interface weblogic.management.WebLogicMBean
getMBeanInfo, getName, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent
 
Methods inherited from interface javax.management.DynamicMBean
getAttribute, getAttributes, invoke, setAttribute, setAttributes
 
Methods inherited from interface javax.management.MBeanRegistration
postDeregister, postRegister, preDeregister, preRegister
 
Methods inherited from interface javax.management.NotificationBroadcaster
addNotificationListener, getNotificationInfo, removeNotificationListener
 

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

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 Watch rule 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

Object getMethodInvocationStatisticsData(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(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

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 Watch rule 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

Object getMethodMemoryAllocationStatisticsData(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(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

Copyright 1996, 2014, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.1.3)

Part Number E41849-02