特定の計装の抑制

エージェントを完全に無効にする

特定の計装のみを有効にする

すべてのデフォルトの自動計装を無効にし、個々の計装を選択的に再有効化できます。 これは、起動時のオーバーヘッドを削減したい場合や、どの計装を適用するかをより細かく制御したい場合に便利です。

手動計装のみを有効にする

すべての自動計装を抑制しつつ、@WithSpan や通常の API 操作による手動計装をサポートするには、-Dotel.instrumentation.common.default-enabled=false -Dotel.instrumentation.opentelemetry-api.enabled=true -Dotel.instrumentation.opentelemetry-instrumentation-annotations.enabled=true を使用します。

特定のエージェント計装の抑制

特定のライブラリに対するエージェント計装を抑制できます。

注意: 環境変数を使用する場合、ダッシュ（-）はアンダースコア（_）に変換する必要があります。 たとえば、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 クライアントを使用するデータベースクライアントを計装し、さらにその Reactor Netty が Netty を使用しているとします。

デフォルトの semconv 抑制戦略を使用すると、2 つのネストされた CLIENT スパンが生成されます。

• データベースクライアント計装によって出力された、データベースクライアントのセマンティック属性を持つ CLIENT スパン。
• Reactor Netty 計装によって出力された、HTTP クライアントのセマンティック属性を持つ CLIENT スパン。

Netty 計装は、Reactor Netty HTTP クライアント計装と重複するため抑制されます。

抑制戦略 span-kind を使用すると、スパンは 1 つだけになります。

• データベースクライアント計装によって出力された、データベースクライアントのセマンティック属性を持つ CLIENT スパン。

Reactor Netty と Netty の両方の計装は、同じく CLIENT スパンを出力するため抑制されます。

最後に、抑制戦略 none を使用すると、3 つのスパンが生成されます。

• データベースクライアント計装によって出力された、データベースクライアントのセマンティック属性を持つ CLIENT スパン。
• Reactor Netty 計装によって出力された、HTTP クライアントのセマンティック属性を持つ CLIENT スパン。
• Netty 計装によって出力された、HTTP クライアントのセマンティック属性を持つ CLIENT スパン。