全部产品
Search

搜索本产品

    可观测链路 OpenTelemetry 版：快速入门

    文档中心

    可观测链路 OpenTelemetry 版：快速入门

    更新时间：Aug 16, 2024

    使用可观测链路 OpenTelemetry 版前，您需要完成阿里云账号注册、开通可观测链路 OpenTelemetry 版以及获取接入点信息。本文以使用OpenTelemetry Java Agent自动埋点上报Java应用数据为例，帮助您快速上手可观测链路 OpenTelemetry 版。

    前提条件

    • 注册阿里云账号

    • 开通可观测链路 OpenTelemetry 版

    • 获取接入点信息

      新版控制台

      1. 登录可观测链路 OpenTelemetry 版控制台，在左侧导航栏单击接入中心。

      2. 在开源框架区域单击OpenTelemetry卡片。

      3. 在弹出的OpenTelemetry面板中选择数据需要上报的地域。

        说明

        初次接入的地域将会自动进行资源初始化。

      4. 选择连接方式和上报方式，然后复制接入点信息。

        • 连接方式：若您的服务部署在阿里云上，且所属地域与选择的接入地域一致，推荐使用阿里云内网方式，否则选择公网方式。

        • 上报方式：根据客户端支持的协议类型选择HTTP或gRPC协议上报数据。

        3-新版-中文-otgrpc.jpg

      旧版控制台

      1. 登录可观测链路 OpenTelemetry 版控制台。

      2. 在左侧导航栏单击集群配置，然后在右侧页面单击接入点信息页签。

      3. 在页面顶部选择需要接入的地域，然后在集群信息区域打开显示Token开关。

      4. 在客户端采集工具区域单击OpenTelemetry。

        在相关信息列中，获取接入点信息。4-旧版-中文.jpg

        说明

        如果应用部署于阿里云生产环境，则选择阿里云VPC网络接入点，否则选择公网接入点。

    方案概览

    6-新版-调用链详情-中文.jpg

    本文以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. 查看监控数据：您可以在可观测链路 OpenTelemetry 版控制台查看由OpenTelemetry生成的监控数据。

    一、下载Demo应用代码

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

    下载Demo代码： OpenTelemetry Java Agent Demo。

    说明

    Demo包中包含三个子文件夹，分别是：

    • java-agent-usage：使用OpenTelemetry Java Agent自动埋点，本文以此为例。

    • otel-sdk-usage：使用OpenTelemetry Java SDK手动埋点。

    • agent-sdk-usage：同时使用Java Agent和Java SDK埋点。

    二、使用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. 在可观测链路 OpenTelemetry 版控制台的应用列表页面选择目标应用，查看链路数据。

      9.jpg

    后续步骤

    将应用数据上报至可观测链路 OpenTelemetry 版控制台后，您可以在可观测链路 OpenTelemetry 版控制台执行以下操作：

    可观测链路 OpenTelemetry 版支持将Java、Go、Python、JS、.NET、C++等语言的应用数据上报至控制台。支持的上报数据客户端包括OpenTelemetry、Jaeger、Zipkin和SkyWalking。