Primeros pasos
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 f304b22c..4d7a0087
and search for More information ...
content/en/docs/zero-code/java/spring-boot-starter/getting-started.md.
También puedes usar el agente de Java para instrumentar tu aplicación Spring Boot. Para conocer las ventajas y desventajas de cada opción, consulta Instrumentación sin código para Java.
Compatibilidad
El starter de OpenTelemetry para Spring Boot funciona con Spring Boot 2.6+ y 3.1+, y con aplicaciones Spring Boot compiladas como imagen nativa. El repositorio opentelemetry-java-examples/spring-native contiene un ejemplo de una aplicación Spring Boot con imagen nativa instrumentada con el starter de OpenTelemetry para Spring Boot.
Gestión de dependencias
Un Bill of Materials (BOM) garantiza que las versiones de las dependencias (incluidas las transitivas) estén alineadas.
Para asegurar que las versiones de todas las dependencias de OpenTelemetry estén
alineadas, debes importar el BOM opentelemetry-instrumentation-bom cuando uses
el starter de OpenTelemetry.
Si usas Maven, importa los BOMs de OpenTelemetry antes que cualquier otro BOM
de tu proyecto. Por ejemplo, si importas el BOM spring-boot-dependencies,
debes declararlo después de los BOMs de OpenTelemetry.
Gradle selecciona la versión más reciente de una dependencia cuando varios BOMs la definen, por lo que el orden de los BOMs no importa.
El siguiente ejemplo muestra cómo importar los BOMs de OpenTelemetry con Maven:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>io.opentelemetry.instrumentation</groupId>
<artifactId>opentelemetry-instrumentation-bom</artifactId>
<version>2.30.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
Con Gradle y Spring Boot, tienes dos formas de importar un BOM.
Puedes usar el soporte nativo de BOMs de Gradle añadiendo 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.30.0"))
}
La otra forma con Gradle es usar el plugin io.spring.dependency-management e
importar los BOMs en 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.30.0")
}
}
Ten cuidado de no mezclar las distintas formas de configurar Gradle. Por
ejemplo, no uses
implementation(platform("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom:2.30.0"))
junto con el plugin io.spring.dependency-management.
Dependencia del starter de OpenTelemetry
Añade la siguiente dependencia para habilitar el starter de OpenTelemetry.
El starter de OpenTelemetry usa la autoconfiguración de Spring Boot.
<dependency>
<groupId>io.opentelemetry.instrumentation</groupId>
<artifactId>opentelemetry-spring-boot-starter</artifactId>
</dependency>
implementation("io.opentelemetry.instrumentation:opentelemetry-spring-boot-starter")
Comentarios
¿Fue útil esta página?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!