使用可觀測鏈路 OpenTelemetry 版前,您需要完成阿里云賬號注冊、開通可觀測鏈路 OpenTelemetry 版以及獲取接入點信息。本文以使用OpenTelemetry Java Agent自動埋點上報Java應用數據為例,幫助您快速上手可觀測鏈路 OpenTelemetry 版。
前提條件
新版控制臺
登錄可觀測鏈路 OpenTelemetry 版控制臺,在左側導航欄單擊接入中心。
在開源框架區域單擊OpenTelemetry卡片。
在彈出的OpenTelemetry面板中選擇數據需要上報的地域。
說明初次接入的地域將會自動進行資源初始化。
選擇連接方式和上報方式,然后復制接入點信息。
連接方式:若您的服務部署在阿里云上,且所屬地域與選擇的接入地域一致,推薦使用阿里云內網方式,否則選擇公網方式。
上報方式:根據客戶端支持的協議類型選擇HTTP或gRPC協議上報數據。
舊版控制臺
在左側導航欄單擊集群配置,然后在右側頁面單擊接入點信息頁簽。
在頁面頂部選擇需要接入的地域,然后在集群信息區域打開顯示Token開關。
在客戶端采集工具區域單擊OpenTelemetry。
在相關信息列中,獲取接入點信息。
說明如果應用部署于阿里云生產環境,則選擇阿里云VPC網絡接入點,否則選擇公網接入點。
方案概覽
本文以OpenTelemetry Java Agent自動埋點上報Java應用數據為例進行說明,主要分為以下幾步:
下載Demo應用代碼:您可以選擇下載Demo應用代碼體驗可觀測鏈路 OpenTelemetry 版,您也可以嘗試在自己的業務中完成OpenTelemetry Java Agent自動埋點和查看監控數據。
使用OpenTelemetry Java Agent自動埋點:您需要下載OpenTelemetry Java Agent,OpenTelemetry Java Agent提供了無侵入的接入方式,支持上百種Java框架自動上傳Trace數據。您還需要修改Java啟動的VM參數以上報鏈路數據。
查看監控數據:您可以在可觀測鏈路 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。
在最新版本的Assets中找到opentelemetry-javaagent.jar包,單擊JAR包下載。
通過修改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
三、查看監控數據
訪問Demo應用,訪問地址為
localhost:8081/user/async
。OpenTelemetry Java Agent會采集Demo應用數據,將數據上報至可觀測鏈路 OpenTelemetry 版。在可觀測鏈路 OpenTelemetry 版控制臺的應用列表頁面選擇目標應用,查看鏈路數據。
后續步驟
將應用數據上報至可觀測鏈路 OpenTelemetry 版控制臺后,您可以在可觀測鏈路 OpenTelemetry 版控制臺執行以下操作:
可觀測鏈路 OpenTelemetry 版支持將Java、Go、Python、JS、.NET、C++等語言的應用數據上報至控制臺。支持的上報數據客戶端包括OpenTelemetry、Jaeger、Zipkin和SkyWalking。
語言 | 文檔 |
Java語言 | |
PHP應用 | |
Go應用 | |
Python應用 | |
Node.js應用 | |
.NET應用 | |
C++應用 | |
Ruby應用 | |
Swift應用 | |
Android應用 | |
Rust應用 |