OpenTelemetry で Spring ネイティブイメージアプリケーションを観測する

Blog posts are not updated after publication. This post is more than a year old, so its content may be outdated, and some links may be invalid. Cross-verify any information before relying on it.

OpenTelemetry Java エージェントは、Java アプリケーションを計装する便利で確立された方法です。 しかし、現時点では GraalVM ネイティブイメージでは使用できません。

そこで、Spring Boot ネイティブイメージアプリケーションのための簡単でシームレスな方法を提供するために、OpenTelemetry Java のコントリビューターは既存の OpenTelemetry Spring Boot スターターを改善し、Spring Boot ネイティブイメージアプリケーションで適切に動作するようにしました。 詳しくはこの先をお読みください!

ここ数か月の歴史

OpenTelemetry Spring Boot スターターを使うと、バイトコード計装なしでアプリケーションに OpenTelemetry を追加できます。 OpenTelemetry Java のコントリビューターは、これを利用して Spring Boot ネイティブイメージを計装しました。 プロジェクトにスターターの依存関係を追加するだけで、ログ(ここ数か月で追加されたもの)、スパン、メトリクスの OTLP エクスポートと、Spring HTTP フレームワークの自動計装(ここ数か月で Spring Boot 3 で動作するよう更新されたもの)をすぐに利用できます。

<dependencies>
  <dependency>
    <groupId>io.opentelemetry.instrumentation</groupId>
    <artifactId>opentelemetry-spring-boot-starter</artifactId>
    <version>1.32.0-alpha</version>
  </dependency>
</dependencies>

さらに可視性を高めるために、スターターは計装ライブラリと組み合わせることができます。 この目的のために、OpenTelemetry Java のコントリビューターは JDBC(データベース)とロギングの計装ライブラリを改善しました。 たとえば、Logback ロギングライブラリについては、ネイティブモードでライブラリが動作するよう GraalVM 設定を追加しました1。

さらに、スターターでのロギングおよびデータベース計装のセットアップに必要な設定を削減する作業も行いました。 たとえば、アプリケーションが DataSource Bean を宣言していない場合、application.properties ファイルに2つのプロパティを追加するだけでデータベース計装を有効にできます。

spring.datasource.url=jdbc:otel:h2:mem:db
spring.datasource.driver-class-name=io.opentelemetry.instrumentation.jdbc.OpenTelemetryDriver

詳しくは、Spring Boot スターターをご覧ください。 opentelemetry-java-examples/spring-native を使って Spring Boot ネイティブイメージアプリケーションを実行し、生成されたログや HTTP およびデータベースのテレメトリーデータを確認できます。

最後に、OpenTelemetry Java のコントリビューターは、ネイティブモード実行に関連するリグレッションを検出するために、OpenTelemetry Java プロジェクトに GraalVM ネイティブの自動テストを追加しました。

次のステップ

OpenTelemetry Java のコントリビューターは、ロギングおよびデータベースの計装設定の自動化を実現できると期待しています。

OpenTelemetry Spring Boot スターターを試してみた方は、GitHub ディスカッションや #otel-java CNCF Slack チャンネルで、感想や体験をぜひ共有してください。


  1. Spring Boot ネイティブイメージアプリケーションは Log4j2 ロギングライブラリをサポートしていません。 ↩︎