chore: Deprecate OpenTelemetryIntegration in favor of OTLPIntegration and no-op for span first#6494
Merged
Merged
Conversation
sl0thentr0py
force-pushed
the
neel/span-first/otel
branch
from
87aa5ec to
80d8444
Compare
sl0thentr0py
changed the title
alexander-alderman-webb
approved these changes
Jun 3, 2026
![sentry-warden[bot]](https://avatars.githubusercontent.com/in/2755838?s=60&v=4){kind=small}
sl0thentr0py
force-pushed
the
neel/span-first/otel
branch
from
80d8444 to
0c1606f
Compare
![sentry[bot]](https://avatars.githubusercontent.com/in/12637?s=60&v=4){kind=small}
Contributor
Codecov Results 📊✅ 88326 passed | ⏭️ 6022 skipped | Total: 94348 | Pass Rate: 93.62% | Execution Time: 292m 39s 📊 Comparison with Base Branch
All tests are passing successfully. ✅ Patch coverage is 100.00%. Project has 2472 uncovered lines. Coverage diff@@ Coverage Diff @@
## main #PR +/-##
==========================================
- Coverage 89.39% 89.38% -0.01%
==========================================
Files 192 192 —
Lines 23265 23273 +8
Branches 7996 7998 +2
==========================================
+ Hits 20797 20801 +4
- Misses 2468 2472 +4
- Partials 1309 1309 —Generated by Codecov Action |
6 tasks
Merged
6 tasks
dingsdax
added a commit
to getsentry/sentry-docs
that referenced
this pull request
Jul 7, 2026
…8441) 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 <details> <summary><b>PHP</b> (<code>sentry-php</code>, <code>sentry-symfony</code>, <code>sentry-laravel</code>)</summary> **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. </details> <details> <summary><b>.NET</b> (<code>sentry-dotnet</code>)</summary> **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. </details> <details> <summary><b>Python</b> (<code>sentry-python</code>)</summary> **Updated page:** - `docs/platforms/python/tracing/instrumentation/opentelemetry.mdx` - Changed alert from "New Integration Option" to formal deprecation warning - `OpenTelemetryIntegration` was deprecated in getsentry/sentry-python#6494 (June 2026) **Verification:** existing OTLP docs confirmed correct against `sentry_sdk/integrations/otlp.py`. </details> <details> <summary><b>Ruby</b> (<code>sentry-ruby</code>)</summary> **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. </details> <details> <summary><b>Go</b> (<code>sentry-go</code>)</summary> **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`. </details> <details> <summary><b>Java</b> (<code>sentry-java</code>)</summary> **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. </details> ## 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: - [x] 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](https://github.com/orgs/getsentry/teams/docs) --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: Stefan Pölz <38893694+Flash0ver@users.noreply.github.com> Co-authored-by: Giannis Gkiortzis <58184179+giortzisg@users.noreply.github.com>
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
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.
Issues