ddtrace 3.14.0rc2

on Python PyPI

Estimated end-of-life date, accurate to within three months: 08-2026
See the support level definitions for more information.

New Features

• ai_guard
  • add AI Guard evaluations support to LangChain instrumentation
  • add evaluation support to streaming LangChain APIs
• LLM Observability
  • ml_app is now optional, defaulting to service. while it is still recommended to set ml_app, enabling LLM Observability will no longer throw if one is not provided or propagated from an upstream service.
  • This introduces a tool_definitions parameter to the LLMObs.annotate() method for tool calling scenarios. Users can now pass a list of tool definition dictionaries directly to annotate LLM spans with available tools. Each tool definition must include a name (string) field, with optional description (string) and schema (JSON-serializable dictionary) fields.
  • Experiments (beta) dataset methods (create_dataset, create_dataset_from_csv and pull_dataset) argument name is changed to dataset_name.

Bug Fixes

• AAP
  • make sure the status code for downstream requests is properly sent to libddwaf.
  • Resolves an incompatibility with gevent>=25.8.1 that would cause a deadlock when starting the waf via remote config.
• django: Fixes issue causing ValueError: coroutine already executing on Python 3.13+ with django.utils.decorators.async_only_middleware.
• asyncpg: Fix the error "Error: expected pool connect callback to return an instance of 'asyncpg.connection.Connection', got 'ddtrace.contrib.internal.asyncpg.patch._TracedConnection'" due to using the custom connect option. With this fix, postgres.connect spans will be created when this option is used.
• exception replay: fixed an issue that prevented snapshots from retrieving local variables from traceback frames from exception thrown by Celery tasks.
• LLM Observability
  • This fix resolves an issue where decorated functions returning responses with an ambiguous truth value (e.g. pandas dataframes) would raise an error due to the inability to coerce the value into a boolean.
  • Fixes an issue where certain Google GenAI LLM requests were not being traced due to importing from google.genai.types on startup.
• Fixed an issue that could have caused some products to fail to start properly in applications that use pkg_resources, either directly or indirectly.
• profiling: Upgrades echion to pick up critical bug fixes and performance improvements.
• CI Visibility: This fix resolves an issue where coverage from sessions with pytest-xdist were not submitted with the proper session id, preventing Test Impact Analysis feature from working properly.