APIを使った計装の拡張

Spring BootスターターとOpenTelemetry APIを組み合わせて、自動生成されたテレメトリーをカスタムスパンとメトリクスで拡張する

The content of this page may be outdated and some links may be invalid. A newer version of this page exists in English.

More information ...

To see the changes to the English page since this page was last updated: visit GitHub compare 276d7eb3..4b5381a2 and search for content/en/docs/zero-code/java/spring-boot-starter/api.md.

はじめに

すぐに使える計装に加えて、OpenTelemetry APIを使用してSpringスターターをカスタムの手動計装で拡張できます。 これにより、多くのコード変更をせずに、独自のコードに対してスパンとメトリクスを作成できます。

必要な依存関係はすでにSpring Bootスターターに含まれています。

OpenTelemetry

Spring Bootスターターは、Spring BeanとしてOpenTelemetryを利用できる特殊なケースです。 ただSpringコンポーネントにOpenTelemetryを注入するだけです。

スパン

import io.opentelemetry.api.OpenTelemetry;
import io.opentelemetry.api.trace.Tracer;

@Controller
public class MyController {
  private final Tracer tracer;

  public MyController(OpenTelemetry openTelemetry) {
    this.tracer = openTelemetry.getTracer("application");
  }
}

スパンセクションで説明されているように、Tracerを使用してスパンを作成します。

完全な例はサンプルリポジトリにあります。

メーター

import io.opentelemetry.api.OpenTelemetry;
import io.opentelemetry.api.metrics.Meter;

@Controller
public class MyController {
  private final Meter meter;

  public MyController(OpenTelemetry openTelemetry) {
    this.meter = openTelemetry.getMeter("application");
  }
}

メーターセクションで説明されているように、Meterを使用してカウンター、ゲージ、またはヒストグラムを作成します。

完全な例はサンプルリポジトリにあります。


最終更新 April 14, 2026: chore(ja): update drift status (43066858)