docs(span-metrics): add Application Metrics discovery banner to span metrics pages#18023
Merged
sfanahata merged 5 commits intoJun 11, 2026
Merged
Conversation
…metrics pages Co-authored-by: Sergiy Dybskiy <sergiy.dybskiy@sentry.io>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
…SDK pages Co-authored-by: Sergiy Dybskiy <sergiy.dybskiy@sentry.io>
…clude Co-authored-by: Shannon Anahata <shannon.anahata@sentry.io>
…SDK custom instrumentation pages Co-authored-by: Shannon Anahata <shannon.anahata@sentry.io>
…e API documented Co-authored-by: Shannon Anahata <shannon.anahata@sentry.io>
sfanahata
approved these changes
Jun 11, 2026
inventarSarah
pushed a commit
that referenced
this pull request
Jun 15, 2026
…metrics pages (#18023) ## What Adds a discovery banner to the top of all span metrics documentation pages pointing users (and LLM crawlers) toward [Application Metrics](/product/explore/metrics/) when they need standalone, sampling-independent counters/gauges/distributions. ## Why Span metrics and Application Metrics serve different use cases, but the two are easy to conflate. Users with heavy sampling who need historic aggregates may land on span metrics docs and not realize Application Metrics is the better fit. This banner surfaces that distinction right at the top. ## Pages changed - `docs/concepts/key-terms/tracing/span-metrics.mdx` — concepts overview - `docs/platforms/javascript/common/tracing/span-metrics/index.mdx` — JS SDK - `docs/platforms/python/tracing/span-metrics/index.mdx` — Python SDK Note: JS and Python are the only SDK platforms that currently have span-metrics pages. The concepts page is the shared landing for LLM/markdown consumers. ## Banner copy (based on @shannon.anahata's proposal) > **Looking for standalone counters, gauges, or distributions?** > > 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. Minor edit from original: added a closing em-dash before "use" for grammatical completeness. --- Action taken on behalf of Sergiy Dybskiy. --- [View Session in Sentry](https://sentry.sentry.io/traces/?project=4510944073809921&query=gen_ai.conversation.id%3A%22slack%3AC09H3UT3X2Q%3A1780506432.490519%22) --------- Co-authored-by: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com> Co-authored-by: Sergiy Dybskiy <sergiy.dybskiy@sentry.io> Co-authored-by: Shannon Anahata <shannon.anahata@sentry.io>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a discovery banner to the top of all span metrics documentation pages pointing users (and LLM crawlers) toward Application Metrics when they need standalone, sampling-independent counters/gauges/distributions.
Why
Span metrics and Application Metrics serve different use cases, but the two are easy to conflate. Users with heavy sampling who need historic aggregates may land on span metrics docs and not realize Application Metrics is the better fit. This banner surfaces that distinction right at the top.
Pages changed
docs/concepts/key-terms/tracing/span-metrics.mdx— concepts overviewdocs/platforms/javascript/common/tracing/span-metrics/index.mdx— JS SDKdocs/platforms/python/tracing/span-metrics/index.mdx— Python SDKNote: JS and Python are the only SDK platforms that currently have span-metrics pages. The concepts page is the shared landing for LLM/markdown consumers.
Banner copy (based on @shannon.anahata's proposal)
Minor edit from original: added a closing em-dash before "use" for grammatical completeness.
Action taken on behalf of Sergiy Dybskiy.
View Session in Sentry