PyPI · #3087 most downloaded on PyPI

opentelemetry-instrumentation-openai-v2

1.7M downloads/moopen-telemetry/opentelemetry-python-contrib ↗New releases in your daily digest, changelog included.

OpenTelemetry Official OpenAI instrumentation

Last release 5 months ago
01 May 2026
Release timing varies
gaps range from 4 weeks to 10 months
Unknown
no stable releases
Nothing withdrawn
no release was ever pulled
2 years old
5 releases · first in 2024

Release timeline

5 releases since 2024

202420252026

20242026

One column per month.

Releases

2.4b01 May 2026pre-releaseDeprecated
Migrate experimental path from deprecated LLMInvocation to InferenceInvocation, using handler.start_inference() and invocation.stop()/invocation.fail(…
Migrate experimental path from deprecated LLMInvocation to InferenceInvocation, using handler.start_inference() and invocation.stop()/invocation.fail() directly (#4502)

Use create_duration_histogram and create_token_histogram from opentelemetry-util-genai instead of defining bucket boundaries locally (#4501)

Import OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT from opentelemetry.util.genai.environment_variables instead of re-defining it locally, making opentelemetry-util-genai the single source of truth for this constant. (#4455)

Fix compatibility with wrapt 2.x by using positional arguments in wrap_function_wrapper() calls (#4445)

Fix ChoiceBuffer crash on streaming tool-call deltas with arguments=None (#4350)

Fix StreamWrapper missing .headers and other attributes when using with_raw_response streaming (#4113)

Add opt-in support for latest experimental semantic conventions (v1.37.0). Set OTEL_SEMCONV_STABILITY_OPT_IN to gen_ai_latest_experimental to enable. Add dependency on opentelemetry-util-genai pypi package. (#3715)

Add wrappers for OpenAI Responses API streams and response stream managers (#4280)

Add async wrappers for OpenAI Responses API streams and response stream managers (#4325)

Add strongly typed Responses API extractors with validation and content extraction improvements (#4337)

Add instrumentation for OpenAI Responses API create (#4474)

Add completion hook support. (#4315)

Fix response_format handling: map json_object/json_schema to json output type. (#4315)

Skip attribute values with openai.Omit value. (#4315)

Default empty string for gen_ai.request.model attribute on missing model. (#4494)

From the same repository

open-telemetry/opentelemetry-python-contrib

2.3b024 Dec 2025pre-release

Fix AttributeError when handling LegacyAPIResponse (from with_raw_response)

Fix AttributeError when handling LegacyAPIResponse (from with_raw_response) (#4017)
Add support for chat completions choice count and stop sequences span attributes (#4028)
Fix crash with streaming with_raw_response (#4033)
Bump to 1.30.0 semconv schema: gen_ai.request.seed instead of gen_ai.openai.request.seed (#4036)

Open source →

2.2b025 Nov 2025pre-releaseDeprecated

Migrate off the deprecated events API to use the logs API

Fix service tier attribute names: use GEN_AI_OPENAI_REQUEST_SERVICE_TIER for request attributes and GEN_AI_OPENAI_RESPONSE_SERVICE_TIER for response attributes. (#3920)
Added support for OpenAI embeddings instrumentation (#3461)
Record prompt and completion events regardless of span sampling decision. (#3226)
Filter out attributes with the value of NotGiven instances (#3760)
Migrate off the deprecated events API to use the logs API (#3625)

Open source →

2.1b018 Jan 2025pre-release

Coerce openai response_format to semconv format

Coerce openai response_format to semconv format (#3073)
Add example to opentelemetry-instrumentation-openai-v2 (#3006)
Support for AsyncOpenAI/AsyncCompletions (#2984)
Add metrics (#3180)

Open source →

2.0b08 Nov 2024pre-release

Use generic OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT environment variable to control if content of prompt, completion, and other messages is

Use generic OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT environment variable to control if content of prompt, completion, and other messages is captured. (#2947)
Update OpenAI instrumentation to Semantic Conventions v1.28.0: add new attributes and switch prompts and completions to log-based events. (#2925)
Initial OpenAI instrumentation (#2759)

Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →

ASGI instrumentation for OpenTelemetry