はじめに
The content of this page may be outdated and some links may be invalid. A newer version of this page exists in English. To see the changes to the English page since this page was last updated: visit GitHub compare 276d7eb3..f49ec57e and search for More information ...
content/en/docs/zero-code/java/spring-boot-starter/getting-started.md.
Spring Bootアプリケーションを計装するために、Javaエージェントを使用することもできます。 長所と短所については、Javaゼロコード計装を参照してください。
互換性
OpenTelemetry Spring Bootスターターは、Spring Boot 2.6+および3.1+、そしてSpring Bootネイティブイメージアプリケーションで動作します。 opentelemetry-java-examples/spring-nativeリポジトリには、OpenTelemetry Spring Bootスターターを使用して計装されたSpring Bootネイティブイメージアプリケーションの例が含まれています。
依存関係の管理
Bill of Material(BOM)は、依存関係(推移的なものを含む)のバージョンが整合していることを保証します。
OpenTelemetryスターターを使用する際は、すべてのOpenTelemetry依存関係のバージョン整合性を確保するために、opentelemetry-instrumentation-bom BOMをインポートする必要があります。
Mavenを使用する場合は、プロジェクト内の他のBOMよりも前にOpenTelemetry BOMをインポートしてください。 たとえば、spring-boot-dependencies BOMをインポートする場合は、OpenTelemetry BOMの後に宣言する必要があります。
Gradleは依存関係の最新バージョンを選択するため、BOMの順序は重要ではありません。
以下の例は、Mavenを使用してOpenTelemetry BOMをインポートする方法を示しています。
<dependencyManagement> <dependencies> <dependency> <groupId>io.opentelemetry.instrumentation</groupId> <artifactId>opentelemetry-instrumentation-bom</artifactId> <version>2.20.1</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> GradleとSpring Bootでは、BOMをインポートする方法が2つあります。
GradleのネイティブなBOMサポートを使用してdependenciesを追加できます。
import org.springframework.boot.gradle.plugin.SpringBootPlugin plugins { id("java") id("org.springframework.boot") version "3.2.O" } dependencies { implementation(platform(SpringBootPlugin.BOM_COORDINATES)) implementation(platform("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom:2.20.1")) } Gradleでのもう一つの方法は、io.spring.dependency-managementプラグインを使用し、dependencyManagementでBOMをインポートすることです。
plugins { id("java") id("org.springframework.boot") version "3.2.O" id("io.spring.dependency-management") version "1.1.0" } dependencyManagement { imports { mavenBom("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom:2.20.1") } } Gradleで異なる設定方法を混在させないよう注意してください。 たとえば、io.spring.dependency-managementプラグインと一緒にimplementation(platform("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom:2.20.1"))を使用しないでください。
OpenTelemetryスターターの依存関係
OpenTelemetryスターターを有効にするには、以下の依存関係を追加します。
OpenTelemetryスターターは、OpenTelemetry Spring Boot自動構成を使用します。
<dependency> <groupId>io.opentelemetry.instrumentation</groupId> <artifactId>opentelemetry-spring-boot-starter</artifactId> </dependency> implementation("io.opentelemetry.instrumentation:opentelemetry-spring-boot-starter") フィードバック
このページは役に立ちましたか?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!