From 5b841972ec65c892e986969e711ebc052fe5f64a Mon Sep 17 00:00:00 2001
From: Maciej Walkowiak <walkowiak.maciej@yahoo.com>
Date: Fri, 1 Apr 2022 11:46:43 +0200
Subject: [PATCH 1/2] Document tracing-origins

---
 src/platforms/common/configuration/options.mdx   |  6 ++++++
 .../java/common/configuration/index.mdx          | 16 ++++++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/src/platforms/common/configuration/options.mdx b/src/platforms/common/configuration/options.mdx
index b5b4a9cd7099f..d50c2a0478cae 100644
--- a/src/platforms/common/configuration/options.mdx
+++ b/src/platforms/common/configuration/options.mdx
@@ -497,6 +497,12 @@ A function responsible for determining the percentage chance a given transaction
 
 </ConfigKey>
 
+<ConfigKey name="tracing-origins" supported={["java"]}>
+
+An optional property containing a list of URLs or regex against which URLs are matched, that configures which downstream services receive `sentry-trace` header attached to HTTP requests. If not set, `sentry-trace` header is attached to every request executed from an instrumented client.
+
+</ConfigKey>
+
 </PlatformSection>
 
 <PlatformSection supported={["react-native", "javascript.cordova", "javascript.capacitor"]}>
diff --git a/src/platforms/java/common/configuration/index.mdx b/src/platforms/java/common/configuration/index.mdx
index 23931457a5daf..f32e3e200d0d0 100644
--- a/src/platforms/java/common/configuration/index.mdx
+++ b/src/platforms/java/common/configuration/index.mdx
@@ -261,6 +261,22 @@ SENTRY_TRACES_SAMPLE_RATE=0.2
 sentry.traces-sample-rate=0.2
 ```
 
+### Tracing Origins
+
+To set tracing origins, use the `tracing-origins` option:
+
+```properties {tabTitle:sentry.properties}
+tracing-origins=localhost,^(http|https)://api\\..*$
+```
+
+```properties {tabTitle:environment variable}
+SENTRY_TRACING_ORIGINS=localhost,^(http|https)://api\\..*$
+```
+
+```properties {tabTitle:system property}
+sentry.tracing-origins=localhost,^(http|https)://api\\..*$
+```
+
 ### Debug
 
 To set Sentry in the debug mode, use the `debug` option:

From 0489a9391e8a248dcaf6781c22314820d0ef565d Mon Sep 17 00:00:00 2001
From: Manoel Aranda Neto <5731772+marandaneto@users.noreply.github.com>
Date: Mon, 4 Apr 2022 15:33:49 +0200
Subject: [PATCH 2/2] Update src/platforms/common/configuration/options.mdx

Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
---
 src/platforms/common/configuration/options.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/platforms/common/configuration/options.mdx b/src/platforms/common/configuration/options.mdx
index d50c2a0478cae..957105515a1cb 100644
--- a/src/platforms/common/configuration/options.mdx
+++ b/src/platforms/common/configuration/options.mdx
@@ -499,7 +499,7 @@ A function responsible for determining the percentage chance a given transaction
 
 <ConfigKey name="tracing-origins" supported={["java"]}>
 
-An optional property containing a list of URLs or regex against which URLs are matched, that configures which downstream services receive `sentry-trace` header attached to HTTP requests. If not set, `sentry-trace` header is attached to every request executed from an instrumented client.
+An optional property that configures which downstream services receive the `sentry-trace` header attached to HTTP requests. It contains a list of URLs or regex against which URLs are matched. If not set, the `sentry-trace` header is attached to every request executed from an instrumented client.
 
 </ConfigKey>