WLDFInstrumentationMonitorBean

Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

This interface defines a diagnostic monitor, which is applied at the specified locations within the included classes in an instrumentation scope.

           
Since9.0.0.0
Security rolesThe following roles have read, write, and invoke permission for all non-encrypted attributes and operations in this MBean:
  • Deployer
Fully Qualified Interface NameIf you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.diagnostics.descriptor.WLDFInstrumentationMonitorBean
Factory Methods
Additional Access Points In addition to accessing this MBean by invoking a factory method, you can also access this MBean from the following MBean attributes:

    Attributes

    This section describes the following attributes:

    Actions

    The diagnostic actions attached to this monitor. Actions are relevant only for delegating and custom monitors. Valid actions are: TraceAction, DisplayArgumentsAction, MethodInvocationStatisticsAction, MethodMemoryAllocationStatisticsAction, StackDumpAction, ThreadDumpAction, TraceElapsedTimeAction, and TraceMemoryAllocationAction.

           
    Privileges Read/Write
    Typeclass java.lang.String[]

    Description

    Optional description of this monitor.

           
    Privileges Read/Write
    Typejava.lang.String

    DyeFilteringEnabled

    Specifies whether dye filtering is enabled for the diagnostic actions associated with this monitor.

           
    Privileges Read/Write
    Typeboolean

    DyeMask

    The dye mask for all diagnostic actions associated with this monitor.

           
    Privileges Read/Write
    Typejava.lang.String

    Enabled

    Specifies whether the monitor and its associated diagnostics actions are enabled.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    Excludes

    Pattern expressions for classes that will be excluded for this instrumentation monitor. If specified, classes matching given patterns will not be instrumented with this monitor.

    For more information, see:

           
    Privileges Read/Write
    Typeclass java.lang.String[]

    Id

    Return the unique id of this bean instance.

           
    Privileges Read only
    Typelong
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

    Includes

    Pattern expressions for classes that are included for this instrumentation monitor. If specified, only included classes will be instrumented with this monitor. If not specified, all classes loaded within the application and which are not explicitly excluded are eligible for instrumentation with this monitor.

    A pattern can end with an asterisk (*), in which case it will match with all classes whose fully qualified classname starts with the prefix of the pattern. For example, weblogic.rmi.* will match with all classes in weblogic.rmi and its subpackages.

    For more information, see:

           
    Privileges Read/Write
    Typeclass java.lang.String[]

    LocationType

    Attached actions are applied at selected locations: before, after, or around pointcuts. This is relevant only for custom monitors. (A location where diagnostic code is added is called a diagnostic joinpoint. A set of joinpoints, identified by an expression, is called a pointcut.)

    Once a location type is set, it cannot be changed.

           
    Privileges Read/Write
    Typejava.lang.String
    Default Valuebefore
    Legal Values
    • before
    • after
    • around

    Name

    The name of the WebLogic Diagnostic Framework (WLDF) bean.

           
    Privileges Read only
    Typejava.lang.String

    Pointcut

    The pointcut expression for this monitor. (A location where diagnostic code is added is called a diagnostic joinpoint. A set of joinpoints, identified by an expression, is called a pointcut.)

    Setting a pointcut expression is relevant only for custom monitors; for standard and delegating monitors, this definition is implicitly defined by WLDF.

    Once a pointcut expression is set, it cannot be changed.

           
    Privileges Read/Write
    Typejava.lang.String

    Properties

    Properties for this monitor. Properties are name=value pairs, one pair per line. For example, USER1=foo ADDR1=127.0.0.1.

           
    Privileges Read/Write
    Typejava.lang.String

    Operations

    This section describes the following operations:

      isSet

      Return true if the given property has been explicitly set in this bean.

         
      Operation Name"isSet"
      ParametersObject [] {  propertyName }

      where:

      • propertyName is an object of type java.lang.String that specifies:

        property to check
      SignatureString [] { "java.lang.String" }
      Returns boolean
      Exceptions
      • java.lang.IllegalArgumentException
        IllegalArgumentException if propertyName is not a recognized property

      unSet

      Restore the given property to its default value.

         
      Operation Name"unSet"
      ParametersObject [] {  propertyName }

      where:

      • propertyName is an object of type java.lang.String that specifies:

        property to restore
      SignatureString [] { "java.lang.String" }
      Returns void
      Exceptions
      • java.lang.IllegalArgumentException
        UnsupportedOperationException if called on a runtime implementation.