Skip to content

docs(otlp): Restructure OTLP page to elevate propagateTraceparent#16264

Open
jaffrepaul wants to merge 5 commits intomasterfrom
docs/elevate-propagateTraceparent
Open

docs(otlp): Restructure OTLP page to elevate propagateTraceparent#16264
jaffrepaul wants to merge 5 commits intomasterfrom
docs/elevate-propagateTraceparent

Conversation

@jaffrepaul
Copy link
Contributor

@jaffrepaul jaffrepaul commented Feb 4, 2026

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.

@vercel
Copy link

vercel bot commented Feb 4, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Feb 5, 2026 3:37pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Feb 5, 2026 3:37pm

Request Review

@jaffrepaul jaffrepaul marked this pull request as ready for review February 5, 2026 01:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant