JAVA 应用实现 APM 自动注入（主机篇）

从 DataKit 1.60.0 版本开始，正式支持 Java、Python 应用 APM 自动注入，目前主要支持 DDTrace 。当前最佳实践主要以 Java 为例，介绍在主机环境下如何通过 DataKit 对 Java 应用实现 APM 的自动注入。

DataKit

version >= 1.60.0

安装/升级

升级或者安装 DataKit 需要加上命令 DK_APM_INSTRUMENTATION_ENABLED=host

• 安装

如果还没有在主机上安装 DataKit ，使用下面的命令进行安装，需要先注册观测云账号，修改命令行的 token 值。

DK_APM_INSTRUMENTATION_ENABLED=host DK_DATAWAY="https://openway.guance.com?token=tkn_你的token" bash -c "$(curl -L https://static.guance.com/datakit/install.sh)" 

• 升级

如果已经安装了 DataKit，则只需要升级即可，使用下面的命令进行升级操作

DK_APM_INSTRUMENTATION_ENABLED=host DK_UPGRADE=1 bash -c "$(curl -L https://static.guance.com/datakit/install.sh)"

• 更新

如果已经升级到了 1.60.0 以上版本，但升级或者安装都没有添加命令：DK_APM_INSTRUMENTATION_ENABLED=host ，则需要重新升级。

检验

执行以下命令进行检验。

cat /usr/local/datakit/conf.d/datakit.conf | grep instru

如果 instrumentation_enabled 值是空的，这个时候需要手动调整下 instrumentation_enabled 。

编辑文件 /usr/local/datakit/conf.d/datakit.conf 。

开启 DDTrace 采集器

cp ddtrace/ddtrace.conf.sample ddtrace/ddtrace.conf

然后重启 DataKit 。

datakit service -R

Java 应用

启动 java 应用

java -jar  springboot-server.jar 

通过 ps 查看启动命令。

前面使用了 java -jar springboot-server.jar 启动了应用，命令被重写为 java -jar - javaagent:/usr/local/datakit/apm_inject/lib/java/dd-java-agent.jar -Ddd.agent.host=0.0.0.0 -Ddd.trace.agent.port=9529 springboot-server.jar 。

查看效果

访问应用产生链路信息，可以在平台上进行查看。

查看链路详情。