文档

快速入门

更新时间:

使用可观测链路 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。