通过 Opentelemetry Java Instrumentation 为 Java 应用添加自定义埋点

步骤1：下载并编译自定义埋点代码

1. 执行以下命令下载自定义埋点demo项目。

   该项目简单地实现了motan框架的客户端和服务端埋点，通过在客户端发起RPC调用和服务端接收RPC调用时分别生成一个Span，且在利用motan框架的协议头传递trace上下文。

   git clone git@github.com:aliyun-observability/aliyun-javaagent-extension-demo.git

2. 进入项目根目录，执行./gradlew build命令。

   说明

   当前编译环境的JDK版本需为JDK17。

   执行该命令后，在.build/libs目录下会有编译后的JAR文件，即为自定义拓展JAR包。

   

步骤2：下载ARMS探针

步骤3：下载并编译motan demo应用

1. 下载motan应用。

   git clone https://github.com/weibocom/motan.git

2. 进入项目根目录，执行 cd motan-demo && mvn clean package命令。

   执行后，在${motan-root}/motan-demo/motan-demo-client/target和${motan-root}/motan-demo/motan-demo-server/target目录下即可看到motan-demo-server和motan-demo-client示例应用。

步骤4：启动应用时加载自定义拓展包

1. 启动server应用：java -javaagent:/path/to/aliyun-java-agent.jar -Darms.appName=motan-client -Darms.licenseKey=${your licenseKey} -Dotel.javaagent.extensions=/path/to/opentelemetry-extension-demo-1.0.jar -jar /path/to/motan-demo-server.jar

2. 启动client应用：java -javaagent:/path/to/aliyun-java-agent.jar -Darms.appName=motan-server -Darms.licenseKey=${your licenseKey} -Dotel.javaagent.extensions=/path/to/opentelemetry-extension-demo-1.0.jar -jar /path/to/motan-demo-client.jar

根据实际情况修改以下参数：

• /path/to/aliyun-java-agent.jar：步骤2下载的探针。

• ${your licenseKey}：可以通过DescribeTraceLicenseKey OpenAPI获取LicenseKey。

• /path/to/opentelemetry-extension-demo-1.0.jar：步骤1获取的自定义拓展JAR包。

• /path/to/motan-demo-server.jar：步骤3下载的motan-demo-server示例应用。

• /path/to/motan-demo-client.jar：步骤3下载的motan-demo-client示例应用。

步骤5：查看监控效果

1. 多次执行curl http://localhost:8080/ ，将数据上报至ARMS。

2. 在ARMS控制台查看Trace详情，可以看见已生成的motan client的span和motan server的span。