39 lines
2.6 KiB
Markdown
39 lines
2.6 KiB
Markdown
# Advanced configuration options
|
|
|
|
These are not meant to be used under normal circumstances.
|
|
|
|
If you find yourself needing to use any of them, it would be great if you could drop us an issue
|
|
explaining why, so that we can try to come up with a better solution to address your need.
|
|
|
|
## Excluding specific classes from being instrumented
|
|
|
|
This can be used to completely silence spans from a given class/package.
|
|
|
|
Or as a quick workaround for an instrumentation bug, when byte code in one specific class is problematic.
|
|
|
|
This option should not be used lightly, as it can leave some instrumentation partially applied,
|
|
which could have unknown side-effects.
|
|
|
|
| System property | Environment variable | Purpose |
|
|
| ------------------------------ | ------------------------------ | -------------------------------------------------------------------------------------------------- |
|
|
| otel.javaagent.exclude-classes | OTEL_JAVAAGENT_EXCLUDE_CLASSES | Suppresses all instrumentation for specific classes, format is "my.package.MyClass,my.package2.\*" |
|
|
|
|
## Excluding specific classes loaders
|
|
|
|
This option can be used to exclude classes loaded by given class loaders from being instrumented.
|
|
|
|
| System property | Environment variable | Purpose |
|
|
|--------------------------------------|--------------------------------------|---------------------------------------------------------------------------------|
|
|
| otel.javaagent.exclude-class-loaders | OTEL_JAVAAGENT_EXCLUDE_CLASS_LOADERS | Ignore the specified class loaders, format is "my.package.MyClass,my.package2." |
|
|
|
|
## Running application with security manager
|
|
|
|
This option can be used to let agent run with all privileges without being affected by security policy restricting some operations.
|
|
|
|
| System property | Environment variable | Purpose |
|
|
| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------- |
|
|
| otel.javaagent.experimental.security-manager-support.enabled | OTEL_JAVAAGENT_EXPERIMENTAL_SECURITY_MANAGER_SUPPORT_ENABLED | Grant all privileges to agent code[1] |
|
|
|
|
[1] Disclaimer: agent can provide application means for escaping security manager sandbox. Do not use
|
|
this option if your application relies on security manager to run untrusted code.
|