OTLPIntegration

[sl0thentr0py]

• setup external propagation context to fetch trace_id/span_id from otel
• setup otlp exporter with endpoint and headers taken from DSN
• setup propagator
• exporter and propagator are setup by default, can be turned off in case people want to setup manually

Issues

• resolves Implement OtlpIntegration for Python SDK #4935
• resolves PY-1894

[codecov]

Codecov Report

❌ Patch coverage is 90.56604% with 5 lines in your changes missing coverage. Please review.
✅ Project coverage is 83.99%. Comparing base (659bd84) to head (75c4163).
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
sentry_sdk/integrations/otlp.py	90.38%	3 Missing and 2 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #4877      +/-   ##
==========================================
+ Coverage   83.92%   83.99%   +0.07%     
==========================================
  Files         179      180       +1     
  Lines       17948    18001      +53     
  Branches     3193     3199       +6     
==========================================
+ Hits        15062    15120      +58     
+ Misses       1913     1908       -5     
  Partials      973      973              

Files with missing lines	Coverage Δ
sentry_sdk/consts.py	99.40% <100.00%> (+<0.01%)	⬆️
sentry_sdk/integrations/otlp.py	90.38% <90.38%> (ø)

... and 3 files with indirect coverage changes

[linear]

PY-1894 Implement OtlpIntegration for Python SDK

[sl0thentr0py]

sentry error + sentry log + otlp trace

[sl0thentr0py]

distributed tracing also works 🎉

[alexander-alderman-webb]

Looks good! A few questions just so I understand what's going on better as well.

[alexander-alderman-webb]

Why do we set two headers in the transport and only one here? See

sentry-python/sentry_sdk/transport.py

Lines 325 to 330 in 659bd84

	headers.update(
	{
	"User-Agent": str(self._auth.client),
	"X-Sentry-Auth": str(self._auth.to_header()),
	}
	)

[sl0thentr0py]

good question! user agent is already set by otlp, which I think is fine to distinguish it from a normal (sentry-traces-only) user
https://github.com/open-telemetry/opentelemetry-python/blob/f3b9e6ec96b7cc3717d5c8b529da7a8923810973/exporter/opentelemetry-exporter-otlp-proto-http/src/opentelemetry/exporter/otlp/proto/http/__init__.py#L77-L80

[alexander-alderman-webb]

When dsn is None, is there any point in setting up the provider and processor?

Not sure if I am missing something because I am not as familiar with OTel. I would have thought if dsn is None we could exit early, maybe with a warning message.

[sl0thentr0py]

they can still manually set env variables as follows:

export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://o0.ingest.sentry.io/api/0/integration/otlp/v1/traces"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="x-sentry-auth=sentry sentry_key=examplePublicKey"

which will be picked up by otel internally when initializing the exporter. Leaving it open as an option just in case someone has a complicated ops setup.

[sl0thentr0py]

we'll iterate on the DX here once we get some feedback/complaints/confusion

[alexander-alderman-webb]

When running this test I see the message below. I'm trying to find where this is coming from.

Failed to export span batch code: 404, reason: You should be really using o*.ingest.sentry.io domains.

[sl0thentr0py]

mocked

[alexander-alderman-webb]

🚀

[alexander-alderman-webb]

Last thing that'd be good before merging.

Since pip install "opentelemetry-distro[otlp]" also pulls in grpcio, and grpcio does not distribute free-threading wheels, these new tests take like 17 mins to run in CI on free-threading 3.14.

https://github.com/getsentry/sentry-python/actions/runs/19139690916/job/54701021577?pr=4877

So I suggest we do not run the new test suite on 3.14t.

Also, as an fyi: for running populate_tox.py, I add a uv command for running it with the new pre-requisites to the README in https://github.com/getsentry/sentry-python/pull/5076/files

That said, in this case you can just edit tox.jinja and tox.ini manually, since it's just removing a single version.