快速入门

方案概览

本文以OpenTelemetry Java Agent自动埋点上报Java应用数据为例进行说明，主要分为以下几步：

1. 下载Demo应用代码：您可以选择下载Demo应用代码体验可观测链路 OpenTelemetry 版，您也可以尝试在自己的业务中完成OpenTelemetry Java Agent自动埋点和查看监控数据。

2. 使用OpenTelemetry Java Agent自动埋点：您需要下载OpenTelemetry Java Agent，OpenTelemetry Java Agent提供了无侵入的接入方式，支持上百种Java框架自动上传Trace数据。您还需要修改Java启动的VM参数以上报链路数据。

3. 查看监控数据：您可以在ARMS控制台查看由OpenTelemetry生成的监控数据。

一、下载Demo应用代码

您可以使用Demo应用代码，也可以使用您自己的Java业务代码。

下载Demo代码： OpenTelemetry Java Agent Demo。

二、使用OpenTelemetry Java Agent自动埋点

本文以使用OpenTelemetry Java Agent自动埋点上报Java应用数据为例进行说明。详细的Java框架列表，请参见Supported Libraries and Versions。

1. 下载OpenTelemetry Java Agent。

   在最新版本的Assets中找到opentelemetry-javaagent.jar包，单击JAR包下载。

2. 通过修改Java启动的VM参数上报链路数据。

   -javaagent:/{user.workspace}/opentelemetry-javaagent.jar    //请将{user.workspace}替换为您文件下载的实际地址。
   -Dotel.resource.attributes=service.name=<appName>     // 请将<appName>替换为要接入可观测链路 OpenTelemetry 版的应用名称。
   -Dotel.exporter.otlp.headers=Authentication=<token>    //前提条件中获取的接入点信息。
   -Dotel.exporter.otlp.endpoint=<endpoint>  //前提条件中获取的接入点信息。

   例如，您原有的应用启动命令是：

   java -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar

   要接入可观测链路 OpenTelemetry 版，需要改为如下启动命令：

   java -Dotel.resource.attributes=service.name=java-agent-usage-0.0.1-SNAPSHOT -Dotel.exporter.otlp.headers=Authentication=ggxw4l****@7323a5caae30263_ggxw4l****@53df7ad2afe**** -Dotel.exporter.otlp.endpoint=http://tracing-analysis-dc-hz.aliyuncs.com:8090 -javaagent:/{user.workspace}/opentelemetry-javaagent.jar -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar

三、查看监控数据

1. 访问Demo应用，访问地址为localhost:8081/user/async。OpenTelemetry Java Agent会采集Demo应用数据，将数据上报至可观测链路 OpenTelemetry 版。

2. 登录ARMS控制台后，在应用监控 > 应用列表页面选择目标应用，查看链路数据。

   说明

   语言列显示图标的应用为接入应用监控的应用，显示-图标的应用为接入可观测链路 OpenTelemetry 版的应用。