feat(openai): extend version range to support openai v3 by Copilot · Pull Request #393 · open-telemetry/opentelemetry-python-genai

Copilot · 2026-08-15T16:11:13Z

openai v3 ships httpx2 instead of httpx as its HTTP transport. The instrumentation hard-imported httpx directly, which broke on import with openai v3 installed.

Changes

pyproject.toml — Extend instruments extra upper bound: openai >= 1.26.0, < 4

utils.py / _raw_response.py — Conditional import: try httpx, fall back to httpx2

try:
    from httpx import URL
except ImportError:
    from httpx2 import URL

tests/requirements.latest.txt — Pin openai==3.1.0, replace httpx==0.28.1 → httpx2==2.7.0, drop opentelemetry-instrumentation-httpx (irrelevant for v3)
test_raw_response_httpx_interop.py — Replace bare import httpx with pytest.importorskip("httpx") so the module auto-skips under v3 (the httpx instrumentation interop test only applies when openai uses httpx)
test_embedding_invocation_unit.py — Same conditional URL import as production code

Type of change

New feature (non-breaking change which adds functionality)

How has this been tested?

Full test suite run against openai 3.1.0: 249 passed, 1 skipped (httpx interop module, expected).

Test A

Checklist

Followed the style guidelines of this project
Changelog updated if the change requires an entry
Unit tests added
Documentation updated

Fixes support openai v3 #382

Copilot · 2026-08-15T16:44:46Z

@lmolkova I've opened a new pull request, #395, to work on those changes. Once the pull request is ready, I'll request review from you.

lmolkova · 2026-08-15T16:45:37Z

@lmolkova I've opened a new pull request, #395, to work on those changes. Once the pull request is ready, I'll request review from you.

@copilot the ask was to add to this pr, not open the new one

Copilot · 2026-08-15T16:47:52Z

@lmolkova I've opened a new pull request, #395, to work on those changes. Once the pull request is ready, I'll request review from you.

@copilot the ask was to add to this pr, not open the new on...

Added to this PR. get_server_address_and_port now uses getattr(base_url, "host", None) / getattr(base_url, "port", None) instead of isinstance(URL), so it works with httpx.URL, httpx2.URL, and any future URL type. The httpx/httpx2 import is also removed from utils.py since it was only needed for the type check. A regression test is included. Changelog fragment at .changelog/393.fixed.

opentelemetry-pr-dashboard · 2026-08-15T16:57:16Z

Pull request dashboard status

Merged · refreshed 2026-08-19 23:18 UTC

Status above doesn't look right?

Anything look wrong? Report it with what you expected; it helps us improve the dashboard.

linux-foundation-easycla · 2026-08-19T13:04:40Z

The committers listed above are authorized under a signed CLA.

✅ login: lmolkova / name: Liudmila Molkova (01bf8fc, 186cf92, 32ce82e, 4e07915, 9030b62, c02814f, cd281f2, f3e0224, f6f934e)

Extend the supported version range for the openai library to include v3. openai v3 switched from httpx to httpx2 as its HTTP client library. Update the instrumentation to import URL and the HTTP response type from httpx with a fallback to httpx2, so both v1/v2 and v3 are supported. The httpx interop test is skipped when httpx is not installed (openai v3), since that test specifically exercises opentelemetry-instrumentation-httpx which only applies to the httpx transport used by openai v1/v2. Assisted-by: Claude Sonnet 4.6

…test Instead of a dedicated pytest.importorskip("httpx"), move import httpx after the existing pytest.importorskip("opentelemetry.instrumentation.httpx"). Since the httpx instrumentation depends on httpx, the existing importorskip already handles graceful skipping when httpx is absent (e.g. openai v3+). Assisted-by: Claude Sonnet 4.6

…nai v3 Use getattr-based host/port extraction instead of isinstance(URL) so server.address and server.port are recorded with any URL implementation (httpx.URL, httpx2.URL, or future types). This also removes the now-unused httpx/httpx2 URL import from utils.py. Adds a regression test verifying server.address is populated for a non-httpx URL (simulating httpx2.URL via SimpleNamespace). Fixes: server.address/server.port silently absent on openai v3+. Assisted-by: Claude Sonnet 4.6

