ddtrace 3.0.0rc2

on Python PyPI

Upgrade Notes

• LLM Observability

  • langchain: Removes the langchain.tokens.total_cost span metric for OpenAI calls. For continued cost estimation of OpenAI calls, enable LLM Observability.
  • langchain: Removes prompt-completion log sampling from the LangChain integration. To continue logging prompt completions, enable LLM Observability.
  • langchain: Removes integration metrics from the LangChain integration. To continue tracking operational metrics from the OpenAI integration, enable LLM Observability or use trace metrics instead.
  • openai: Removes prompt-completion log sampling from the OpenAI integration. To continue logging prompt completions, enable LLM Observability.
  • openai: Removes integration metrics from the OpenAI integration. To continue tracking operational metrics from the OpenAI integration, enable LLM Observability or use trace metrics instead.

• Tracing

  • Drops support for multiple Tracer instances in the same process. Use ddtrace.trace.tracer to access the global tracer instance.
  • Drops support for multiple tracer instances, ddtrace.trace.Tracer can not be reinitialized.
  • Removes deprecated parameters from Tracer.configure(...) method and removes the Tracer.sampler attribute.
  • configurations: Drops support for deprecated tracing configurations. The following configurations are no longer supported:
    • DD_TRACE_SAMPLE_RATE, use DD_TRACE_SAMPLING_RULES instead.
    • DD_TRACE_API_VERSION=v0.3, the default v0.5 version is used instead.
    • DD_ANALYTICS_ENABLED, Datadog Analytics is no longer supported.
    • DD_TRACE_ANALYTICS_ENABLED, Datadog Analytics is no longer supported.
    • DD_HTTP_CLIENT_TAG_QUERY_STRING, DD_TRACE_HTTP_CLIENT_TAG_QUERY_STRING should be used instead.
    • DD_TRACE_SPAN_AGGREGATOR_RLOCK, disabling the span aggregator rlock is no longer supported.
  • configurations: Drops support for configuring DD_TRACE_METHODS with the [] notation. Ensure DD_TRACE_METHODS use the : notation instead.
  • opentracing: Removes the deprecated ddtracer parameter from ddtrace.opentracer.tracer.Tracer().
  • sampling: Drops support for configuring sampling rules using functions and regex in the ddtrace.tracer.sampler.rules[].choose_matcher(...) method and removes the timestamp_ns parameter from ddtrace.internal.rate_limiter.RateLimiter.is_allowed().
  • span: Removes the deprecated Span.sampled property.

New Features

• Tracing
  • valkey: Adds automatic instrumentation of the Valkey package. Thank you AhmadMasry!

Bug Fixes

• Tracing
  • aiohttp: Adds the environment variable DD_AIOHTTP_CLIENT_DISABLE_STREAM_TIMING_FOR_MEM_LEAK to address a potential memory leak in the aiohttp integration. When set to true, this flag may cause streamed response span timing to be inaccurate. The flag defaults to false.
  • logging: Resolves an an unneeded info log being logged on process exit due to a forksafe hook being unregistered that was never registered to begin with.