From 606063589f44c514e83ded4e2558a3aed145d6fb Mon Sep 17 00:00:00 2001
From: Moritz Halbritter <mkammerer@vmware.com>
Date: Fri, 30 Jun 2023 10:43:37 +0200
Subject: [PATCH] Document trace propagation with RestTemplate and WebClient

Closes gh-34053
---
 .../src/docs/asciidoc/actuator/tracing.adoc                | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/actuator/tracing.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/actuator/tracing.adoc
index 28cac4d2f9..90842ac8b2 100644
--- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/actuator/tracing.adoc
+++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/actuator/tracing.adoc
@@ -67,6 +67,13 @@ Press the "Show" button to see the details of that trace.
 
 TIP: You can include the current trace and span id in the logs by setting the configprop:logging.pattern.level[] property to `%5p [${spring.application.name:},%X{traceId:-},%X{spanId:-}]`
 
+[[actuator.micrometer-tracing.propagating-traces]]
+=== Propagating Traces
+
+To automatically propagate traces over the network, use the auto-configured <<io#io.rest-client.resttemplate, `RestTemplateBuilder`>> or <<io#io.rest-client.webclient, `WebClient.Builder`>> to construct the client.
+
+WARNING: If you create the `WebClient` or the `RestTemplate` without using the auto-configured builders, automatic trace propagation won't work!
+
 
 
 [[actuator.micrometer-tracing.tracer-implementations]]