docs: Add missing OTLP integration docs and fix drift across SDKs by dingsdax · Pull Request #18441 · getsentry/sentry-docs

dingsdax · 2026-06-16T20:49:52Z

closes getsentry/sentry-dotnet#5190

DESCRIBE YOUR PR

4 SDKs shipped OTLP support with no docs
2 legacy pages lacked deprecation alerts
overview page still listed Go/PHP as "Coming Soon"
existing Go/Java docs had stale version numbers and incorrect config

Overview of changes

New documentation pages:

PHP OTLP integration (docs/platforms/php/common/integrations/otlp/)
.NET OTLP integration (docs/platforms/dotnet/common/tracing/instrumentation/opentelemetry-otlp.mdx)
Symfony OTLP integration (docs/platforms/php/guides/symfony/integrations/otlp.mdx)
Laravel OTLP integration (docs/platforms/php/guides/laravel/integrations/otlp.mdx)

Deprecation alerts added:

Python legacy OpenTelemetry page: strengthened from "New Integration Option" to formal deprecation warning
Ruby legacy OpenTelemetry page: same treatment
.NET legacy OpenTelemetry page: new deprecation alert pointing to OTLP exporter docs

Hub page updated:

docs/concepts/otlp/sentry-with-otel.mdx: removed "Coming Soon" section, added .NET, Go, Java, PHP, Laravel, Symfony (9 SDKs total, alphabetical)

Existing docs corrected:

Go: updated version floors (Go 1.25+, sentry-go 0.47.0+, OTel 1.43.0+), changed "deprecated" to "removed" for NewSentrySpanProcessor
Java: fixed otel.propagators from sentry to tracecontext,baggage,sentry (matching official SDK samples)

Per-SDK changes

PHP (sentry-php, sentry-symfony, sentry-laravel)

New pages:

docs/platforms/php/common/integrations/otlp/index.mdx
- Documents OTLPIntegration class
- Install: open-telemetry/sdk, open-telemetry/exporter-otlp
- Options: setupOtlpTracesExporter, collectorUrl
- Supported versions: PHP 8.1+, sentry/sentry 4.23.0+
docs/platforms/php/guides/symfony/integrations/otlp.mdx
- Symfony bundle YAML config with auto-service registration
- Links to parent PHP page for options
- Requires sentry-symfony ^5.10
docs/platforms/php/guides/laravel/integrations/otlp.mdx
- Laravel config/sentry.php config using ::class pattern
- Links to parent PHP page for options
- Requires sentry-laravel ^4.25

Verification: all code examples checked against sentry-php OTLPIntegration.php constructor, sentry-symfony test fixtures, and sentry-laravel ServiceProvider source.

.NET (sentry-dotnet)

New page:

docs/platforms/dotnet/common/tracing/instrumentation/opentelemetry-otlp.mdx
- Documents Sentry.OpenTelemetry.Exporter NuGet package
- AddSentryOtlpExporter(dsn) and UseOtlp() extension methods
- Options: dsnString, collectorUrl (Uri), defaultTextMapPropagator
- Supported versions: .NET 6.0+, OTel 1.15.0+

Updated page:

docs/platforms/dotnet/common/tracing/instrumentation/opentelemetry.mdx
- Added deprecation alert pointing to new OTLP docs
- Renamed title to "OpenTelemetry Support (Deprecated)"

Verification: checked against SentryTracerProviderBuilderExtensions.cs, SentryOptionsExtensions.cs, and official console/ASP.NET Core samples.

Python (sentry-python)

Updated page:

docs/platforms/python/tracing/instrumentation/opentelemetry.mdx
- Changed alert from "New Integration Option" to formal deprecation warning
- OpenTelemetryIntegration was deprecated in chore: Deprecate OpenTelemetryIntegration in favor of OTLPIntegration and no-op for span first sentry-python#6494 (June 2026)

Verification: existing OTLP docs confirmed correct against sentry_sdk/integrations/otlp.py.

Ruby (sentry-ruby)

Updated page:

