头图

从 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

图片

然后重启 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

查看效果

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

图片

查看链路详情。

图片


观测云
21 声望85 粉丝

云时代的系统可观测平台