ddtrace 常见参数用法¶
Attention
当前案例使用 ddtrace 版本0.114.0（最新版本）进行测试
开启 query 参数¶
开启 query 参数，可以更直观方便的让用户看到当前请求携带了哪些参数，更直观的还原客户真实操作流程，但 query 开启参数只能采集到 url 上的参数，request Body 里面的参数目前尚不支持。默认为 false，表示为默认不开启。
-Ddd.http.server.tag.query-string=TRUE
配置远程采集链接¶
dd.agent.host 默认值是localhost，所以默认推送的是本地的 DataKit ，如果想推送远程 DataKit ，则需要配置 dd.agent.host。
-Ddd.agent.host=192.168.91.11
两种添加 Tag 方式¶
ddtrace 提供两种添加 tag 方式，效果一样。但还是推荐使用 dd.tags 方式
dd.trace.span.tags¶
将 projectName:observable-demo 添加到每个 span 的示例：
-Ddd.trace.span.tags=projectName:observable-demo
dd.tags¶
-Ddd.tags=user_name:joy
两种方式都能生成 tag，效果一样，都会在meta里面展示数据。
如果确实想要把 dd.tags标记的 tag 作为观测云的 标签 ，则需要在 ddtrace.conf 配置 customer_tags
[[inputs.ddtrace]]
endpoints = ["/v0.3/traces", "/v0.4/traces", "/v0.5/traces"]
customer_tags = ["projectName","user_name"]
效果如图
注意：如果自定义tag 包含了 tag 关键字，则会当成标签显示。
显示数据库实例名称¶
显示数据库的名称，默认显示数据库的类型，如需要显示数据库名称，将值设置成TRUE
-Ddd.trace.db.client.split-by-instance=TRUE
以上 demo 并没有加载数据库，所以想要达到这个效果，可以选择一个引入数据库的应用添加参数 dd.trace.db.client.split-by-instance=TRUE
效果图：
类或方法注入 Trace¶
ddtrace 支持给方法注入 Trace ，默认情况下，ddtrace 会对所有的 API 接口动态注入 Trace，如果想对非 API 类（方法）——一些重要的类和方法需要重点标记，可以通过 dd.trace.methods参数配置。
Environment Variable: DD_TRACE_METHODS
Default: null
Example: package.ClassName[method1,method2,...];AnonymousClass$1[call];package.ClassName[]
List of class/interface and methods to trace. Similar to adding @Trace, but without changing code. *Note:** The wildcard method support ([*]) does not accommodate constructors, getters, setters, synthetic, toString, equals, hashcode, or finalizer method calls
如对com.zy.observable.ddtrace.service.TestService 类的getDemo方法需要添加 Trace。
-Ddd.trace.methods="com.zy.observable.ddtrace.service.TestService[getDemo]"
部分代码所示：
@Autowired
private TestService testService;
@GetMapping("/gateway")
@ResponseBody
public String gateway(String tag) {
String userId = "user-" + System.currentTimeMillis();
MDC.put(ConstantsUtils.MDC_USER_ID, userId);
logger.info("this is tag");
sleep();
testService.getDemo();
httpTemplate.getForEntity(apiUrl + "/resource", String.class).getBody();
httpTemplate.getForEntity(apiUrl + "/auth", String.class).getBody();
if (client) {
httpTemplate.getForEntity("http://"+extraHost+":8081/client", String.class).getBody();
}
return httpTemplate.getForEntity(apiUrl + "/billing?tag=" + tag, String.class).getBody();
}
未添加dd.trace.methods参数，上报 11 个 span ，效果如下：
