docs(span-metrics): add Application Metrics discovery banner to span metrics pages#18023
Draft
sentry-junior[bot] wants to merge 5 commits into
Draft
docs(span-metrics): add Application Metrics discovery banner to span metrics pages#18023sentry-junior[bot] wants to merge 5 commits into
sentry-junior[bot] wants to merge 5 commits into
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>
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
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