feat: add OTLP integration support

[giortzisg]

Description

This PR adds the OpenTelemetry integration for OTLP, while also separating the error linking from the span exporter. The PR also includes some deviations from the Spec, so that the package follows closely the OTel conventions.

The main changes:

• Adds a public sentryotel.NewErrorLinkingIntegration() for OTel users to link errors with traces.
• Decouple error linking to work without the sentry span map.
• Add the sentryotlp package where users can create a NewTraceExporter to send to sentry's otlp endpoint using the otlptracehttp exporter.
• Keep otlp http client configuration options for the TraceExporter

Deviations from the spec:

• There is no setup_otlp_traces_exporter flag since users need to manually provide the exporter to the TracerProvider
• No collector_url. For users that are already using the collector, the only thing they need to set up is the ErrorLinkingIntegration. Having a WithCollectorURL option mixes concerns, since the sentryotlp trace exporter should only forward to sentry. Using the collector with Sentry requires changing the otlp http configuration on the collector and not the integration level.

Issues

• resolves: Add OTLP support #1204
• resolves: GO-121
• docs: docs(go): Update OpenTelemetry docs for OTLP migration sentry-docs#17039
• otel landing page: https://github.com/getsentry/static-sites/pull/3999

Changelog Entry Instructions

To add a custom changelog entry, uncomment the section above. Supports:

• Single entry: just write text
• Multiple entries: use bullet points
• Nested bullets: indent 4+ spaces

For more details: custom changelog entries

Reminders

• Add GH Issue ID & Linear ID
• PR title should use conventional commit style (feat:, fix:, ref:, meta:)
• For external contributors: CONTRIBUTING.md, Sentry SDK development docs, Discord community

[linear-code]

GO-121 Add OTLP support

[github-actions]

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

Breaking Changes 🛠

• Add support for Echo v5 by Scorfly in #1183

New Features ✨

• Add OTLP integration support by giortzisg in #1229

• Add IsSensitiveHeader helper to easily distinguish which headers to scrub for PII. by giortzisg in #1239

Bug Fixes 🐛

• (ci) Update validate-pr action to remove draft enforcement by stephanie-anderson in #1237

Internal Changes 🔧

Deps

• Bump changelog-preview.yml from 2.24.1 to 2.25.2 by dependabot in #1247
• Bump getsentry/craft from 2.24.1 to 2.25.2 by dependabot in #1248
• Bump codecov/codecov-action from 5.5.2 to 6.0.0 by dependabot in #1245
• Bump actions/create-github-app-token from 2.2.1 to 3.0.0 by dependabot in #1246
• Bump actions/setup-go from 6.3.0 to 6.4.0 by dependabot in #1244

Other

• (otel) Bump OpenTelemetry SDK to 1.40.0 by giortzisg in #1243
• Update validate-pr workflow by stephanie-anderson in #1242
• Add PR validation workflow by stephanie-anderson in #1234

---

_{🤖 This preview updates automatically when you update the PR.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Autofix Details

Bugbot Autofix prepared a fix for the issue found in the latest run.

• ✅ Fixed: Event processor overwrites entire trace context losing fields
  • The event processor now updates trace_id and span_id in the existing event.Contexts["trace"] map (creating it only when absent), preserving SDK-populated trace fields.

Or push these changes by commenting:

@cursor push 38eedc31b4

Preview (38eedc31b4)

diff --git a/otel/internal/common/event_processor.go b/otel/internal/common/event_processor.go
--- a/otel/internal/common/event_processor.go
+++ b/otel/internal/common/event_processor.go
@@ -27,9 +27,12 @@
 	if event.Contexts == nil {
 		event.Contexts = make(map[string]map[string]any)
 	}
-	event.Contexts["trace"] = map[string]any{
-		"trace_id": otelSpanContext.TraceID().String(),
-		"span_id":  otelSpanContext.SpanID().String(),
+	traceContext, found := event.Contexts["trace"]
+	if !found || traceContext == nil {
+		traceContext = make(map[string]any)
+		event.Contexts["trace"] = traceContext
 	}
+	traceContext["trace_id"] = otelSpanContext.TraceID().String()
+	traceContext["span_id"] = otelSpanContext.SpanID().String()
 	return event
 }

diff --git a/otel/internal/common/event_processor_test.go b/otel/internal/common/event_processor_test.go
--- a/otel/internal/common/event_processor_test.go
+++ b/otel/internal/common/event_processor_test.go
@@ -22,7 +22,7 @@
 		{name: "without existing trace context"},
 		{
 			name:          "with existing trace context",
-			existingTrace: map[string]any{"trace_id": "123", "parent_span_id": "456"},
+			existingTrace: map[string]any{"trace_id": "123", "parent_span_id": "456", "op": "http.server"},
 		},
 	}
 
@@ -43,10 +43,12 @@
 			}))
 
 			got := linkTraceContextToErrorEvent(event, &sentry.EventHint{Context: ctx})
-			assert.Equal(t, map[string]any{
-				"trace_id": traceID.String(),
-				"span_id":  spanID.String(),
-			}, got.Contexts["trace"])
+			assert.Equal(t, traceID.String(), got.Contexts["trace"]["trace_id"])
+			assert.Equal(t, spanID.String(), got.Contexts["trace"]["span_id"])
+			if tt.existingTrace != nil {
+				assert.Equal(t, "456", got.Contexts["trace"]["parent_span_id"])
+				assert.Equal(t, "http.server", got.Contexts["trace"]["op"])
+			}
 		})
 	}
 }

_{This Bugbot Autofix run was free. To enable autofix for future PRs, go to the Cursor dashboard.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}