NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #2855 most downloaded on PyPI
Test agent for Datadog APM client libraries
Last release 1 months ago
14 Aug 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
104 releases · first in 2021
One column per quarter.
Provider VCR: Fixes normalization support for a different form data boundary format used by the Node.js runtime.
Provider snapshot server: Introduces a provider snapshot server that can be used to record and play back provider API requests. The first unique reque
Adds /evp_proxy/v2/ as one of the endpoints listed from the /info endpoint.
Add /evp_proxy/v2/api/intake/llm-obs/v1/eval-metric and /evp_proxy/v2/api/intake/llm-obs/v2/eval-metric endpoints to collect LLM Observability evaluat
Actually make the SNAPSHOT_REGEX_PLACEHOLDERS feature also work during comparison, and not only generation.
Add a SNAPSHOT_REGEX_PLACEHOLDERS option to allow infrastructure independent snapshots.
### Bug Fixes - Publish wheels to PyPI.
Add agent support for Span Events.
Nothing published for this version
Added a /test/settings endpoint to change the settings on the fly. It takes a json encoded list of key/values, that will be applied to the app dict. E
Add Datadog-Agent-State header to /info endpoint.
Add peer_tags field to /info endpoint for testing client side stats.
Updates the logic for associating requests with a session. Prior to this change:
Updates the logic for associating requests with a session. Prior to this change:
After this change:
(2) Requests with existent tokens return all matching requests + all untokenized requests after the session was created but only up to the next session creation.
Requests without a token continue to return all requests.
Add a <span class="title-ref">client</span> module which provides an API client that can be used to programmatically interface with the test agent.
Add support for Python 3.12. The interpreter used in the Docker image is now also Python 3.12. This should lead to some better error messages and some performance improvement.
Add the ability to set the trace sample rates returned by the agent.
Add /tracer_flare/v1 endpoint with basic form-field validation.
/tracer_flare/v1 endpoint with basic form-field validation./test/session/tracerflares endpoint to return all tracer-flares received by the test agent for a given session token.pathway.hash span tag to the ignored attributes for a trace snapshot.Added ability to parse and verify span links in payloads as well as comparing them in snapshots.
Add GET method support for the /v0.7/config endpoint. The Go library uses GET requests and the Datadog Agent supports multiple HTTP methods.
/v0.7/config endpoint. The Go library uses GET requests and the Datadog Agent supports multiple HTTP methods.Add fix for getting tested integrations when multiple session tokens are used. When no session token is included for a [GET] request to /test/integrat
[GET] request to /test/integrations/tested_versions, all tested integrations are returned.Add support for tracking the integrations being tested. Tracked integrations can be recorded by a \[PUT\] request to the Test Agent at /test/session/i
/test/session/integrations. To get data about which integrations the Test Agent encountered, make a [GET] request to /test/integrations/tested_versions. Tested integrations include information such as the integration name, the tested integration version, the tracer language, the tracer version and the dependency name of the integration.Adds plain/text content-type for responses after request forwarding.
Adds plain/text content-type for responses after request forwarding.
Checks have been changed to opt-in. This allows adding new checks before all languages have implemented the feature.
/test/session/requests.Fix message length for remote config requests.
Adds middleware to forward all received requests to the Agent URL, if set. Requests are only forwarded for the /traces , /stats , and /telemetry paths
DISABLE_ERROR_RESPONSES env variable or --disable-error-responses command line option. Adds a feature to pool Test-Agent Trace Check Failures in-memory using the DD_POOL_TRACE_CHECK_FAILURES env variable or --pool-trace-check-failures option. These failures can then be queried by the /test/trace_check/failures GET endpoint, which returns a <Response 200> if no failures occurred or <Response 400> with the Check Trace Failure messages in the response body if they exist.This change adds support for an optional trace JSON decoder that will attempt to parse a trace, even if the trace is partially misconformed, such as o
Add Remote Config endpoint (/v0.7/config) and endpoints to create/update Remote Config payloads (\` /test/session/responses/config )
/v0.7/config) and endpoints to create/update Remote Config payloads (`<span class="title-ref">/test/session/responses/config</span>)Fix race condition when the test agent would simultaneously handle requests which would read and write data.
Add metrics.process_id tag to ignored tags.
Add basic support for profiling. Profiling requests are now handled by the test agent. Nothing is done with the requests other than accepting them.
Add ddapm-test-agent-session-start and ddapm-test-agent-snapshot commands to provide a more convenient way to perform snapshots manually or in CI.
ddapm-test-agent-session-start and ddapm-test-agent-snapshot commands to provide a more convenient way to perform snapshots manually or in CI.Fix /test/traces endpoint attempting to decode non-trace requests.
Add metrics.process_id to default ignored attributes
POST /telemetry/proxy/api/v2/apmtelemetry endpoint and tracking telemetry requests./info endpoint.X-Datadog-Test-Trace-Stall-Seconds with /v0.4/trace requests or statically via the --trace-request-delay flag.Add support for distributed traces where an instrumented service sends a trace chunk where the root span has a parent not in the trace chunk.
Better snapshot error messages for unexpected number of traces received.
Handle span parent_id being undefined.
parent_id being undefined.Normalize trace stats snapshots using all the aggregation fields. This fixes an issue where snapshots could fail due to ordering of buckets.
Add /test/session/requests endpoint to return all requests made to the test agent for a given session token.
Add /test/session/requests endpoint to return all requests made to the test agent for a given session token.
Add support for the /v0.6/stats endpoint. All requests made to the endpoint will be stored and can be retrieved via the /test/session/requests or /test/session/stats endpoints. Note that snapshotting for stats is not yet implemented.
Implement trace stats snapshotting.
Trace stats are now included in the snapshot behaviour provided by the testagent.
Similar to traces, trace stats snapshots are output to a json file.
Fix log messages in ddapm-test-agent-fmt.
ddapm-test-agent-fmt.Added ddapm-test-agent-fmt to format or validate snapshot json files.
ddapm-test-agent-fmt to format or validate snapshot json files.Trace requests can now be proxied to an actual agent by passing an agent url to the test agent. This can be done by passing the --agent-url command-li
--agent-url command-line option or via the DD_AGENT_URL or DD_TRACE_AGENT_URL environment variables.Fix the snapshot matching algorithm which had previously assumed that trace ids would be unique across both sets of traces.
Move span attributes type, meta and metrics up in the JSON snapshot output to help with readability.
type, meta and metrics up in the JSON snapshot output to help with readability.Span output in snapshots are now ordered to be more human readable with the important attributes (name, service, resource) moved to the top of the JSO
-v/--version command line option to display the version.The test agent has been rewritten in Python and the API being cleaned up substantially.
The test agent has been rewritten in Python and the API being cleaned up substantially.
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →