Skip to content

chore: Deprecate OpenTelemetryIntegration in favor of OTLPIntegration and no-op for span first - #6494

Merged
sl0thentr0py merged 1 commit into
masterfrom
neel/span-first/otel
Jun 3, 2026
Merged

chore: Deprecate OpenTelemetryIntegration in favor of OTLPIntegration and no-op for span first#6494
sl0thentr0py merged 1 commit into
masterfrom
neel/span-first/otel

Conversation

@sl0thentr0py

@sl0thentr0pysl0thentr0py commented Jun 3, 2026•
edited
Loading

Copy link
Copy Markdown
Member

Issues

@sl0thentr0py
sl0thentr0py requested a review from a team as a code ownerJune 3, 2026 13:10
@sl0thentr0py
sl0thentr0pyforce-pushed the neel/span-first/otel branch from 87aa5ec to 80d8444CompareJune 3, 2026 13:12
@linear-code

linear-codeBot commented Jun 3, 2026

Copy link
Copy Markdown

PY-2345

@sl0thentr0pysl0thentr0py changed the title chore: Deprecate OpenTelemetryIntegration in favor of OTLP and no-op for span firstchore: Deprecate OpenTelemetryIntegration in favor of OTLPIntegration and no-op for span firstJun 3, 2026
@sl0thentr0py
sl0thentr0py enabled auto-merge (squash) June 3, 2026 13:13
sentry-warden[bot]
sentry-wardenBot reviewed Jun 3, 2026
View reviewed changes
Comment threadsentry_sdk/integrations/opentelemetry/integration.py
@sl0thentr0py
sl0thentr0py disabled auto-merge June 3, 2026 13:14
@sl0thentr0py
sl0thentr0pyforce-pushed the neel/span-first/otel branch from 80d8444 to 0c1606fCompareJune 3, 2026 13:16
@sl0thentr0py
sl0thentr0py enabled auto-merge (squash) June 3, 2026 13:16
sentry[bot]
sentryBot reviewed Jun 3, 2026
View reviewed changes
Comment threadsentry_sdk/integrations/opentelemetry/integration.py
@sl0thentr0py
sl0thentr0py disabled auto-merge June 3, 2026 13:20
@sl0thentr0py
sl0thentr0py enabled auto-merge (squash) June 3, 2026 13:21
@github-actions

github-actionsBot commented Jun 3, 2026•
edited
Loading

Copy link
Copy Markdown
Contributor

Codecov Results 📊

✅ 88326 passed | ⏭️ 6022 skipped | Total: 94348 | Pass Rate: 93.62% | Execution Time: 292m 39s

📊 Comparison with Base Branch

MetricChange
Total Tests📈 +19
Passed Tests📈 +19
Failed Tests—
Skipped Tests—

All tests are passing successfully.

✅ Patch coverage is 100.00%. Project has 2472 uncovered lines.
❌ Project coverage is 89.38%. Comparing base (base) to head (head).

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

@sl0thentr0py
sl0thentr0py merged commit 5ce5d1a into masterJun 3, 2026
270 of 272 checks passed
@sl0thentr0py
sl0thentr0py deleted the neel/span-first/otel branch June 3, 2026 13:31
@sentry-release-botsentry-release-botBot mentioned this pull request Jun 8, 2026
Closed
6 tasks
@dingsdaxdingsdax mentioned this pull request Jun 16, 2026
Merged
6 tasks
dingsdax added a commit to getsentry/sentry-docs that referenced this pull request Jul 7, 2026
@dingsdax@claude
@Flash0ver@giortzisg
docs: Add missing OTLP integration docs and fix drift across SDKs (#1…
654034f
…8441)
closesgetsentry/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>
mgaligniana pushed a commit to mgaligniana/sentry-python that referenced this pull request Aug 9, 2026
@sl0thentr0py@mgaligniana
chore: Deprecate OpenTelemetryIntegration in favor of OTLPIntegration…
7f9e98e
… and no-op for span first (getsentry#6494)
#### Issues
* resolves: getsentry#6043
* resolves: PY-2345
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@sentrysentry[bot]sentry[bot] left review comments
@sentry-wardensentry-warden[bot]sentry-warden[bot] left review comments
@alexander-alderman-webbalexander-alderman-webbalexander-alderman-webb approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Migrate opentelemetry to span first

2 participants

@sl0thentr0py@alexander-alderman-webb