禁用特定插桩

完全禁用代理

仅启用特定插桩

你可以禁用所有默认的自动插桩，并有选择地重新启用单个插桩。 这可能有助于减少启动开销，或更好地控制要应用哪些插桩。

仅启用手动插桩

你可以通过使用 -Dotel.instrumentation.common.default-enabled=false -Dotel.instrumentation.opentelemetry-api.enabled=true -Dotel.instrumentation.opentelemetry-instrumentation-annotations.enabled=true 来禁用所有自动插桩，但保留对带有 @WithSpan 的手动插桩和正常 API 交互的支持。

禁用特定代理插桩

你可以禁用代理对特定库的插桩。

注意： 使用环境变量时，破折号（-）应转换为下划线（_）。 例如，要禁用来自 akka-actor 库的跟踪，请将 OTEL_INSTRUMENTATION_AKKA_ACTOR_ENABLED 设置为 false。

禁用控制器视图 Span

某些插桩（例如 Spring Web MVC 插桩）会生成 SpanKind.Internal Span 来捕获控制器、视图的执行情况。 可以使用以下配置设置来禁用这些 Span，而无需禁用整个插桩， 禁用整个插桩还会取消该插桩对父级 SpanKind.Server Span 上 http.route 和相关 Span 名称的捕获。

插桩 Span 禁用行为

此代理所插桩的某些库会转而使用更低级别的库，而这些更低级别的库也会被插桩。 这通常会导致嵌套的 Span 包含重复的遥测数据。例如：

• Reactor Netty HTTP 客户端插桩产生的 Span 会与 Netty 插桩产生的 HTTP 客户端 Span 重复；
• AWS SDK 插桩产生的 Dynamo DB Span 会包含由其内部 HTTP 客户端库（该库也会被插桩）产生的子 HTTP 客户端 Span；
• Tomcat 插桩产生的 Span 会与通用 Servlet API 插桩产生的 HTTP 服务器 Span 重复。

Java 代理通过检测并禁用包含重复遥测数据的嵌套 Span 来防止这些情况。 可以使用以下配置选项配置禁用行为：

例如，假设我们对一个数据库客户端进行插桩，该客户端在内部使用 Reactor Netty HTTP 客户端； 而 Reactor Netty HTTP 客户端又会使用 Netty。

使用默认的 semconv 禁用策略将导致 2 个嵌套的 CLIENT Span：

• 由数据库客户端插桩发出的具有数据库客户端语义属性的 CLIENT Span；
• 由 Reactor Netty 插桩发出的具有 HTTP 客户端语义属性的 CLIENT Span；

Netty 插桩会被禁用，因为它会重复 Reactor Netty HTTP 客户端插桩。

使用 span-kind 禁用策略将仅产生 1 个 CLIENT Span：

• 由数据库客户端插桩发出的具有数据库客户端语义属性的 CLIENT Span；

Reactor Netty 和 Netty 插桩都会被禁用，因为它们也会发出 CLIENT Span。

最后，使用 none 禁用策略将产生 3 个 CLIENT Span：

• 由数据库客户端插桩发出的具有数据库客户端语义属性的 CLIENT Span；
• 由 Reactor Netty 插桩发出的具有 HTTP 客户端语义属性的 CLIENT Span；
• 由 Netty 插桩发出的具有 HTTP 客户端语义属性的 CLIENT Span；