本文以Java应用为例,介绍从开通可观测链路 OpenTelemetry 版服务及相关依赖服务并授权,到将应用接入可观测链路 OpenTelemetry 版的流程,帮助您快速上手可观测链路 OpenTelemetry 版

前提条件

授权可观测链路 OpenTelemetry 版读写您的日志服务数据

  1. 登录ARMS控制台,在左侧导航栏选择应用监控 > 应用列表
  2. 应用列表页面顶部选择目标地域,然后单击目标应用名称。
    说明语言列显示Java图标图标的为接入应用监控的应用,显示-则为接入可观测链路 OpenTelemetry 版的应用。
  3. 在弹出的页面中,单击左侧导航栏上方的返回图标图标,返回上一层。
  4. 在左侧导航栏,单击概览
  5. 提示页面上,单击授权,授权可观测链路 OpenTelemetry 版读写您的日志服务。
  6. 提示对话框,单击确认

使用OpenTelemetry Java Agent自动埋点

本文以OpenTelemetry Java Agent上报Java应用数据为例,介绍如何上报数据。OpenTelemetry Java Agent提供了无侵入的接入方式,支持上百种Java框架自动上传Trace数据,详细的Java框架列表,请参见Supported Libraries and Versions。通过OpenTelemetry SDK手动埋点或其他客户端上报数据、以及上报其他语言应用数据的方法,请参见文末的相关文档。

  1. 下载Demo代码: OpenTelemetry Java Agent Demo
  2. 下载OpenTelemetry Java Agent
    在最新版本的Assets中找到opentelemetry-javaagent.jar包,单击JAR包下载。
  3. 可观测链路 OpenTelemetry 版控制台获取接入点信息。
    1. 登录ARMS控制台,在左侧导航栏选择应用监控 > 应用列表
    2. 应用列表页面顶部选择目标地域,然后单击目标应用名称。
      说明 语言列显示Java图标图标的应用为接入应用监控的应用,显示-图标的应用为接入可观测链路 OpenTelemetry 版的应用。
    3. 在弹出的页面中,单击左侧导航栏上方的返回图标图标,返回上一层。
    4. 在左侧导航栏单击集群配置,然后在右侧页面单击接入点信息页签。
    5. 在页面顶部选择需要接入的地域,然后在集群信息区域打开显示Token开关。
    6. 客户端采集工具区域单击OpenTelemetry
      在下方表格的相关信息列中,获取接入点信息。OT接入点信息
      说明 如果应用部署于阿里云生产环境,则选择阿里云VPC网络接入点,否则选择公网接入点。
  4. 通过修改Java启动的VM参数上报链路数据。
    -javaagent:/path/to/opentelemetry-javaagent.jar    //请将路径修改为您文件下载的实际地址。
    -Dotel.resource.attributes=service.name=<appName>     // 请将<appName>修改为您的应用名。
    -Dotel.exporter.otlp.headers=Authentication=<token>
    -Dotel.exporter.otlp.endpoint=<endpoint>
    例如:
    -javaagent:/Users/carpela/Downloads/opentelemetry-javaagent.jar
    -Dotel.resource.attributes=service.name=ot-java-agent-sample
    -Dotel.exporter.otlp.headers=Authentication=b590xxxxuqs@3a75d95xxxxx9b_b59xxxxguqs@53dxxxx2afe8301
    -Dotel.exporter.otlp.endpoint=http://tracing-analysis-dc-bj:8090

查看监控数据

登录ARMS控制台后,在应用监控 > 应用列表页面选择目标应用,查看链路数据。
说明 语言列显示Java图标图标的应用为接入应用监控的应用,显示-图标的应用为接入可观测链路 OpenTelemetry 版的应用。

后续步骤

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

可观测链路 OpenTelemetry 版支持将Java、Go、Python、JS、.NET、C++等语言的应用数据上报至控制台。支持的上报数据客户端包括OpenTelemetry、Jaeger、Zipkin和SkyWalking。请在下方根据您的应用语言或者使用的客户端查看相应的应用接入文档。

按应用语言

按客户端