docs(otlp): Restructure OTLP page to elevate propagateTraceparent #16264
+242
−243
Conversation
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
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
![sentry[bot]](https://avatars.githubusercontent.com/in/12637?s=60&v=4){kind=small}
coolguyzone
reviewed
Feb 5, 2026
docs/concepts/otlp/otlp-traces.mdx
Outdated
|
|
||
| If you're using OTel without a Sentry SDK, you can send traces directly to Sentry's OTLP endpoint. You can find your endpoint URL and auth key in [Project settings > Client Keys (DSN)](https://sentry.io/orgredirect/organizations/:orgslug/settings/projects/). | ||
|
|
||
| ## Known Limitations |
Contributor
There was a problem hiding this comment.
Small nit, but I think it’d be better to move “Known Limitations” to the bottom of the page and bring “Configuration” above the fold, since that’s what most users are looking for.
coolguyzone
approved these changes
Feb 5, 2026
Contributor
coolguyzone
left a comment
coolguyzone
left a comment
There was a problem hiding this comment.
See my comment, but overall looks good to me! Thanks for cleaning this up 🏄♂️
jaffrepaul
added a commit
that referenced
this pull request
Feb 9, 2026
…6264) Restructures the OTLP concepts section to better highlight the `propagateTraceparent` & OTLP Integration options for users with Sentry + OTel backend setups. **Changes:** **Information Architecture** - Splits the monolithic OTLP index page into focused subpages: - `sentry-with-otel.mdx` - Linking Sentry SDKs with OTel (propagateTraceparent, OTLP Integration) - `otlp-traces.mdx` - Direct OTLP trace ingestion - `otlp-logs.mdx` - Direct OTLP log ingestion - Adds scenario table at the top of index with deep links to relevant sections - Adds distributed trace diagram to visualize Sentry + OTel linking **Content Updates** - Reorders page sections to prioritize common use cases: 1. Linking Sentry and OTLP Traces (propagateTraceparent) 2. OTLP Integration (same service) 3. Sending OpenTelemetry Data (OTel-only backend) - Simplifies language by using "OTel" instead of "OpenTelemetry" in body text - Streamlines setup instructions with clearer deep links to project settings - Adds Node.js (coming soon) placeholder to OTLP Integration section - Clarifies that Sentry does not support OTLP metrics upfront The goal is to make it easier for users to find the right solution for their setup, with Sentry SDK integration options more visible.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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.
Restructures the OTLP concepts section to better highlight the
propagateTraceparent& OTLP Integration options for users with Sentry + OTel backend setups.Changes:
Information Architecture
sentry-with-otel.mdx- Linking Sentry SDKs with OTel (propagateTraceparent, OTLP Integration)otlp-traces.mdx- Direct OTLP trace ingestionotlp-logs.mdx- Direct OTLP log ingestionContent Updates
The goal is to make it easier for users to find the right solution for their setup, with Sentry SDK integration options more visible.