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 16, 2026 10:04pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
develop-docs	Ignored	Preview	Jun 16, 2026 10:04pm

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/:

Flash0ver · 2026-06-17T11:47:30Z

+---
+title: OpenTelemetry (OTLP)
+description: "Learn about using OTLP to automatically send OpenTelemetry Traces to Sentry."
+sidebar_order: 21


issue (low): order

The order is unexpected ... there is another item between the new and the old OTEL integration:

performance-metrics.mdx also has sidebar_order: 20, just like opentelemetry.mdx does.

I suggest

keep performance-metrics.mdx at sidebar_order: 20

change the old opentelemetry.mdx to sidebar_order: 21

and change this new document to sidebar_order: 22

So that both OTEL pages are next to each other.

Flash0ver · 2026-06-17T12:07:45Z

+Add the `Sentry.OpenTelemetry.Exporter` NuGet package to your project:
+
+```shell {tabTitle:.NET Core CLI}
+dotnet add package Sentry.OpenTelemetry.Exporter


suggestion: add version

Inject current version for consistency with other sentry-dotnet docs:

Suggested change

dotnet add package Sentry.OpenTelemetry.Exporter

dotnet add package Sentry.OpenTelemetry.Exporter -v {{@inject packages.version('sentry.dotnet') }}

Flash0ver · 2026-06-17T12:08:01Z

+```
+
+```powershell {tabTitle:Package Manager}
+Install-Package Sentry.OpenTelemetry.Exporter


suggestion: add version

Inject current version for consistency with other sentry-dotnet docs:

Suggested change

Install-Package Sentry.OpenTelemetry.Exporter

Install-Package Sentry.OpenTelemetry.Exporter -Version {{@inject packages.version('sentry.dotnet') }}

Flash0ver · 2026-06-17T12:15:07Z

+```
+
+This package includes the standard OpenTelemetry OTLP exporter as a transitive dependency.


suggestion: add Packet

I suggest to also add a Paket install tab, to be consistent with docs of deprecated OTEL integration for .NET:

Suggested change

```

This package includes the standard OpenTelemetry OTLP exporter as a transitive dependency.

```

```shell {tabTitle:Paket CLI}

paket add Sentry.OpenTelemetry.Exporter --version {{@inject packages.version('sentry.dotnet') }}

```

This package includes the standard OpenTelemetry OTLP exporter as a transitive dependency.

Flash0ver · 2026-06-17T12:21:21Z

+## Supported Versions
+
+- .NET: 6.0+
+- Sentry.OpenTelemetry.Exporter: 5.0.0+
+- OpenTelemetry: 1.15.0+


issue: wrong versions
suggestion: remove Supported Versions section

The versions are wrong:

## Supported Versions -- .NET: 6.0+ +- .NET Standard 2.0 and compatible -- Sentry.OpenTelemetry.Exporter: 5.0.0+ +- Sentry.OpenTelemetry.Exporter: 6.5.0+ -- OpenTelemetry: 1.15.0+ +- OpenTelemetry: 1.10.0+

I do understand that these versions are added to be globally consistent with the OTLP docs from other platforms/SDKs.

I do suggest, however, to remove this section altogether, to be locally consistent with the rest of our .NET docs, as we usually don't have such a trailing section in other sentry-dotnet documentation pages.

giortzisg · 2026-06-17T08:15:36Z

-<Alert>
-
-The Sentry Go OpenTelemetry integration requires `go.opentelemetry.io/otel` (and its submodules), version `1.11.0` or higher.
+The OTLP-based OpenTelemetry integration requires `sentry-go` v0.47.0+, Go >= 1.25, and `go.opentelemetry.io/otel` v1.43.0+.


Suggested change

The OTLP-based OpenTelemetry integration requires `sentry-go` v0.47.0+, Go >= 1.25, and `go.opentelemetry.io/otel` v1.43.0+.

The OTLP-based OpenTelemetry integration requires `sentry-go` v0.45.0+, Go >= 1.25, and `go.opentelemetry.io/otel` v1.40.0+.

These are the minimum ones for the integration.

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

sl0thentr0py approved these changes Jun 17, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

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 16 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!

Flash0ver Jun 17, 2026

Uh oh!

Flash0ver Jun 17, 2026 •

edited

Loading

Uh oh!

Flash0ver Jun 17, 2026 •

edited

Loading

Uh oh!

Flash0ver Jun 17, 2026 •

edited

Loading

Uh oh!

Flash0ver Jun 17, 2026

Uh oh!

giortzisg Jun 17, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

	dotnet add package Sentry.OpenTelemetry.Exporter
	dotnet add package Sentry.OpenTelemetry.Exporter -v {{@inject packages.version('sentry.dotnet') }}

	Install-Package Sentry.OpenTelemetry.Exporter
	Install-Package Sentry.OpenTelemetry.Exporter -Version {{@inject packages.version('sentry.dotnet') }}

		```

		This package includes the standard OpenTelemetry OTLP exporter as a transitive dependency.

	The OTLP-based OpenTelemetry integration requires `sentry-go` v0.47.0+, Go >= 1.25, and `go.opentelemetry.io/otel` v1.43.0+.
	The OTLP-based OpenTelemetry integration requires `sentry-go` v0.45.0+, Go >= 1.25, and `go.opentelemetry.io/otel` v1.40.0+.

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!

Flash0ver Jun 17, 2026

Choose a reason for hiding this comment

Uh oh!

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

Uh oh!

Choose a reason for hiding this comment

Uh oh!

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

Uh oh!

Choose a reason for hiding this comment

Uh oh!

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

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Flash0ver Jun 17, 2026

Choose a reason for hiding this comment

Uh oh!

giortzisg Jun 17, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

dingsdax commented Jun 16, 2026 •

edited by Flash0ver

Loading

vercel Bot commented Jun 16, 2026 •

edited

Loading

Flash0ver Jun 17, 2026 •

edited

Loading

Flash0ver Jun 17, 2026 •

edited

Loading

Flash0ver Jun 17, 2026 •

edited

Loading