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/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/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/javascript/common/tracing/span-metrics/index.mdx b/docs/platforms/javascript/common/tracing/span-metrics/index.mdx index 7917858b0d8f0..96d0f4cb820fb 100644 --- a/docs/platforms/javascript/common/tracing/span-metrics/index.mdx +++ b/docs/platforms/javascript/common/tracing/span-metrics/index.mdx @@ -4,6 +4,8 @@ description: "Learn how to add attributes to spans to monitor performance and de sidebar_order: 10 --- + + To use span metrics, you must first configure tracing in your application. 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/python/tracing/span-metrics/index.mdx b/docs/platforms/python/tracing/span-metrics/index.mdx index ce02fd5e28736..4483c5c3be834 100644 --- a/docs/platforms/python/tracing/span-metrics/index.mdx +++ b/docs/platforms/python/tracing/span-metrics/index.mdx @@ -4,6 +4,8 @@ description: "Learn how to add attributes to spans in Sentry to monitor performa sidebar_order: 20 --- + + To use span metrics, you must first configure tracing in your application. 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 + + 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. + +