kyleverhoog/dd-trace-test-agent

Datadog测试代理

用于APM集成库的测试代理，提供跟踪不变性检查、快照测试等功能，帮助开发者验证APM库的正确性。

使用方法

本地使用

bash
# 拉取镜像
docker pull kyleverhoog/dd-trace-test-agent

# 运行测试代理并挂载快照目录
docker run --rm\
            -p 8126:8126\
            -e SNAPSHOT_DIR=/snaps\
            -v $HOME/dev/dd-trace-py/tests/snapshots:/snaps\
            kyleverhoog/dd-trace-test-agent:latest

CI环境使用

参见https://github.com/datadog/dd-trace-py/pull/1546%E3%80%82

核心功能

跟踪不变性检查

• 解码验证
• HTTP头跟踪计数匹配
• 跟踪内span ID无冲突
• 无多个根span
• span无循环引用
• 指标值为数值型、元数据值为字符串/数值型等类型检查（部分待实现）

快照测试

支持快照存储与对比，可通过参数忽略指定键值。

接口概述

/test/start

启动同步测试用例，需传入唯一token参数关联后续跟踪。

/test/snapshot

用于快照测试，支持通过token或X-Datadog-Test-Token头分组并发测试，可指定忽略键、快照目录或文件。

配置说明

环境变量

• SNAPSHOT_DIR：快照存储目录（默认./snaps）
• SNAPSHOT_CI：CI模式开关（0禁用，1启用，生成意外快照时失败）
• DD_TEST_AGENT_PORT：监听端口（默认8126）

开发指南

前提条件

安装https://github.com/technomancy/leiningen 2.0.0+。

运行

bash
# 启动Web服务器
lein ring server 8126
# 启动无头模式
lein ring server-headless 8126

打包与Docker构建

bash
# 打包为jar
lein ring uberjar
# 构建Docker镜像
docker build --tag agent:0.01 .
# 运行镜像
docker run --rm --publish 8126:8126 agent:0.01

Python库使用示例

同步模式

通过/test/start和/test/snapshot接口管理测试用例，验证跟踪结果：

python
def snapshot(ignores=None, file=None, dir=None):
    # 代码省略（详见原文档）

并行模式

通过HTTP头传递X-Datadog-Test-Token实现并发测试：

python
def snapshot(f):
    # 代码省略（详见原文档）