This is a patch release on the previous 1.39.0/0.60b0 release, fixing the issue(s) below.

Fixed

• opentelemetry-util-http, opentelemetry-instrumentation-requests, opentelemetry-instrumentation-wsgi, opentelemetry-instrumentation-asgi: normalize byte-valued user-agent headers before detecting synthetic sources so attributes are recorded reliably. (#4001)

• Ensure log event is written and completion hook is called even when model call results in exception. Put new log event ( gen_ai.client.inference.operation.details) behind the flag OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental. Ensure same sem conv attributes are on the log and span. Fix an issue where the instrumentation would crash when a pydantic.BaseModel class was passed as the response schema (#3905).
• Add the GEN_AI_OUTPUT_TYPE sem conv request attributes to events/spans generated in the stable instrumentation. This was added pre sem conv 1.36 so it should be in the stable instrumentation. Fix a bug in how system instructions were recorded in the gen_ai.system.message log event. It will now always be recorded as {"content" : "text of system instructions"}. See (#4011).

Added

• opentelemetry-instrumentation-requests, opentelemetry-instrumentation-wsgi, opentelemetry-instrumentation-asgi Detect synthetic sources on requests, ASGI, and WSGI. (#3674)
• opentelemetry-instrumentation-aiohttp-client: add support for url exclusions via OTEL_PYTHON_EXCLUDED_URLS / OTEL_PYTHON_AIOHTTP_CLIENT_EXCLUDED_URLS (#3850)
• opentelemetry-instrumentation-httpx: add support for url exclusions via OTEL_PYTHON_EXCLUDED_URLS / OTEL_PYTHON_HTTPX_EXCLUDED_URLS (#3837)
• opentelemetry-instrumentation-flask: improve readthedocs for sqlcommenter configuration. (#3883)
• opentelemetry-instrumentation-sqlalchemy: improve readthedocs for sqlcommenter configuration. (#3886)
• opentelemetry-instrumentation-mysql, opentelemetry-instrumentation-mysqlclient, opentelemetry-instrumentation-pymysql: improve readthedocs for sqlcommenter configuration. (#3885)
• opentelemetry-instrumentation-django: improve readthedocs for sqlcommenter configuration. (#3884)
• opentelemetry-instrumentation-aiohttp-server: add support for custom header captures via OTEL_INSTRUMENTATION_HTTP_CAPTURE_HEADERS_SERVER_REQUEST and OTEL_INSTRUMENTATION_HTTP_CAPTURE_HEADERS_SERVER_RESPONSE (#3916)
• opentelemetry-instrumentation-redis: add support for suppress_instrumentation context manager for both sync and async Redis clients and pipelines
• opentelemetry-instrumentation-django: improve docs for response_hook with examples of providing attributes from middlewares (#3923)
• Update for Log SDK breaking changes. Rename InMemoryLogExporter to InMemoryLogRecordExporter in several tests (#3589)
• opentelemetry-instrumentation: allow to skip all instrumentations loading with a wildcard (#3967)
• opentelemetry-instrumentation-redis: add missing copyright header for opentelemetry-instrumentation-redis (#3976)

Fixed

• opentelemetry-instrumentation-botocore: bedrock: Add safety check for bedrock ConverseStream responses (#3990)
• opentelemetry-instrumentation-botocore: bedrock: only decode JSON input buffer in Anthropic Claude streaming (#3875)
• opentelemetry-instrumentation-aiohttp-client, opentelemetry-instrumentation-aiohttp-server: Fix readme links and text (#3902)
• opentelemetry-instrumentation-aws-lambda: Fix ImportError with slash-delimited handler paths (#3894)
• opentelemetry-exporter-richconsole: Prevent deadlock when parent span is not part of the batch (#3900)
• opentelemetry-instrumentation-psycopg2, opentelemetry-instrumentation-psycopg: improve readthedocs for sqlcommenter configuration. (#3882)
• opentelemetry-instrumentation-aiohttp-server: delay initialization of tracer, meter and excluded urls to instrumentation for testability (#3836)
• Replace Python 3.14-deprecated asyncio.iscoroutinefunction with inspect.iscoroutinefunction. (#3880)
• opentelemetry-instrumentation-elasticsearch: Enhance elasticsearch query body sanitization (#3919)
• opentelemetry-instrumentation-pymongo: Fix span error descriptions (#3904)
• build: bump ruff to 0.14.1 (#3842)
• opentelemetry-instrumentation-redis: Add default span name for pipeline operations (#3941)
• opentelemetry-instrumentation-pymongo: Fix invalid mongodb collection attribute type (#3942)
• opentelemetry-instrumentation-aiohttp-client: Fix metric attribute leakage (#3936)
• opentelemetry-instrumentation-aiohttp-client: Update instrumentor to respect suppressing http instrumentation (#3957)

• 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)

Fixed

• opentelemetry-instrumentation-flask: Do not record http.server.duration metrics for excluded URLs. (#3794)
• opentelemetry-instrumentation-botocore: migrate off the deprecated events API to use the logs API (#3624)
• opentelemetry-instrumentation-dbapi: fix crash retrieving libpq version when enabling commenter with psycopg (#3796)
• opentelemetry-instrumentation-fastapi: Fix handling of APIRoute subclasses (#3681)

Added

• opentelemetry-instrumentation-botocore: Add support for AWS Secrets Manager semantic convention attribute (#3765)
• opentelemetry-instrumentation-dbapi: Add support for commenter_options in trace_integration function to control SQLCommenter behavior (#3743)
• Add rstcheck to pre-commit to stop introducing invalid RST (#3777)
• opentelemetry-exporter-credential-provider-gcp: create this package which provides support for supplying your machine's Application Default Credentials (https://cloud.google.com/docs/authentication/application-default-credentials) to the OTLP Exporters created automatically by OpenTelemetry Python's auto instrumentation. These credentials authorize OTLP traces to be sent to telemetry.googleapis.com. #3766.
• opentelemetry-instrumentation-psycopg: Add missing parameter capture_parameters to instrumentor. (#3676)
• opentelemetry-instrumentation-dbapi: Adds sqlcommenter to documentation. (#3720)

• Update instrumentation to use the latest semantic convention changes made in open-telemetry/semantic-conventions#2179. Now only a single event and span (gen_ai.client.inference.operation.details) are used to capture prompt and response content. These changes are opt-in, users will need to set the environment variable OTEL_SEMCONV_STABILITY_OPT_IN to gen_ai_latest_experimental to see them (#3799) and (#3709). Update instrumentation to call upload hook.
• Implement uninstrument for opentelemetry-instrumentation-vertexai (#3328)
• VertexAI support for async calling (#3386) - Migrate off the deprecated events API to use the logs API (#3625) - Update gen_ai_latest_experimental instrumentation to record files being passed to the model (#3840).

• Implement the new semantic convention changes made in open-telemetry/semantic-conventions#2179. A single event (gen_ai.client.inference.operation.details) is used to capture Chat History. This is opt-in, an environment variable OTEL_SEMCONV_STABILITY_OPT_IN needs to be set to gen_ai_latest_experimental to see them (#3386)
• Support CompletionHook for upload to cloud storage.

• Add jsonlines support to fsspec uploader (https://github.com/open-telemetry/opentelemetry-python-contrib/pull/3791)
• Rename "fsspec_upload" entry point and classes to more generic "upload" (https://github.com/open-telemetry/opentelemetry-python-contrib/pull/3798)
• Record content-type and use canonical paths in fsspec genai uploader (https://github.com/open-telemetry/opentelemetry-python-contrib/pull/3795)
• Make inputs / outputs / system instructions optional params to on_completion, (https://github.com/open-telemetry/opentelemetry-python-contrib/pull/3802). - Use a SHA256 hash of the system instructions as it's upload filename, and check if the file exists before re-uploading it, (https://github.com/open-telemetry/opentelemetry-python-contrib/pull/3814).

• Initial barebones package skeleton: minimal instrumentor stub, version module, and packaging metadata/entry point. (#3805)
• Implement OpenAI Agents span processing aligned with GenAI semantic conventions. (#3817)
• Input and output according to GenAI spec. (#3824)

• Add completion hook to genai utils to implement semconv v1.37.

  Includes a hook implementation using fsspec to support uploading to various pluggable backends.

  (#3780) (#3752) (#3759) (#3763)

• Add a utility to parse the OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT environment variable. Add gen_ai_latest_experimental as a new value to the Sem Conv stability flag (#3716).