抑制特定仪器

完全禁用代理

仅启用特定仪器

您可以禁用所有默认自动仪器，并选择性地重新启用单个仪器。这可能是为了减少启动开销或更好地控制应用的仪器。

仅启用手动仪器

您可以通过使用 -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。

抑制控制器和/或视图跨度

某些仪器（例如 Spring Web MVC 仪器）会生成 SpanKind.Internal 跨度来捕获控制器和/或视图执行。可以使用以下配置设置抑制这些跨度，而不会抑制整个仪器（这将禁用仪器对 http.route 的捕获以及父 SpanKind.Server 跨上的关联跨度名称）。

仪器跨度抑制行为

此代理仪器的一些库又会使用同样被仪器化的较低级别库。这通常会导致包含重复遥测数据的嵌套跨度。例如

• Reactor Netty HTTP 客户端仪器生成的跨度会有由 Netty 仪器生成的重复 HTTP 客户端跨度；
• AWS SDK 仪器生成的 Dynamo DB 跨度会有由其内部 HTTP 客户端库（也已仪器化）生成的子 HTTP 客户端跨度；
• Tomcat 仪器生成的跨度会有由通用 Servlet API 仪器生成的重复 HTTP 服务器跨度。

Java 代理通过检测和抑制复制遥测数据的嵌套跨度来防止这些情况。可以使用以下配置选项配置抑制行为

例如，假设我们仪器化了一个数据库客户端，该客户端内部使用 Reactor Netty HTTP 客户端；该客户端又使用 Netty。

使用默认的 semconv 抑制策略将导致 2 个嵌套的 CLIENT 跨度

• 由数据库客户端仪器生成的具有数据库客户端语义属性的 CLIENT 跨度；
• 由 Reactor Netty 仪器生成的具有 HTTP 客户端语义属性的 CLIENT 跨度。

Netty 仪器将被抑制，因为它复制了 Reactor Netty HTTP 客户端的仪器。

使用 span-kind 抑制策略将只产生一个跨度

• 由数据库客户端仪器生成的具有数据库客户端语义属性的 CLIENT 跨度。

Reactor Netty 和 Netty 仪器都将被抑制，因为它们也发出 CLIENT 跨度。

最后，使用 none 抑制策略将产生 3 个跨度

• 由数据库客户端仪器生成的具有数据库客户端语义属性的 CLIENT 跨度；
• 由 Reactor Netty 仪器生成的具有 HTTP 客户端语义属性的 CLIENT 跨度；
• 由 Netty 仪器生成的具有 HTTP 客户端语义属性的 CLIENT 跨度。