全部產品
Search
文件中心

Application Real-Time Monitoring Service:快速入門

更新時間:Sep 13, 2024

使用Managed Service for OpenTelemetry前,您需要完成阿里雲帳號註冊、開通Managed Service for OpenTelemetry以及擷取存取點資訊。本文以使用OpenTelemetry Java Agent自動埋點上報Java應用資料為例,協助您快速上手Managed Service for OpenTelemetry

前提條件

  • 註冊阿里雲帳號

  • 開通Managed Service for OpenTelemetry

  • 擷取存取點資訊

    1. 登入ARMS控制台,在左側導覽列單擊接入中心

    2. 服務端應用地區單擊OpenTelemetry卡片。

    3. 在彈出的OpenTelemetry面板中選擇資料需要上報的地區。

      說明

      初次接入的地區將會自動進行資源初始化。

    4. 選擇串連方式上報方式,然後複製存取點資訊。

      • 串連方式:若您的服務部署在阿里雲上,且所屬地區與選擇的接入地區一致,推薦使用阿里雲內網方式,否則選擇公網方式。

      • 上報方式:根據用戶端支援的協議類型選擇HTTP或gRPC協議上報資料。

      3-新版-中文-otgrpc.jpg

方案概覽

6-新版-調用鏈詳情-中文.jpg

本文以OpenTelemetry Java Agent自動埋點上報Java應用資料為例進行說明,主要分為以下幾步:

  1. 下載Demo應用代碼:您可以選擇下載Demo應用代碼體驗Managed Service for 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

說明

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

    要接入Managed Service for 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應用資料,將資料上報至Managed Service for OpenTelemetry

  2. 登入ARMS控制台後,在應用監控 > 應用列表頁面選擇目標應用,查看鏈路資料。

    說明

    語言列顯示image表徵圖的應用為接入應用監控的應用,顯示-表徵圖的應用為接入可觀測鏈路 OpenTelemetry 版的應用。

    9.jpg

後續步驟

將應用資料上報至Managed Service for OpenTelemetry後,您可以在ARMS控制台執行以下操作:

Managed Service for OpenTelemetry支援將Java、Go、Python、JS、.NET、C++等語言的應用資料上報至控制台。支援的上報資料用戶端包括OpenTelemetry、Jaeger、Zipkin和SkyWalking。