From 1214193c361dfa59a26460868b526f4944d0f62e Mon Sep 17 00:00:00 2001
From: Andrei <168741329+andreiborza@users.noreply.github.com>
Date: Fri, 17 May 2024 09:26:21 +0200
Subject: [PATCH] feat(core): Add `beforeSendSpan` documentation for javascript
 (#10055)

---
 .../common/configuration/filtering.mdx          |  6 ++++++
 .../javascript/common/configuration/options.mdx |  6 ++++++
 .../before-send-span/javascript.mdx             | 17 +++++++++++++++++
 3 files changed, 29 insertions(+)
 create mode 100644 platform-includes/configuration/before-send-span/javascript.mdx

diff --git a/docs/platforms/javascript/common/configuration/filtering.mdx b/docs/platforms/javascript/common/configuration/filtering.mdx
index e5413a51bfaf6..a0bc6c5719728 100644
--- a/docs/platforms/javascript/common/configuration/filtering.mdx
+++ b/docs/platforms/javascript/common/configuration/filtering.mdx
@@ -111,3 +111,9 @@ Learn more about <PlatformLink to="/configuration/sampling/">configuring the sam
 ### Using <PlatformIdentifier name="before-send-transaction" />
 
 <PlatformContent includePath="configuration/before-send-transaction" />
+
+## Filtering Spans
+
+To prevent certain spans from being reported to Sentry, use the <PlatformIdentifier name="before-send-span" /> configuration option, which allows you to provide a function to evaluate the current span and drop it if it's not one you want.
+
+<PlatformContent includePath="configuration/before-send-span" />
diff --git a/docs/platforms/javascript/common/configuration/options.mdx b/docs/platforms/javascript/common/configuration/options.mdx
index c82c876d504ae..a4357d349cd66 100644
--- a/docs/platforms/javascript/common/configuration/options.mdx
+++ b/docs/platforms/javascript/common/configuration/options.mdx
@@ -300,6 +300,12 @@ The callback typically gets a second argument (called a "hint") which contains t
 
 </ConfigKey>
 
+<ConfigKey name="before-send-span">
+
+This function is called with an SDK-specific span object, and can return a modified span object, or `null` to skip reporting the span. One way this might be used is for manual PII stripping before sending.
+
+</ConfigKey>
+
 
 ## Transport Options
 
diff --git a/platform-includes/configuration/before-send-span/javascript.mdx b/platform-includes/configuration/before-send-span/javascript.mdx
new file mode 100644
index 0000000000000..7b60a0d7fb4b0
--- /dev/null
+++ b/platform-includes/configuration/before-send-span/javascript.mdx
@@ -0,0 +1,17 @@
+<SignInNote />
+
+```javascript
+Sentry.init({
+  dsn: "___PUBLIC_DSN___",
+
+  // Called for spans
+  beforeSendSpan(span) {
+    // Modify or drop the span here
+    if (span.description === 'unimportant span') {
+      // Don't send the span to Sentry
+      return null;
+    }
+    return span;
+  },
+});
+```