docs/platforms/ruby/common/tracing/instrumentation/opentelemetry.mdx
- Changed alert from "New Integration Option" to formal deprecation warning
- Renamed title to "OpenTelemetry Support (Deprecated)"

Verification: existing OTLP docs confirmed correct against sentry-opentelemetry gem source.

Go (sentry-go)

Updated pages:

platform-includes/performance/opentelemetry-install/go.mdx
- Corrected version requirements:
  - Go 1.18 → 1.25+
  - sentry-go 0.18.0 → 0.47.0+
  - OTel 1.11.0 → 1.43.0+
docs/platforms/go/common/tracing/instrumentation/opentelemetry.mdx
- Changed "Span Processor Deprecation" to "Span Processor Removed"
- NewSentrySpanProcessor and NewSentryPropagator were fully removed in v0.47.0

Verification: checked against otel/otlp/span_exporter.go, otel/go.mod, and _examples/otlp/main.go.

Java (sentry-java)

Updated page:

docs/platforms/java/common/opentelemetry/setup/otlp.mdx
- Fixed otel.propagators in both plain Java and Spring Boot examples:
  - Before: sentry
  - After: tracecontext,baggage,sentry
- Without tracecontext,baggage, W3C traceparent propagation is lost

Verification: all code examples confirmed correct against sentry-opentelemetry-otlp module source and sample apps.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

Urgent deadline (GA date, etc.):
Other deadline:
None: Not urgent, can wait up to 1 week+

SLA

Teamwork makes the dream work, so please add a reviewer to your PRs.
Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

Checked Vercel preview for correctness, including links
PR was reviewed and approved by any necessary SMEs (subject matter experts)
PR was reviewed and approved by a member of the Sentry docs team

