Démarrage rapide

Compatibilité

Le Spring Boot starter OpenTelemetry fonctionne avec Spring Boot 2.6+ et 3.1+, et les images d’applications natives à Spring Boot. Le dépôt opentelemetry-java-examples/spring-native contient un exemple d’image d’application native à Spring Boot instrumentée à l’aide du Spring Boot OpenTelemetry starter.

Gestion des dépendances

Une nomenclature (BOM) garantit que les versions des dépendances (y compris transitives) sont alignées.

Pour garantir l’alignement des versions sur toutes les dépendances OpenTelemetry, vous devez importer la nomenclature opentelemetry-instrumentation-bom lors de l’utilisation du starter OpenTelemetry.

L’exemple suivant montre comment importer les nomenclatures OpenTelemetry en utilisant Maven :

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>io.opentelemetry.instrumentation</groupId>
            <artifactId>opentelemetry-instrumentation-bom</artifactId>
            <version>2.17.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Avec Gradle et Spring Boot, vous avez deux façons d’importer une nomenclature.

Vous pouvez utiliser le support natif de Gradle pour les nomenclatures en ajoutant des 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.17.0"))
}

L’autre façon avec Gradle est d’utiliser le plugin io.spring.dependency-management et d’importer les nomenclatures dans dependencyManagement :

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.17.0")
  }
}

Dépendance du starter OpenTelemetry

Ajoutez la dépendance ci-dessous pour activer le starter OpenTelemetry.

Le starter OpenTelemetry utilise l’autoconfiguration Spring Boot.

• Maven (pom.xml)
• Gradle (build.gradle)

<dependency>
    <groupId>io.opentelemetry.instrumentation</groupId>
    <artifactId>opentelemetry-spring-boot-starter</artifactId>
</dependency>

implementation("io.opentelemetry.instrumentation:opentelemetry-spring-boot-starter")