ddapm-test-agent

library1.65.0pypypiunverified

The Datadog APM Test Agent is a Python-based utility that simulates the Datadog Agent for local testing and development of APM client libraries. It allows developers to capture, inspect, and validate traces, snapshots, and other observability data without requiring a full Datadog Agent setup. The current version is 1.46.0, with a frequent release cadence, often multiple times a month, for new features and bug fixes.

testing observability

pip install ddapm-test-agent

github ↗package ↗

INSTALL

IMPORT

SIG · DDAPM-TEST-AGENT

ddapm-test-agent

testingpythonv1.65.0

Install

—

Import

—

Disk

—

Pass rate

0/ 10

Env Coverage0 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v? · pip install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

timeout

glibc

py 3.10–3.95 runs

timeout

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ddapm-test-agent

✓ This library is primarily a command-line interface (CLI) tool and is not typically imported into Python code. Its functionality is accessed by running the `ddapm-test-agent` or `lapdog` commands in a terminal.

The `ddapm-test-agent` package provides executable commands, not Python modules for direct import and usage within an application's code. Interaction is typically via shell commands or configured client libraries.

To quickly start the Datadog APM Test Agent, simply run `ddapm-test-agent` in your terminal. For LLM Observability features, especially with Claude Code, use `lapdog start`. Ensure your APM client library is configured to point to the test agent's default host (localhost) and port (e.g., 8126 for traces) via environment variables or configuration.

# Start the basic test agent ddapm-test-agent # Or, for LLM observability with Claude hooks lapdog start # Your APM client library (e.g., dd-trace-py) should be configured # to send traces to the agent's default port (e.g., localhost:8126). # Example for dd-trace-py (ensure DD_AGENT_HOST and DD_TRACE_AGENT_PORT are set appropriately) # export DD_AGENT_HOST=localhost # export DD_TRACE_AGENT_PORT=8126 # python your_instrumented_app.py

ddapm-test-agent --version

Debug

Known issues

gotchaSince v1.40.0, LLM Observability data forwarding to Datadog is enabled by default. If you are using the test agent for local development and do not wish to send LLM-related data to your Datadog account, you must explicitly disable this feature.

fix

Set the `DISABLE_LLMOBS_DATA_FORWARDING` environment variable to `true`, or use the `--disable-llmobs-data-forwarding` command-line argument when starting the agent.

affects: >=1.40.0

deprecatedThe VCR dependency has been removed in v1.38.0. The test agent now produces and primarily uses JSON cassettes. Existing VCR cassettes are converted to JSON on first use and then removed. Support for legacy VCR cassettes will be fully removed in version 2.0.0.

fix

Migrate any existing VCR-specific cassette logic or rely on the agent's automatic conversion to JSON cassettes. Plan for complete removal of VCR cassette support in future major versions.

affects: >=1.38.0

gotchaFor Claude Code API calls, the recommended method changed from relying on `ANTHROPIC_BASE_URL` to using the `ddapm-test-agent-run claude` CLI launcher in v1.44.0. The new launcher also includes a Javascript fetch interceptor.

fix

Switch to `ddapm-test-agent-run claude` for routing Claude Code API calls through the test agent proxy to ensure proper interception and instrumentation.

affects: >=1.44.0

gotchaAn issue causing `TypeError` exceptions on Python 3.8 and 3.9 when running the test agent or `lapdog` was fixed in v1.45.1. Users on version 1.45.0 might encounter these errors.

fix

Upgrade to `ddapm-test-agent` version 1.45.1 or later to resolve Python 3.8/3.9 compatibility issues.

affects: ==1.45.0

Upgrade

Version history

1.65.0latest on PyPI · released Aug 14, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

22 hits · last 30 days

node

OpenAI (training)

Amazon

Resources

githubhttps://github.com/Datadog/dd-apm-test-agent ↗

packagehttps://pypi.org/project/ddapm-test-agent/ ↗