From 902b5d78b07cfa9b318e8d8e35534b754ce57018 Mon Sep 17 00:00:00 2001 From: Syed Muhammad Osama Date: Thu, 18 Dec 2025 22:13:52 +0500 Subject: [PATCH] Fix #48576: Clarify tracing dependency requirements Signed-off-by: Syed Muhammad Osama --- .../antora/modules/reference/pages/actuator/tracing.adoc | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/documentation/spring-boot-docs/src/docs/antora/modules/reference/pages/actuator/tracing.adoc b/documentation/spring-boot-docs/src/docs/antora/modules/reference/pages/actuator/tracing.adoc index a77a5f1d29ea..6bb4992cef34 100644 --- a/documentation/spring-boot-docs/src/docs/antora/modules/reference/pages/actuator/tracing.adoc +++ b/documentation/spring-boot-docs/src/docs/antora/modules/reference/pages/actuator/tracing.adoc @@ -3,6 +3,8 @@ Spring Boot Actuator provides dependency management and auto-configuration for {url-micrometer-tracing-docs}[Micrometer Tracing], a facade for popular tracer libraries. +NOTE: Spring Boot provides modular tracing support. Having `spring-boot-starter-actuator` on the classpath enables tracing infrastructure, but tracing auto-configuration is only activated when a supported tracing bridge and tracer implementation are also present. + TIP: To learn more about Micrometer Tracing capabilities, see its {url-micrometer-tracing-docs}[reference documentation]. @@ -30,6 +32,9 @@ include-code::MyApplication[] NOTE: There's an added logger statement in the `home()` method, which will be important later. +NOTE: Tracing is not enabled by adding `spring-boot-starter-actuator` alone. The following dependencies provide the tracing bridge and tracer implementation required for tracing auto-configuration. + + Now we have to add the following dependencies: * `org.springframework.boot:spring-boot-starter-actuator` @@ -112,7 +117,7 @@ WARNING: If you create the javadoc:org.springframework.web.client.RestTemplate[] As Micrometer Tracer supports multiple tracer implementations, there are multiple dependency combinations possible with Spring Boot. -All tracer implementations need the `org.springframework.boot:spring-boot-starter-actuator` dependency. +All tracer implementations need the `org.springframework.boot:spring-boot-starter-actuator` dependency. In addition, a tracing bridge and tracer implementation must be present on the classpath for tracing auto-configuration to be activated.