ddtrace 4.5.0rc1

on Python PyPI

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

Upgrade Notes

• dynamic instrumentation
  • log probes now use the debugger intake track. This requires Datadog agent version 7.49.0 or above.

Deprecation Notes

• tracing

  • DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED is deprecated and will be removed in version 5.0.0. 128-bit trace ID generation will become mandatory.

• The tracer parameter is deprecated in the following functions and class methods and will be removed in version 5.0.0:

  • aiohttp: trace_app
  • asgi: TraceMiddleware.__init__
  • bottle: TracePlugin.__init__
  • cherrypy: TraceMiddleware.__init__
  • falcon: TraceMiddleware.__init__
  • flask_cache: get_traced_cache
  • sqlalchemy: trace_engine
  • wsgi: WSGIMiddleware.__init__

  The ddtrace.trace.tracer singleton is always used.

New Features

• pymongo
  • Adds support for tracing pymongo 4.12+ AsyncMongoClient operations. The integration now automatically instruments both synchronous and asynchronous clients when using pymongo >= 4.12.
• Code Security (IAST)
  • This introduces support for Python 3.14 template strings (PEP-750). Template strings (t-strings) are now tracked for taint propagation, enabling detection of security vulnerabilities when user input is embedded in template strings.
• LLM Observability
  • Adds built-in evaluators for common evaluation tasks. The following evaluators are now available:
    • StringCheckEvaluator: Performs string comparison operations (equals, not equals, contains, case-insensitive contains).
    • RegexMatchEvaluator: Validates output against regex patterns with search, match, or fullmatch modes.
    • LengthEvaluator: Validates output length constraints by characters, words, or lines.
    • JSONEvaluator: Validates JSON syntax and optionally checks for required keys.
    • SemanticSimilarityEvaluator: Measures semantic similarity between output and expected output using embedding vectors.
  • Adds support for json metric type in evaluation metrics. Users can now submit dict values as evaluation metrics using LLMObs.submit_evaluation() with metric_type="json". Additionally, experiment evaluators that return dict values are automatically detected as json metric type.
  • Adds LLMJudge evaluator for automated evaluation of LLM outputs using another LLM as the judge. Supports OpenAI and Anthropic providers with boolean, score, categorical, and custom JSON schema output formats.

Bug Fixes

• lib injection
  • the injected site-packages directory is now added as the last entry in the PYTHONPATH environment variable (it previously was added before the last entry).
• profiling
  • Fixes crashes in the memory profiler caused by re-entering the Python interpreter from inside CPython's allocator hook.
  • This fix resolves an issue where stack profiler could hold frame references to greenlets, which could have already completed. This could delay garbage collecting local variables from the greenlet.
  • A bug where corrupted or circular stack chunk linked lists on Python 3.11+ could cause infinite recursion during stack unwinding was fixed.
  • This fix resolves an issue where the dropped frames indicator frame could be added multiple times when exporting the same sample repeatedly, resulting in duplicate "<N frame(s) omitted>" entries in profiling data and unbounded memory growth in the memory profiler.
• internal
  • This fix resolves an issue where ddtrace ignored the uwsgi --skip-atexit flag and registered Python atexit handlers regardless. This caused profiler cleanup code to run during process shutdown even when --skip-atexit was set, leading to crashes and hangs in uwsgi workers.
• tracing
  • This fix resolves an issue where traces may not be flushed during the handling of SIGTERM or SIGINT signals.
• Telemetry
  • handle closed logging streams in writer background threads