Releases: DataDog/dd-trace-py
2.16.4
Bug Fixes
- Tracing
- botocore: Resolves the issue where the span pointer for deserialized DynamoDB requests (through the resource-based API) were not being generated.
- botocore: Resolves an issue where our span pointer calculation code added recently logged unactionable messages.
2.16.3
2.15.3
Bug Fixes
-
ASM:
- The new user events policy is preventing users PII to be added by default as span tags. To allow customers using the Django auto instrumentation to still have those information, new environment variables have been added. In particular DD_DJANGO_INCLUDE_EMAIL (false by default), will tag user events with user email as before.
-
LLM Observability:
- Resolves an issue where annotating spans with non-ASCII language input/output values resulted in encoded unicode being submitted.
-
Code Security:
- Add googlecloudsdk,google auth, umap, numba and pynndescent to the Code Security deny list.
-
Profiling:
-
Fixes an issue where cpu-time was not profiled for services using gunicorn, when `DD_PROFILING_STACK_V2_ENABLED was set.
-
The lock profiler would log a warning if it couldn't determine a
name for a lock, and it would try determining a name multiple times for the same lock. This lead to excessive log spam. Downgrade this to a debug log and only try to determine the name once. -
Fixes an issue where the sample pool could deadlock after
fork()
by clearing it in the child process.
-
2.17.0rc1
New Features
-
ASM
- Adds support for session fingerprints.
-
LLM Observability
- When not using a provider integration (OpenAI, Anthropic, or Bedrock) with the LangChain integration, token metrics will be appended to the LLM Observability
llmspan. - When langchain's
chat_model.with_structured_output(..., method="json_mode")is used, orresponse_format={"type": "json_object"}is passed into a langchain chat model invocation, the LLM Observability span will be anllmspan instead of aworkflowspan.
- When not using a provider integration (OpenAI, Anthropic, or Bedrock) with the LangChain integration, token metrics will be appended to the LLM Observability
-
Single Step Instrumentation
- Adds
requirements.jsonto SSI artifact for bailing out on unsupported systems.
- Adds
-
Tracing
- Adds support for expanding AWS request/response payloads into flattened span tags.
- Updates the service naming algorithm to infer the base service name when
DD_SERVICEis not set, replacing instances ofunnamed-python-service. Ensures that a more meaningful service name is used whenever possible, enhancing clarity in service identification.
Bug Fixes
-
ASM/Threats
- The new user events policy is preventing users PII to be added by default as span tags. To allow customers using the Django auto instrumentation to still have those information, new environment variables have been added. In particular
DD_DJANGO_INCLUDE_EMAIL(false by default), will tag user events with user email as before.
- The new user events policy is preventing users PII to be added by default as span tags. To allow customers using the Django auto instrumentation to still have those information, new environment variables have been added. In particular
-
Code Security/IAST
- Adds googlecloudsdk and google auth to the Code Security deny list.
- Resolves an issue where importing the
google.cloud.storage.batchmodule would fail raising anImportError.
-
Crashtracking
- Fixes an issue where the use of the crashtracking component could result in zombie processes.
-
Lib-Injection
- Adds more commands to the auto-injection denylist.
- Ensures we do not import the user installed
ddtraceif it is present. - Fixes injection guardrail check when
sys.argvis not available.
-
LLM Observability
- Resolves an issue where annotating spans with non-ASCII language input/output values resulted in encoded unicode being submitted.
-
Profiling
- Fixes a data race where span information associated with a thread was read and updated concurrently, leading to segfaults
- Fixes an issue where cpu-time was not profiled for services using gunicorn, when
DD_PROFILING_STACK_V2_ENABLEDwas set. - Fixes an issue where enabling native exporter via
DD_PROFILING_EXPORT_LIBDD_ENABLED,DD_PROFILING_TIMELINE_ENABLEDorDD_PROFILING_STACK_V2_ENABLEDturned off live heap profiling. - The lock profiler would log a warning if it couldn't determine a name for a lock, and it would try determining a name multiple times for the same lock. This lead to excessive log spam. Downgrade this to a debug log and only try to determine the name once.
- Fixes an issue where the profiler was allocating too much memory from
ensure_binary_or_empty()function, on Python versions before 3.12, withDD_PROFILING_EXPORT_LIBDD_ENABLEDorDD_PROFILING_TIMELINE_ENABLED. - Fixes an issue where the sample pool could deadlock after
fork()by clearing it in the child process. - When a Python thread finishes, this change frees memory used for mapping its thread id to
Span. The mapping is populated and used whenDD_PROFILING_ENDPOINT_COLLECTION_ENABLEDandDD_PROFILING_STACK_V2_ENABLEDwere set to enable grouping of profiles for endpoints.
-
Tracing
- pymongo: Adds type checking to solve an issue where
NoneTypeinstead of expectedPinobject would throw an error inTracedTopologymethod.
- pymongo: Adds type checking to solve an issue where
2.16.2
Bug Fixes
-
Profiling
- The lock profiler would log a warning if it couldn't determine a name for a lock, and it would try determining a name multiple times for the same lock. This lead to excessive log spam. Downgrade this to a debug log and only try to determine the name once.
-
Tracing
- pymongo: Adds type checking to solve an issue where
NoneTypeinstead of expectedPinobject would throw an error inTracedTopologymethod.
- pymongo: Adds type checking to solve an issue where
2.14.7
Bug Fixes
-
Code Security:
- Add googlecloudsdk and google auth to the Code Security deny list.
-
Profiling:
-
Fixes an issue where cpu-time was not profiled for services using gunicorn, when
DD_PROFILING_STACK_V2_ENABLEDwas set. -
Fixes an issue where the sample pool could deadlock after
fork()by clearing it in the child process.
-
2.16.1
Bug Fixes
-
Threats
- The new user events policy is preventing users PII to be added by default as span tags. To allow customers using the Django auto instrumentation to still have those information, new environment variables have been added. In particular
DD_DJANGO_INCLUDE_EMAIL(false by default), will tag user events with user email as before.
- The new user events policy is preventing users PII to be added by default as span tags. To allow customers using the Django auto instrumentation to still have those information, new environment variables have been added. In particular
-
Code Security
- Add googlecloudsdk and google auth to the Code Security deny list.
-
Crashtracking
- Fixes an issue where the use of the crashtracking component could result in zombie processes.
-
Lib-Injection
- This fix adds more commands to the auto-injection denylist.
- This fix ensures we do not import the user installed
ddtraceif it is present.
-
LLM Observability
- Resolves an issue where annotating spans with non-ASCII language input/output values resulted in encoded unicode being submitted.
-
Profiling
- Fixes an issue where cpu-time was not profiled for services using gunicorn, when
DD_PROFILING_STACK_V2_ENABLEDwas set. - Fixes an issue where the profiler was allocating too much memory from
ensure_binary_or_empty()function, on Python versions before 3.12, withDD_PROFILING_EXPORT_LIBDD_ENABLEDorDD_PROFILING_TIMELINE_ENABLED. - Fixes an issue where the sample pool could deadlock after
fork()by clearing it in the child process.
- Fixes an issue where cpu-time was not profiled for services using gunicorn, when
2.15.2
Bug Fixes
- Profiling:
- Fixes an issue where enabling native exporter via
DD_PROFILING_EXPORT_LIBDD_ENABLED,DD_PROFILING_TIMELINE_ENABLEDorDD_PROFILING_STACK_V2_ENABLEDturned off live heap profiling. - Fixes an issue where the profiler was allocating too much memory from
ensure_binary_or_empty()function, on Python versions before 3.12, withDD_PROFILING_EXPORT_LIBDD_ENABLEDorDD_PROFILING_TIMELINE_ENABLED. - When a Python thread finishes, this change frees memory used for mapping its thread id to
Span. The mapping is populated and used whenDD_PROFILING_ENDPOINT_COLLECTION_ENABLEDandDD_PROFILING_STACK_V2_ENABLEDwere set to enable grouping of profiles for endpoints. - Resolves an issue where asyncio task names are not captured by stack v2, when
DD_PROFILING_STACK_V2_ENABLEDis set.
- Fixes an issue where enabling native exporter via
- Tracing:
- pymongo: Adds type checking to solve an issue where
NoneTypeinstead of expectedPinobject would throw an error inTracedTopologymethod.
- pymongo: Adds type checking to solve an issue where
2.14.6
Bug Fixes
-
Profiling
- Fixes an issue where enabling native exporter via
DD_PROFILING_EXPORT_LIBDD_ENABLED,DD_PROFILING_TIMELINE_ENABLEDorDD_PROFILING_STACK_V2_ENABLEDturned off live heap profiling. - Fixes an issue where the profiler was allocating too much memory from
ensure_binary_or_empty()function, on Python versions before 3.12, withDD_PROFILING_EXPORT_LIBDD_ENABLEDorDD_PROFILING_TIMELINE_ENABLED. - When a Python thread finishes, this change frees memory used for mapping its thread id to
Span. The mapping is populated and used whenDD_PROFILING_ENDPOINT_COLLECTION_ENABLEDandDD_PROFILING_STACK_V2_ENABLEDwere set to enable grouping of profiles for endpoints. - Resolves an issue where asyncio task names are not captured by stack v2, when
DD_PROFILING_STACK_V2_ENABLEDis set.
- Fixes an issue where enabling native exporter via
-
Tracing
- pymongo: Adds type checking to solve an issue where
NoneTypeinstead of expectedPinobject would throw an error inTracedTopologymethod.
- pymongo: Adds type checking to solve an issue where
2.16.0
New Features
-
LLM Observability
- When starting LLM and embedding spans, the
model_nameargument is now optional and will default tocustom. This applies to both inline methods (e.g.LLMObs.llm()) and function decorators (e.g.@llm). - Introduces the ability to add metadata for evaluation metrics via the
submit_evaluationmethod. For more information, see submitting evaluations with the SDK.
- When starting LLM and embedding spans, the
-
Tracing
- Introduces support for Baggage as defined by the OpenTelemetry specification.
- botocore: Adds span pointers for successful DynamoDB
BatchWriteItemspans. Table Primary Keys will need to be provided with theddtrace.config.botocore.dynamodb_primary_key_names_for_tablesoption or theDD_BOTOCORE_DYNAMODB_TABLE_PRIMARY_KEYSenvironment variable to correctly handle thePutRequestitems. - botocore: Adds span pointers for successful DynamoDB
TransactWriteItemsspans. Table Primary Keys will need to be provided with theddtrace.config.botocore.dynamodb_primary_key_names_for_tablesoption or theDD_BOTOCORE_DYNAMODB_TABLE_PRIMARY_KEYSenvironment variable to correctly handle thePutitems. - botocore: Adds
ddtrace.config.botocore.add_span_pointersoption or theDD_BOTOCORE_ADD_SPAN_POINTERSenvironment variable to control adding span pointers to some successful AWS API requests. This option is enabled by default.
Bug Fixes
-
CI Visibility
- Fixes a bug where
CODEOWNERSwould incorrectly fail to discard line-level trailing comments (eg:@code/owner # my commentwould result in codeowners being parsed as@code/owner,#,my, andcomment) - Fixes unnecessary logging of an exception that would appear when trying to upload git metadata in an environment without functioning git (eg: missing
gitbinary or.gitdirectory)
- Fixes a bug where
-
Code Security
- Resolves an issue where importing the
google.cloud.storage.batchmodule would fail raising an ImportError
- Resolves an issue where importing the
-
Dynamic Instrumentation
- Fixes an issue that prevented dynamic span tags probes from adding the requested tags to the requested span.
-
LLM Observability
- Resolves two issues with annotation contexts:
- annotations registered via annotation contexts were being applied globally. Annotations are now only applied to the current trace context and do not pollute to other threads & processes.
- annotations from nested annotation contexts were applied in a non-deterministic order. Annotations are now applied in the order they were registered.
- Resolves an issue where input and output values equal to zero were not being annotated on workflow, task, agent and tool spans when using
LLMObs.annotate. - Resolves errors where the disabled setting was being ignored when forking.
- Resolves two issues with annotation contexts:
-
Profiling
- Fixes a data race where span information associated with a thread was read and updated concurrently, leading to segfaults.
- Fixes an issue where enabling native exporter via
DD_PROFILING_EXPORT_LIBDD_ENABLED,DD_PROFILING_TIMELINE_ENABLEDorDD_PROFILING_STACK_V2_ENABLEDturned off live heap profiling. - When a Python thread finishes, this change frees memory used for mapping its thread id to
Span. The mapping is populated and used whenDD_PROFILING_ENDPOINT_COLLECTION_ENABLEDandDD_PROFILING_STACK_V2_ENABLEDwere set to enable grouping of profiles for endpoints. - Resolves an issue where asyncio task names are not captured by stack v2, when
DD_PROFILING_STACK_V2_ENABLEDis set. - Resolves an issue where endpoint profiling for stack v2 throws
TypeErrorexception when it is given aSpanwithNonespan_type.
-
Tracing
- Resolves the issue where tracer flares would not be generated if unexpected types were received in the
AGENT_CONFIGremote configuration product. - elasticsearch: Resolves an issue where span tags were not fully populated on "sampled" spans, causing metric dimensions to be incorrect when spans were prematurely marked as sampled, including resource_name.
- Resolves the issue where tracer flares would not be generated if unexpected types were received in the
Other Changes
- LLM Observability
- Updates the merging behavior for tags when
LLMObs.annotateis called multiple times on the same span so that the latest value for a tag key overrides the previous value.
- Updates the merging behavior for tags when