From 67d728d465fc78ac9b567e67aae932df0391248f Mon Sep 17 00:00:00 2001 From: "sentry-junior[bot]" <264270552+sentry-junior[bot]@users.noreply.github.com> Date: Wed, 3 Jun 2026 18:58:18 +0000 Subject: [PATCH 1/5] docs(span-metrics): add Application Metrics discovery banner to span metrics pages Co-authored-by: Sergiy Dybskiy --- docs/concepts/key-terms/tracing/span-metrics.mdx | 6 ++++++ .../javascript/common/tracing/span-metrics/index.mdx | 6 ++++++ docs/platforms/python/tracing/span-metrics/index.mdx | 6 ++++++ 3 files changed, 18 insertions(+) diff --git a/docs/concepts/key-terms/tracing/span-metrics.mdx b/docs/concepts/key-terms/tracing/span-metrics.mdx index 237246e0259d7..b44898e6f2246 100644 --- a/docs/concepts/key-terms/tracing/span-metrics.mdx +++ b/docs/concepts/key-terms/tracing/span-metrics.mdx @@ -4,6 +4,12 @@ description: "Learn how attaching attributes to spans provides enhanced applicat sidebar_order: 10 --- + + +Span metrics are great for enriching your existing traces with custom data. If you need metrics that are independent of tracing — such as business event counters, success/failure rates, or aggregates that aren't affected by trace sampling — use [Application Metrics](/product/explore/metrics/) instead. + + + Span metrics enable you to attach user defined attributes to spans, which might include application metrics or important debugging context within your application's traces. This approach provides context-rich performance monitoring by connecting attributes directly to the operations that generate them. These attributes allow you to enrich trace spans with attributes that represent various types of measurement data: diff --git a/docs/platforms/javascript/common/tracing/span-metrics/index.mdx b/docs/platforms/javascript/common/tracing/span-metrics/index.mdx index 7917858b0d8f0..6853f42faf7ae 100644 --- a/docs/platforms/javascript/common/tracing/span-metrics/index.mdx +++ b/docs/platforms/javascript/common/tracing/span-metrics/index.mdx @@ -4,6 +4,12 @@ description: "Learn how to add attributes to spans to monitor performance and de sidebar_order: 10 --- + + +Span metrics are great for enriching your existing traces with custom data. If you need metrics that are independent of tracing — such as business event counters, success/failure rates, or aggregates that aren't affected by trace sampling — use [Application Metrics](/product/explore/metrics/) instead. + + + To use span metrics, you must first configure tracing in your application. diff --git a/docs/platforms/python/tracing/span-metrics/index.mdx b/docs/platforms/python/tracing/span-metrics/index.mdx index ce02fd5e28736..c876bfaf8c642 100644 --- a/docs/platforms/python/tracing/span-metrics/index.mdx +++ b/docs/platforms/python/tracing/span-metrics/index.mdx @@ -4,6 +4,12 @@ description: "Learn how to add attributes to spans in Sentry to monitor performa sidebar_order: 20 --- + + +Span metrics are great for enriching your existing traces with custom data. If you need metrics that are independent of tracing — such as business event counters, success/failure rates, or aggregates that aren't affected by trace sampling — use [Application Metrics](/product/explore/metrics/) instead. + + + To use span metrics, you must first configure tracing in your application. From 7d9721bbb9fce3d9ec49af6fc406afe030c4af55 Mon Sep 17 00:00:00 2001 From: "sentry-junior[bot]" <264270552+sentry-junior[bot]@users.noreply.github.com> Date: Wed, 3 Jun 2026 19:01:14 +0000 Subject: [PATCH 2/5] docs(span-metrics): use PlatformLink for Application Metrics link on SDK pages Co-authored-by: Sergiy Dybskiy --- docs/platforms/javascript/common/tracing/span-metrics/index.mdx | 2 +- docs/platforms/python/tracing/span-metrics/index.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/platforms/javascript/common/tracing/span-metrics/index.mdx b/docs/platforms/javascript/common/tracing/span-metrics/index.mdx index 6853f42faf7ae..c50ca477074ea 100644 --- a/docs/platforms/javascript/common/tracing/span-metrics/index.mdx +++ b/docs/platforms/javascript/common/tracing/span-metrics/index.mdx @@ -6,7 +6,7 @@ sidebar_order: 10 -Span metrics are great for enriching your existing traces with custom data. If you need metrics that are independent of tracing — such as business event counters, success/failure rates, or aggregates that aren't affected by trace sampling — use [Application Metrics](/product/explore/metrics/) instead. +Span metrics are great for enriching your existing traces with custom data. If you need metrics that are independent of tracing — such as business event counters, success/failure rates, or aggregates that aren't affected by trace sampling — use Application Metrics instead. diff --git a/docs/platforms/python/tracing/span-metrics/index.mdx b/docs/platforms/python/tracing/span-metrics/index.mdx index c876bfaf8c642..b73b6e2e42321 100644 --- a/docs/platforms/python/tracing/span-metrics/index.mdx +++ b/docs/platforms/python/tracing/span-metrics/index.mdx @@ -6,7 +6,7 @@ sidebar_order: 20 -Span metrics are great for enriching your existing traces with custom data. If you need metrics that are independent of tracing — such as business event counters, success/failure rates, or aggregates that aren't affected by trace sampling — use [Application Metrics](/product/explore/metrics/) instead. +Span metrics are great for enriching your existing traces with custom data. If you need metrics that are independent of tracing — such as business event counters, success/failure rates, or aggregates that aren't affected by trace sampling — use Application Metrics instead. From 61b85a7d4bf214656e17ca1090024c940e767949 Mon Sep 17 00:00:00 2001 From: "sentry-junior[bot]" <264270552+sentry-junior[bot]@users.noreply.github.com> Date: Wed, 3 Jun 2026 20:32:05 +0000 Subject: [PATCH 3/5] ref(span-metrics): extract Application Metrics callout into shared include Co-authored-by: Shannon Anahata --- .../javascript/common/tracing/span-metrics/index.mdx | 6 +----- docs/platforms/python/tracing/span-metrics/index.mdx | 6 +----- .../tracing/span-metrics-application-metrics-callout.mdx | 5 +++++ 3 files changed, 7 insertions(+), 10 deletions(-) create mode 100644 includes/tracing/span-metrics-application-metrics-callout.mdx diff --git a/docs/platforms/javascript/common/tracing/span-metrics/index.mdx b/docs/platforms/javascript/common/tracing/span-metrics/index.mdx index c50ca477074ea..96d0f4cb820fb 100644 --- a/docs/platforms/javascript/common/tracing/span-metrics/index.mdx +++ b/docs/platforms/javascript/common/tracing/span-metrics/index.mdx @@ -4,11 +4,7 @@ description: "Learn how to add attributes to spans to monitor performance and de sidebar_order: 10 --- - - -Span metrics are great for enriching your existing traces with custom data. If you need metrics that are independent of tracing — such as business event counters, success/failure rates, or aggregates that aren't affected by trace sampling — use Application Metrics instead. - - + diff --git a/docs/platforms/python/tracing/span-metrics/index.mdx b/docs/platforms/python/tracing/span-metrics/index.mdx index b73b6e2e42321..4483c5c3be834 100644 --- a/docs/platforms/python/tracing/span-metrics/index.mdx +++ b/docs/platforms/python/tracing/span-metrics/index.mdx @@ -4,11 +4,7 @@ description: "Learn how to add attributes to spans in Sentry to monitor performa sidebar_order: 20 --- - - -Span metrics are great for enriching your existing traces with custom data. If you need metrics that are independent of tracing — such as business event counters, success/failure rates, or aggregates that aren't affected by trace sampling — use Application Metrics instead. - - + diff --git a/includes/tracing/span-metrics-application-metrics-callout.mdx b/includes/tracing/span-metrics-application-metrics-callout.mdx new file mode 100644 index 0000000000000..81929ad1745dc --- /dev/null +++ b/includes/tracing/span-metrics-application-metrics-callout.mdx @@ -0,0 +1,5 @@ + + +Span metrics are great for enriching your existing traces with custom data. If you need metrics that are independent of tracing — such as business event counters, success/failure rates, or aggregates that aren't affected by trace sampling — use Application Metrics instead. + + From ce7fd8f280b0889769e66938868522353e5dd241 Mon Sep 17 00:00:00 2001 From: "sentry-junior[bot]" <264270552+sentry-junior[bot]@users.noreply.github.com> Date: Wed, 3 Jun 2026 20:35:17 +0000 Subject: [PATCH 4/5] docs(custom-instrumentation): add Application Metrics callout to all SDK custom instrumentation pages Co-authored-by: Shannon Anahata --- .../android/tracing/instrumentation/custom-instrumentation.mdx | 2 ++ .../common/tracing/instrumentation/custom-instrumentation.mdx | 2 ++ .../common/tracing/instrumentation/custom-instrumentation.mdx | 2 ++ .../tracing/instrumentation/custom-instrumentation/index.mdx | 2 ++ .../tracing/instrumentation/custom-instrumentation/index.mdx | 2 ++ .../tracing/instrumentation/custom-instrumentation/index.mdx | 2 ++ .../common/tracing/instrumentation/custom-instrumentation.mdx | 2 ++ .../common/tracing/instrumentation/custom-instrumentation.mdx | 2 ++ .../tracing/instrumentation/custom-instrumentation.mdx | 2 ++ .../tracing/instrumentation/custom-instrumentation/index.mdx | 2 ++ .../common/tracing/instrumentation/custom-instrumentation.mdx | 2 ++ .../unity/tracing/instrumentation/custom-instrumentation.mdx | 2 ++ .../unreal/tracing/instrumentation/custom-instrumentation.mdx | 2 ++ 13 files changed, 26 insertions(+) diff --git a/docs/platforms/android/tracing/instrumentation/custom-instrumentation.mdx b/docs/platforms/android/tracing/instrumentation/custom-instrumentation.mdx index e9c41fe5aefee..012ea3c96b054 100644 --- a/docs/platforms/android/tracing/instrumentation/custom-instrumentation.mdx +++ b/docs/platforms/android/tracing/instrumentation/custom-instrumentation.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + diff --git a/docs/platforms/apple/common/tracing/instrumentation/custom-instrumentation.mdx b/docs/platforms/apple/common/tracing/instrumentation/custom-instrumentation.mdx index abdcb15057f35..ea0615b00e1fe 100644 --- a/docs/platforms/apple/common/tracing/instrumentation/custom-instrumentation.mdx +++ b/docs/platforms/apple/common/tracing/instrumentation/custom-instrumentation.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + diff --git a/docs/platforms/dart/common/tracing/instrumentation/custom-instrumentation.mdx b/docs/platforms/dart/common/tracing/instrumentation/custom-instrumentation.mdx index 7dcbb97cc9699..b59b1fa4dffb6 100644 --- a/docs/platforms/dart/common/tracing/instrumentation/custom-instrumentation.mdx +++ b/docs/platforms/dart/common/tracing/instrumentation/custom-instrumentation.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + diff --git a/docs/platforms/dotnet/common/tracing/instrumentation/custom-instrumentation/index.mdx b/docs/platforms/dotnet/common/tracing/instrumentation/custom-instrumentation/index.mdx index 1ccb9b0eb02be..e60587fc21669 100644 --- a/docs/platforms/dotnet/common/tracing/instrumentation/custom-instrumentation/index.mdx +++ b/docs/platforms/dotnet/common/tracing/instrumentation/custom-instrumentation/index.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + diff --git a/docs/platforms/go/common/tracing/instrumentation/custom-instrumentation/index.mdx b/docs/platforms/go/common/tracing/instrumentation/custom-instrumentation/index.mdx index ea0a6cd1e168f..1901a61d35b45 100644 --- a/docs/platforms/go/common/tracing/instrumentation/custom-instrumentation/index.mdx +++ b/docs/platforms/go/common/tracing/instrumentation/custom-instrumentation/index.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + If you're using an HTTP framework with Sentry middleware (Gin, Echo, Fiber, etc.), transactions are already created automatically for incoming requests. You don't need to create transactions manually — use custom instrumentation to **add child spans** within your handlers. See Automatic Instrumentation. diff --git a/docs/platforms/java/common/tracing/instrumentation/custom-instrumentation/index.mdx b/docs/platforms/java/common/tracing/instrumentation/custom-instrumentation/index.mdx index abdcb15057f35..ea0615b00e1fe 100644 --- a/docs/platforms/java/common/tracing/instrumentation/custom-instrumentation/index.mdx +++ b/docs/platforms/java/common/tracing/instrumentation/custom-instrumentation/index.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + diff --git a/docs/platforms/native/common/tracing/instrumentation/custom-instrumentation.mdx b/docs/platforms/native/common/tracing/instrumentation/custom-instrumentation.mdx index 120bef6bb31de..a12242448f16a 100644 --- a/docs/platforms/native/common/tracing/instrumentation/custom-instrumentation.mdx +++ b/docs/platforms/native/common/tracing/instrumentation/custom-instrumentation.mdx @@ -15,6 +15,8 @@ To capture transactions and spans customized to your organization's needs, you m + + diff --git a/docs/platforms/php/common/tracing/instrumentation/custom-instrumentation.mdx b/docs/platforms/php/common/tracing/instrumentation/custom-instrumentation.mdx index c7ebdbc37073f..d8aa93802137c 100644 --- a/docs/platforms/php/common/tracing/instrumentation/custom-instrumentation.mdx +++ b/docs/platforms/php/common/tracing/instrumentation/custom-instrumentation.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + diff --git a/docs/platforms/react-native/tracing/instrumentation/custom-instrumentation.mdx b/docs/platforms/react-native/tracing/instrumentation/custom-instrumentation.mdx index 1b397361bc92c..06449732c0d5f 100644 --- a/docs/platforms/react-native/tracing/instrumentation/custom-instrumentation.mdx +++ b/docs/platforms/react-native/tracing/instrumentation/custom-instrumentation.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + To add custom performance data to your application, you need to add custom instrumentation in the form of spans. Spans are a way to measure the time it takes for a specific action to occur. For example, you can create a span to measure the time it takes for a function to execute. To get started, import the SDK. diff --git a/docs/platforms/ruby/common/tracing/instrumentation/custom-instrumentation/index.mdx b/docs/platforms/ruby/common/tracing/instrumentation/custom-instrumentation/index.mdx index 0d5c2d898d996..66e53851c23c5 100644 --- a/docs/platforms/ruby/common/tracing/instrumentation/custom-instrumentation/index.mdx +++ b/docs/platforms/ruby/common/tracing/instrumentation/custom-instrumentation/index.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + diff --git a/docs/platforms/rust/common/tracing/instrumentation/custom-instrumentation.mdx b/docs/platforms/rust/common/tracing/instrumentation/custom-instrumentation.mdx index 8a88f40899afe..37a036526e92f 100644 --- a/docs/platforms/rust/common/tracing/instrumentation/custom-instrumentation.mdx +++ b/docs/platforms/rust/common/tracing/instrumentation/custom-instrumentation.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + diff --git a/docs/platforms/unity/tracing/instrumentation/custom-instrumentation.mdx b/docs/platforms/unity/tracing/instrumentation/custom-instrumentation.mdx index 0d5c2d898d996..66e53851c23c5 100644 --- a/docs/platforms/unity/tracing/instrumentation/custom-instrumentation.mdx +++ b/docs/platforms/unity/tracing/instrumentation/custom-instrumentation.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + diff --git a/docs/platforms/unreal/tracing/instrumentation/custom-instrumentation.mdx b/docs/platforms/unreal/tracing/instrumentation/custom-instrumentation.mdx index 4a9828b99967e..eefc61d25b048 100644 --- a/docs/platforms/unreal/tracing/instrumentation/custom-instrumentation.mdx +++ b/docs/platforms/unreal/tracing/instrumentation/custom-instrumentation.mdx @@ -10,6 +10,8 @@ To capture transactions and spans customized to your organization's needs, you m + + From 7232779bf9bea800e47cdc39d494028f6c324e68 Mon Sep 17 00:00:00 2001 From: "sentry-junior[bot]" <264270552+sentry-junior[bot]@users.noreply.github.com> Date: Wed, 3 Jun 2026 20:53:12 +0000 Subject: [PATCH 5/5] =?UTF-8?q?revert(dotnet):=20remove=20Application=20Me?= =?UTF-8?q?trics=20callout=20=E2=80=94=20no=20span=20attribute=20API=20doc?= =?UTF-8?q?umented?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Shannon Anahata --- .../tracing/instrumentation/custom-instrumentation/index.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/platforms/dotnet/common/tracing/instrumentation/custom-instrumentation/index.mdx b/docs/platforms/dotnet/common/tracing/instrumentation/custom-instrumentation/index.mdx index e60587fc21669..1ccb9b0eb02be 100644 --- a/docs/platforms/dotnet/common/tracing/instrumentation/custom-instrumentation/index.mdx +++ b/docs/platforms/dotnet/common/tracing/instrumentation/custom-instrumentation/index.mdx @@ -10,8 +10,6 @@ To capture transactions and spans customized to your organization's needs, you m - -