Document the OTLPIntegration for the PHP SDK, covering install, configuration, behavior, options (setup_otlp_traces_exporter, collector_url), and supported versions. The integration was added in sentry-php 4.23.0 (PR getsentry/sentry-php#2030) but had no corresponding documentation. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Document the new Sentry.OpenTelemetry.Exporter NuGet package with AddSentryOtlpExporter(dsn) and UseOtlp() extension methods. The package was added in sentry-dotnet PR getsentry/sentry-dotnet#4899 (May 2026) but had no corresponding documentation. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Document Symfony-specific configuration for the OTLPIntegration introduced in sentry-symfony 5.4 (PR getsentry/sentry-symfony#1014). References the PHP OTLP integration docs for shared behavior and options. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Document Laravel-specific configuration for the OTLPIntegration introduced in sentry-laravel 4.15 (PR getsentry/sentry-laravel#1122). References the PHP OTLP integration docs for shared behavior and options. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Update the alert from "New Integration Option" to a deprecation warning. OpenTelemetryIntegration was formally deprecated in favor of OTLPIntegration in sentry-python PR getsentry/sentry-python#6494 (June 2026). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Mark the Sentry.OpenTelemetry SpanProcessor approach as deprecated in favor of the new Sentry.OpenTelemetry.Exporter OTLP package, matching the deprecation pattern used on the Python and Ruby legacy OTel pages. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Remove the "Coming Soon" section and add .NET, Go, Java, PHP, Laravel, and Symfony to the OTLP Integration list alongside the existing Node.js, Python, and Ruby entries. All listed SDKs now have shipped OTLP support and have corresponding documentation. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Fix wrong package name open-telemetry/transport-grumphp in PHP, Symfony, and Laravel install sections (package does not exist) - Fix undeclared serviceName variable in .NET code example - Add missing Supported Versions section to .NET OTLP page - Fix missing trailing slash on Python PlatformLink - Mark Ruby legacy OTel page as deprecated (was still using soft "New Integration Option" alert) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Fix Symfony minimum version: ^5.10 not ^5.4 (OTLPIntegration service registration was added in 5.10.0) - Fix Laravel minimum version: ^4.25 not ^4.15 (OTLPIntegration support was added in 4.25.0) - Fix PHP version requirement: 8.1+ not 7.2+ (OpenTelemetry SDK requires PHP 8.1) - Use camelCase option names to match actual PHP constructor params (setupOtlpTracesExporter, collectorUrl) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Go: - Update version requirements: Go 1.25+, sentry-go 0.47.0+, OTel 1.43.0+ (were 1.18, 0.18.0, 1.11.0) - Update alert: NewSentrySpanProcessor/NewSentryPropagator were removed in v0.47.0, not just deprecated Java: - Add tracecontext,baggage to otel.propagators alongside sentry in both plain Java and Spring Boot examples, matching official SDK samples. Without these, W3C traceparent propagation is lost. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Change "Legacy OpenTelemetry Support" to "OpenTelemetry Support (Deprecated)" for consistency with the Python and Ruby deprecated OTel pages. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

vercel · 2026-06-16T20:49:59Z

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

Project	Deployment	Actions	Updated (UTC)
sentry-docs	Ready	Preview, Comment	Jun 30, 2026 2:35pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
develop-docs	Ignored	Preview	Jun 30, 2026 2:35pm

The anchor #instrumentation doesn't exist on the getting-started page. Use the dedicated instrumentation page URL instead. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Without fallbackPlatform="php", PlatformLink resolves relative to the guide URL instead of the parent platform, producing broken links. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Order platforms by adoption/maturity and group PHP SDKs (PHP, Laravel, Symfony) together instead of scattering them alphabetically. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

adinauer

Java changes LGTM

Flash0ver

Review for docs/platforms/dotnet/:

…etry-otlp.mdx Co-authored-by: Stefan Pölz <38893694+Flash0ver@users.noreply.github.com>

Co-authored-by: Giannis Gkiortzis <58184179+giortzisg@users.noreply.github.com>

…etry-otlp.mdx Co-authored-by: Stefan Pölz <38893694+Flash0ver@users.noreply.github.com>

Reorder sidebar so both OpenTelemetry pages are adjacent: - performance-metrics.mdx stays at sidebar_order 20 - opentelemetry.mdx moves to sidebar_order 21 - opentelemetry-otlp.mdx moves to sidebar_order 22 Add version injection to dotnet add package command and remove inaccurate Supported Versions section for consistency with other .NET docs. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Litarnus · 2026-06-17T22:14:26Z

+
+```bash
+composer require \
+  sentry/sentry-laravel:"^4.25" \


nit: I think we should have a ## Supported Versions section here too instead of implicitly specifying the version

Flash0ver

platforms/dotnet/ ✅

Add warning alerts to Python, Ruby, and .NET OTLP pages noting that the automatic propagator setup will be removed in the next major version, with links to the OpenTelemetry propagation API docs. Also add a Supported Versions section to the PHP/Laravel OTLP page and move the version constraint out of the install command to match the format used by other SDK OTLP pages. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add an 'Exporters, Event Linking, and Propagation' section to the Sentry-with-OTel concepts page explaining the three distinct mechanisms that make traces work in Sentry. Reword propagator bullets on Python, Ruby, and .NET pages to clarify the Sentry propagator is for native- tracing compatibility, not a requirement for distributed tracing. Add a trailing note on all platform OTLP pages linking to the new section. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sentry · 2026-06-30T14:27:34Z

+composer require \
+  sentry/sentry-laravel \
+  open-telemetry/sdk \
+  open-telemetry/exporter-otlp


Bug: The composer require command for the Laravel OTLP integration guide is missing the required version constraint for sentry/sentry-laravel, which can lead to installing an incompatible version.
_{Severity: MEDIUM}

Suggested Fix

Update the composer require command in the Laravel OTLP integration guide to include the minimum version constraint. Change sentry/sentry-laravel to sentry/sentry-laravel:"^4.25". This ensures Composer installs a compatible version.

Prompt for AI Agent

Review the code at the location below. A potential bug has been identified by an AI agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not valid. Location: docs/platforms/php/guides/laravel/integrations/otlp.mdx#L20-L23 Potential issue: The Laravel OTLP integration documentation specifies that `sentry/sentry-laravel: 4.25.0+` is required, but the provided `composer require` command does not enforce this version. If a user's environment resolves to an older version (e.g., due to an existing `composer.lock` file), they will install an incompatible package. This will cause a `ClassNotFoundException` at runtime when the application tries to use `\Sentry\Integration\OTLPIntegration`, which does not exist in versions prior to 4.25.0.

sentry · 2026-06-30T14:27:34Z

+
+## Options
+
+For details on available options (`setupOtlpTracesExporter`, `collectorUrl`), see the <PlatformLink to="/integrations/otlp/" fallbackPlatform="php">OTLP integration docs</PlatformLink>.


Bug: The PlatformLink component on the OTLP integration pages for Laravel and Symfony creates a self-referential link instead of linking to the parent PHP platform documentation.
_{Severity: LOW}

Suggested Fix

The logic in the PlatformLink component needs to be adjusted to correctly handle fallbacks when an explicit guide file exists. It should distinguish between the current page and a true parent/fallback page to prevent generating self-referential links.

Prompt for AI Agent

Review the code at the location below. A potential bug has been identified by an AI agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not valid. Location: docs/platforms/php/guides/symfony/integrations/otlp.mdx#L58 Potential issue: The `PlatformLink` component on the Symfony and Laravel OTLP guide pages generates a self-referential link. Because explicit guide files exist (e.g., `docs/platforms/php/guides/symfony/integrations/otlp.mdx`), the component's logic finds the current page first and sets the link's `href` to the current URL. The `fallbackPlatform="php"` property is never used. As a result, users clicking the "OTLP integration docs" link are not navigated to the parent PHP platform documentation but are instead reloaded on the same page, creating a broken user experience.

Also affects:

docs/platforms/php/guides/laravel/integrations/otlp.mdx:59

dingsdax and others added 11 commits June 16, 2026 13:23

fix(dotnet): Align deprecated page title with Python/Ruby pattern

d4ebc65

Change "Legacy OpenTelemetry Support" to "OpenTelemetry Support (Deprecated)" for consistency with the Python and Ruby deprecated OTel pages. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

codeowner-assignment Bot requested a review from a team June 16, 2026 20:50

dingsdax requested review from adinauer, giortzisg, jamescrosswell, sl0thentr0py and stayallive June 16, 2026 20:58

vercel Bot deployed to Preview – sentry-docs June 16, 2026 21:00 View deployment

dingsdax requested review from Flash0ver and removed request for jamescrosswell June 16, 2026 21:00

dingsdax and others added 2 commits June 16, 2026 14:02

Merge branch 'master' into docs/otlp-integration-drift

a786a30

fix(php): Update broken OTel instrumentation links

d348f6d

The anchor #instrumentation doesn't exist on the getting-started page. Use the dedicated instrumentation page URL instead. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sentry Bot reviewed Jun 16, 2026

View reviewed changes

Comment thread docs/platforms/php/guides/symfony/integrations/otlp.mdx Outdated

vercel Bot deployed to Preview – sentry-docs June 16, 2026 21:15 View deployment

dingsdax and others added 2 commits June 16, 2026 14:25

fix(php): Add fallbackPlatform to PlatformLink in guide pages

fefea65

Without fallbackPlatform="php", PlatformLink resolves relative to the guide URL instead of the parent platform, producing broken links. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Merge branch 'master' into docs/otlp-integration-drift

2596a60

vercel Bot deployed to Preview – develop-docs June 16, 2026 21:39 View deployment

vercel Bot deployed to Preview – sentry-docs June 16, 2026 21:43 View deployment

docs(otlp): Reorder hub page links by importance

fdad7fb

Order platforms by adoption/maturity and group PHP SDKs (PHP, Laravel, Symfony) together instead of scattering them alphabetically. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

vercel Bot deployed to Preview – sentry-docs June 16, 2026 22:04 View deployment

adinauer approved these changes Jun 17, 2026

View reviewed changes

Flash0ver mentioned this pull request Jun 17, 2026

docs: add Sentry.OpenTelemetry.Exporter to README.md getsentry/sentry-dotnet#5194

Open

Flash0ver reviewed Jun 17, 2026

View reviewed changes

giortzisg reviewed Jun 17, 2026

View reviewed changes

Comment thread platform-includes/performance/opentelemetry-install/go.mdx Outdated

sl0thentr0py approved these changes Jun 17, 2026

View reviewed changes

dingsdax and others added 2 commits June 17, 2026 11:40

Update docs/platforms/dotnet/common/tracing/instrumentation/opentelem…

25ea04e

…etry-otlp.mdx Co-authored-by: Stefan Pölz <38893694+Flash0ver@users.noreply.github.com>

Update platform-includes/performance/opentelemetry-install/go.mdx

bc773fb

Co-authored-by: Giannis Gkiortzis <58184179+giortzisg@users.noreply.github.com>

codeowner-assignment Bot requested a review from a team June 17, 2026 18:41

Update docs/platforms/dotnet/common/tracing/instrumentation/opentelem…

84d25a1

…etry-otlp.mdx Co-authored-by: Stefan Pölz <38893694+Flash0ver@users.noreply.github.com>

dingsdax requested review from Litarnus and removed request for stayallive June 17, 2026 18:41

vercel Bot deployed to Preview – sentry-docs June 17, 2026 19:00 View deployment

Merge branch 'master' into docs/otlp-integration-drift

ab536f9

vercel Bot deployed to Preview – develop-docs June 17, 2026 20:11 View deployment

vercel Bot deployed to Preview – sentry-docs June 17, 2026 20:15 View deployment

Litarnus approved these changes Jun 17, 2026

View reviewed changes

giortzisg approved these changes Jun 18, 2026

View reviewed changes

Flash0ver approved these changes Jun 18, 2026

View reviewed changes

jamescrosswell reviewed Jun 23, 2026

View reviewed changes

Comment thread docs/platforms/dotnet/common/tracing/instrumentation/opentelemetry-otlp.mdx Outdated

Flash0ver mentioned this pull request Jun 24, 2026

Disable automatic propagator for OTLP getsentry/sentry-dotnet#5299

Open

jamescrosswell mentioned this pull request Jun 26, 2026

fix(otlp): don't configure an automatic OTel propagator getsentry/sentry-dotnet#5319

Open

codeowner-assignment Bot requested a review from a team June 29, 2026 15:47

vercel Bot deployed to Preview – sentry-docs June 29, 2026 15:59 View deployment

sentry Bot reviewed Jun 30, 2026

View reviewed changes

vercel Bot deployed to Preview – sentry-docs June 30, 2026 14:35 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

docs: Add missing OTLP integration docs and fix drift across SDKs#18441

docs: Add missing OTLP integration docs and fix drift across SDKs#18441
dingsdax wants to merge 23 commits into
masterfrom
docs/otlp-integration-drift

dingsdax commented Jun 16, 2026 •

edited by Flash0ver

Loading

Uh oh!

vercel Bot commented Jun 16, 2026 •

edited

Loading

Uh oh!

Uh oh!

adinauer left a comment

Uh oh!

Flash0ver left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Litarnus Jun 17, 2026

Uh oh!

Uh oh!

Flash0ver left a comment

Uh oh!

Uh oh!

sentry Bot Jun 30, 2026

Uh oh!

sentry Bot Jun 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants


		## Options

		For details on available options (`setupOtlpTracesExporter`, `collectorUrl`), see the <PlatformLink to="/integrations/otlp/" fallbackPlatform="php">OTLP integration docs</PlatformLink>.

Uh oh!

Uh oh!

Conversation

dingsdax commented Jun 16, 2026 • edited by Flash0ver Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

DESCRIBE YOUR PR

Overview of changes

Per-SDK changes

IS YOUR CHANGE URGENT?

SLA

PRE-MERGE CHECKLIST

Uh oh!

vercel Bot commented Jun 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

adinauer left a comment

Choose a reason for hiding this comment

Uh oh!

Flash0ver left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Litarnus Jun 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Flash0ver left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sentry Bot Jun 30, 2026

Choose a reason for hiding this comment

Uh oh!

sentry Bot Jun 30, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

dingsdax commented Jun 16, 2026 •

edited by Flash0ver

Loading

vercel Bot commented Jun 16, 2026 •

edited

Loading