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 チャンネルで、感想や体験をぜひ共有してください。
Spring Boot ネイティブイメージアプリケーションは Log4j2 ロギングライブラリをサポートしていません。 ↩︎