Assisted-by: Claude Sonnet 4.6

Adds a requirements.latest2.txt pinned to openai 2.54.0 + httpx 0.28.1 and a corresponding tox factor so the httpx interop tests continue to run under CI alongside the openai v3 (httpx2) latest factor.

Copilot AI assigned Copilot and lmolkova Aug 15, 2026

Copilot started work on behalf of lmolkova August 15, 2026 16:11 View session

Copilot AI linked an issue Aug 15, 2026 that may be closed by this pull request

support openai v3 #382

Closed

opentelemetry-pr-dashboard Bot mentioned this pull request Aug 15, 2026

Pull Request Dashboard #171

Open

Copilot AI changed the title ~~[WIP] Extend version range to support OpenAI v3~~ feat(openai): extend version range to support openai v3 Aug 15, 2026

Copilot finished work on behalf of lmolkova August 15, 2026 16:22

Copilot AI requested a review from lmolkova August 15, 2026 16:22

lmolkova reviewed Aug 15, 2026

View reviewed changes

Comment thread ...entation/opentelemetry-instrumentation-genai-openai/tests/test_raw_response_httpx_interop.py Outdated

Copilot started work on behalf of lmolkova August 15, 2026 16:33 View session

lmolkova reviewed Aug 15, 2026

View reviewed changes

Comment thread instrumentation/opentelemetry-instrumentation-genai-openai/.changelog/393.changed

Copilot finished work on behalf of lmolkova August 15, 2026 16:35

Copilot AI requested a review from lmolkova August 15, 2026 16:35

Copilot started work on behalf of lmolkova August 15, 2026 16:35 View session

Copilot finished work on behalf of lmolkova August 15, 2026 16:36

Copilot AI mentioned this pull request Aug 15, 2026

[WIP] Fix missing server.address and server.port for openai v3 #395

Closed

Copilot started work on behalf of lmolkova August 15, 2026 16:45 View session

Copilot finished work on behalf of lmolkova August 15, 2026 16:48

lmolkova reviewed Aug 15, 2026

View reviewed changes

Comment thread ...lemetry-instrumentation-genai-openai/src/opentelemetry/instrumentation/genai/openai/utils.py

Copilot started work on behalf of lmolkova August 15, 2026 16:55 View session

lmolkova approved these changes Aug 15, 2026

View reviewed changes

lmolkova marked this pull request as ready for review August 15, 2026 16:56

lmolkova requested a review from a team as a code owner August 15, 2026 16:56

Copilot AI lite review requested due to automatic review settings August 15, 2026 16:56

Copilot finished work on behalf of lmolkova August 15, 2026 16:56

Copilot AI requested a review from lmolkova August 15, 2026 16:56

lmolkova force-pushed the copilot/support-openai-v3 branch 2 times, most recently from 2cbd6bd to 818ec19 Compare August 19, 2026 13:04

lmolkova force-pushed the copilot/support-openai-v3 branch from 818ec19 to 97b128e Compare August 19, 2026 13:05

lmolkova added 9 commits August 19, 2026 06:20

fix(openai): add comment explaining structural URL access

01bf8fc

Assisted-by: Claude Sonnet 4.6

fix(openai): remove unused noqa directive and update uv.lock

9030b62

feat(openai): add latest2 tox factor for openai v2 testing

32ce82e

Adds a requirements.latest2.txt pinned to openai 2.54.0 + httpx 0.28.1 and a corresponding tox factor so the httpx interop tests continue to run under CI alongside the openai v3 (httpx2) latest factor.

fix CI

cd281f2

fix(openai): update _instruments version constraint to < 4

f3e0224

docs: update generated README.md

4e07915

lmolkova force-pushed the copilot/support-openai-v3 branch from 97b128e to 4e07915 Compare August 19, 2026 13:27

lmolkova enabled auto-merge August 19, 2026 13:30

lmolkova added 2 commits August 19, 2026 09:33

Merge branch 'main' into copilot/support-openai-v3

7288613

Merge branch 'main' into copilot/support-openai-v3

75a6ace