堆栈跟踪配置选项编辑

application_packages编辑

用于确定堆栈跟踪帧是应用程序内帧还是库帧。这允许 APM 应用程序折叠库代码的堆栈帧,并突出显示源自应用程序的堆栈帧。可以将多个根包设置为逗号分隔列表;无需配置子包。由于此设置有助于确定启动时要扫描哪些类,因此设置此选项还可以缩短启动时间。

必须设置此选项才能使用 API 注释 @CaptureTransaction@CaptureSpan

示例

大多数 Java 项目都有一个根包,例如 com.myproject。您可以使用 Java 系统属性设置应用程序包:-Delastic.apm.application_packages=com.myproject

如果您只对特定子包感兴趣,可以使用逗号将它们分隔开:-Delastic.apm.application_packages=com.myproject.api,com.myproject.impl

此配置选项的检测方面 - 指定要扫描的类 - 仅在代理启动时应用,稍后更改该值不会影响扫描的类。UI 方面,显示可以在何处折叠堆栈帧,可以随时更改。

dynamic config

默认值 类型 动态

<无>

集合

true

Java 系统属性 属性文件 环境

elastic.apm.application_packages

application_packages

ELASTIC_APM_APPLICATION_PACKAGES

stack_trace_limit (性能)编辑

将其设置为 0 将禁用堆栈跟踪收集。任何正整数都将用作要收集的帧的最大数量。将其设置为 -1 表示将收集所有帧。

dynamic config

默认值 类型 动态

50

整数

true

Java 系统属性 属性文件 环境

elastic.apm.stack_trace_limit

stack_trace_limit

ELASTIC_APM_STACK_TRACE_LIMIT

span_stack_trace_min_duration (性能)编辑

虽然这对于查找导致跨度的代码中的确切位置非常有用,但收集此堆栈跟踪确实会带来一些开销。将此选项设置为值 0ms 时,将为所有跨度收集堆栈跟踪。将其设置为正值,例如 5ms,将限制堆栈跟踪收集到持续时间等于或大于给定值的跨度,例如 5 毫秒。

要完全禁用跨度的堆栈跟踪收集,请将值设置为 -1ms

dynamic config

支持持续时间后缀 mssm。示例:5ms

默认值 类型 动态

5ms

TimeDuration

true

Java 系统属性 属性文件 环境

elastic.apm.span_stack_trace_min_duration

span_stack_trace_min_duration

ELASTIC_APM_SPAN_STACK_TRACE_MIN_DURATION