Package weblogic.diagnostics.descriptor

Interface WLDFInstrumentationMonitorBean

All Superinterfaces:

SettableBean, WLDFBean

public interface WLDFInstrumentationMonitorBean
extends WLDFBean

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

Access limited to the following security roles:

Deployer

Method Summary

Modifier and Type	Method	Description
java.lang.String[]	getActions()	The diagnostic actions attached to this monitor.
java.lang.String	getDescription()	Optional description of this monitor.
java.lang.String	getDyeMask()	The dye mask for all diagnostic actions associated with this monitor.
java.lang.String[]	getExcludes()	Pattern expressions for classes that will be excluded for this instrumentation monitor.
java.lang.String[]	getIncludes()	Pattern expressions for classes that are included for this instrumentation monitor.
java.lang.String	getLocationType()	Attached actions are applied at selected locations: before, after, or around pointcuts.
java.lang.String	getPointcut()	The pointcut expression for this monitor.
java.lang.String	getProperties()	Properties for this monitor.
boolean	isDyeFilteringEnabled()	Specifies whether dye filtering is enabled for the diagnostic actions associated with this monitor.
boolean	isEnabled()	Specifies whether the monitor and its associated diagnostics actions are enabled.
void	setActions(java.lang.String[] actions)	Sets the value of the Actions attribute.
void	setDescription(java.lang.String description)	Sets the value of the Description attribute.
void	setDyeFilteringEnabled(boolean enable)	Sets the value of the DyeFilteringEnabled attribute.
void	setDyeMask(java.lang.String dyeMask)	Set the value of the DyeMask attribute.
void	setEnabled(boolean value)	Sets the value of the Enabled attribute.
void	setExcludes(java.lang.String[] expr)	Sets the value of the Excludes attribute.
void	setIncludes(java.lang.String[] expr)	Sets the value of the Includes attribute.
void	setLocationType(java.lang.String locationType)	Sets the value of the LocationType attribute.
void	setPointcut(java.lang.String pointcut)	Sets the value of the Pointcut attribute.
void	setProperties(java.lang.String properties)	Sets the value of the Properties attribute.

Methods inherited from interface weblogic.diagnostics.descriptor.WLDFBean

getId, getName

Method Detail

getDescription

java.lang.String getDescription()

Optional description of this monitor.

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setDescription

void setDescription(java.lang.String description)

Sets the value of the Description attribute.

See Also:

getDescription()

isEnabled

boolean isEnabled()

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

Returns:

True if monitor is enabled

Default Value:

true

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setEnabled

void setEnabled(boolean value)

Sets the value of the Enabled attribute.

Parameters:

value - A boolean value that indicates whether this monitor and its associated diagnostics actions are enabled.

See Also:

isEnabled()

getDyeMask

java.lang.String getDyeMask()

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

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setDyeMask

void setDyeMask(java.lang.String dyeMask)

Set the value of the DyeMask attribute.

Parameters:

dyeMask - The dye mask to be applied to all diagnostic action within the scope

See Also:

getDyeMask()

isDyeFilteringEnabled

boolean isDyeFilteringEnabled()

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

Returns:

True, if dye filtering is enabled for the monitor

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setDyeFilteringEnabled

void setDyeFilteringEnabled(boolean enable)

Sets the value of the DyeFilteringEnabled attribute.

Parameters:

enable - If true, enable dye filtering; disable otherwise.

See Also:

isDyeFilteringEnabled()

getProperties

java.lang.String getProperties()

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

Returns:

properties associated with this monitor

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setProperties

void setProperties(java.lang.String properties)

Sets the value of the Properties attribute.

Parameters:

properties - New properties of the monitor

See Also:

getProperties()

getActions

java.lang.String[] getActions()

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.

Returns:

Diagnostic actions attached to the delegating or custom monitor

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setActions

void setActions(java.lang.String[] actions)

Sets the value of the Actions attribute.

Parameters:

actions - Array of action names to be attached to the delegating/custom monitor

See Also:

getActions()

getLocationType

java.lang.String getLocationType()

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.

Returns:

location type

Default Value:

"before"

setLocationType

void setLocationType(java.lang.String locationType)

Sets the value of the LocationType attribute.

Parameters:

locationType - The location type for the actions attached to this monitor.

See Also:

getLocationType()

Valid Values:

"before", "after", "around"

getPointcut

java.lang.String getPointcut()

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.

Returns:

Pointcut expression for the custom monitor.

setPointcut

void setPointcut(java.lang.String pointcut)

Sets the value of the Pointcut attribute.

Parameters:

pointcut - Pointcut expression for the monitor

See Also:

getPointcut()

getIncludes

java.lang.String[] getIncludes()

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.

Returns:

The patterns containing the names of included classes

See Also:

getExcludes()

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setIncludes

void setIncludes(java.lang.String[] expr)

Sets the value of the Includes attribute.

Parameters:

expr - String array of expressions specifying the classes to be included in the instrumentation

See Also:

getIncludes()

getExcludes

java.lang.String[] getExcludes()

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.

Returns:

The patterns containing the names of excluded classes; for example, com.foo.bar.*

See Also:

getIncludes()

Changes to this property are dynamic and thus take effect immediately without restarting the server or partition.

setExcludes

void setExcludes(java.lang.String[] expr)

Sets the value of the Excludes attribute.

Parameters:

expr - String array containing the pattern expressions for the excluded classes

See Also:

getExcludes()