com.newrelic.agent.config

Interface ClassTransformerConfig

All Superinterfaces:

Config

public interface ClassTransformerConfig
extends Config

Method Summary

Modifier and Type	Method and Description
boolean	computeFrames()
java.util.Set<java.lang.String>	getClassloaderDelegationExcludes()
java.util.Set<java.lang.String>	getClassloaderDelegationIncludes()
java.util.Set<java.lang.String>	getClassloaderExclusions()
java.util.Set<java.lang.String>	getExcludes()
AnnotationMatcher	getIgnoreApdexAnnotationMatcher()
AnnotationMatcher	getIgnoreTransactionAnnotationMatcher()
java.util.Set<java.lang.String>	getIncludes()
Config	getInstrumentationConfig(java.lang.String implementationTitle)
java.util.Collection<java.lang.String>	getJdbcStatements()
int	getMaxPreValidatedClassLoaders() Returns the maximum number of classloaders to run through the "optimized" weave package path.
long	getShutdownDelayInNanos() Stop class transformation after this many nanoseconds.
AnnotationMatcher	getTraceAnnotationMatcher()
boolean	isBuiltinExtensionEnabled()
boolean	isCustomTracingEnabled()
boolean	isDefaultInstrumentationEnabled()
boolean	isDefaultMethodTracingEnabled()
boolean	isEnabled()
boolean	isGrantPackageAccess() True means the agent should instrument ClassLoader.checkPackageAccess(java.lang.Class<?>, java.security.ProtectionDomain) to bypass the call to SecurityManager.checkPackageAccess(java.lang.String) for weaved classes.
boolean	isWeavePackageEnabled(com.newrelic.weave.weavepackage.WeavePackageConfig weavePackageConfig) Indicates whether the agent should load the specified weave package.
boolean	preMatchWeaveMethods() Returns true when we should attempt to "pre-match" incoming class loads by comparing the method signatures of the class against all of the possible method signatures in our weave packages.
boolean	preValidateWeavePackages() Returns true when we should take the "optimized" path for reducing the number of weave packages that we should check during each classload.

Methods inherited from interface com.newrelic.agent.config.Config

getProperty, getProperty

Method Detail

isCustomTracingEnabled

boolean isCustomTracingEnabled()

getExcludes

java.util.Set<java.lang.String> getExcludes()

getIncludes

java.util.Set<java.lang.String> getIncludes()

getClassloaderExclusions

java.util.Set<java.lang.String> getClassloaderExclusions()

getClassloaderDelegationExcludes

java.util.Set<java.lang.String> getClassloaderDelegationExcludes()

getClassloaderDelegationIncludes

java.util.Set<java.lang.String> getClassloaderDelegationIncludes()

isDefaultInstrumentationEnabled

boolean isDefaultInstrumentationEnabled()

isBuiltinExtensionEnabled

boolean isBuiltinExtensionEnabled()

computeFrames

boolean computeFrames()

Returns:

true if ASM should compute stack map frames.

getShutdownDelayInNanos

long getShutdownDelayInNanos()

Stop class transformation after this many nanoseconds.

Returns:

the number of nanoseconds to delay before stopping class transformation, or -1 if never stop

isEnabled

boolean isEnabled()

getJdbcStatements

java.util.Collection<java.lang.String> getJdbcStatements()

getIgnoreTransactionAnnotationMatcher

AnnotationMatcher getIgnoreTransactionAnnotationMatcher()

getIgnoreApdexAnnotationMatcher

AnnotationMatcher getIgnoreApdexAnnotationMatcher()

getTraceAnnotationMatcher

AnnotationMatcher getTraceAnnotationMatcher()

getMaxPreValidatedClassLoaders

int getMaxPreValidatedClassLoaders()

Returns the maximum number of classloaders to run through the "optimized" weave package path. This allows us to get the benefits of optimizing for apps with a small number of classloaders while ensuring that we don't end up trying to validate too many dynamic classloaders.

Returns:

the maximum number of classloaders to pre-validate weave packages for

preValidateWeavePackages

boolean preValidateWeavePackages()

Returns true when we should take the "optimized" path for reducing the number of weave packages that we should check during each classload. For well-behaved (non-dynamic) classloaders the optimized path generally works well, however in the dynamic case this setting can end up having extremely detrimental affects to the startup time of the agent. This should be disabled by default.

Returns:

true when prevalidation of weave packages should happen for each classloader

preMatchWeaveMethods

boolean preMatchWeaveMethods()

Returns true when we should attempt to "pre-match" incoming class loads by comparing the method signatures of the class against all of the possible method signatures in our weave packages. This allows us to quickly filter out classes that we know will never match (because there are no matching method descriptors) in order to reduce the likelihood of deadlocks as well as improving startup & runtime. By default this is enabled but it can be disabled if unforeseen problems arise.

Returns:

true when we should attempt to pre-match classes based on method signatures, false otherwise.

isGrantPackageAccess

boolean isGrantPackageAccess()

True means the agent should instrument ClassLoader.checkPackageAccess(java.lang.Class<?>, java.security.ProtectionDomain) to bypass the call to SecurityManager.checkPackageAccess(java.lang.String) for weaved classes.

getInstrumentationConfig

Config getInstrumentationConfig(java.lang.String implementationTitle)

isWeavePackageEnabled

boolean isWeavePackageEnabled(com.newrelic.weave.weavepackage.WeavePackageConfig weavePackageConfig)

Indicates whether the agent should load the specified weave package.

Parameters:

weavePackageConfig - Weave package configuration (from module's MANIFEST)

Returns:

whether the agent should load the specified weave package

isDefaultMethodTracingEnabled

boolean isDefaultMethodTracingEnabled()