Microservices Engine：ECS微服務應用接入MSE治理中心

步驟一：下載MSE Java探針

1. 登入ECS管理主控台。

2. 在左側導覽列，選擇執行個體與鏡像 > 執行個體。

3. 在頂部功能表列，選擇地區。

4. 在建立執行個體頁面，搜尋需要串連的執行個體，單擊該執行個體對應操作列下的遠端連線。

5. 在彈出的遠端連線對話方塊中，選擇相應的連結方式進行登入。具體操作，請參見串連方式概述ECS遠端連線操作指南。

6. 下載MSE Java探針。

   公網下載地址為：

   http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/AliyunJavaAgent.zip

   VPC網路下載地址：

   http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/AliyunJavaAgent.zip

   以ECS的杭州地區為例，通過Linux命令方式下載MSE Java探針，可接入杭州地區的MSE治理中心。其他地區的MSE Java探針下載，需替換下載地址中的${regionId}，對應的regionId請參見開服地區。

   重要

   各地區的MSE Java探針內容不同，可接入的MSE治理中心地區也不同，請不要混用。

   • 公網指令碼地址：

     wget http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/AliyunJavaAgent.zip \
       -O AliyunJavaAgent.zip

   • VPC指令碼地址（公網指令碼地址無法下載時使用VPC指令碼地址下載）：

     wget http://arms-apm-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/AliyunJavaAgent.zip \
       -O AliyunJavaAgent.zip

步驟二：安裝MSE Java探針

MSE Java探針下載成功後需要進行解壓和安裝。

1. 將AliyunJavaAgent.zip中的所有檔案解壓到任意目錄中。

   說明

   請根據具體系統內容替換{user.workspace}為正確的解壓路徑。

   unzip AliyunJavaAgent.zip -d /{user.workspace}/ 

2. 在原有的應用啟動命令上添加javaagent、mse.licenseKey、mse.appName、profiler.micro.service.mse.version、mse.namespace、mse.enable參數。

   -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar
   -Dmse.licenseKey=<yourLicenseKey>            # <yourLicenseKey>MSE為您自動產生的LicenseKey，可在MSE治理中心控制台的概覽頁面查看，請勿泄露。
   -Dmse.appName=<yourAppName>                  # <yourAppName>接入的應用程式名稱。
   -Dprofiler.micro.service.mse.version=pro     # 接入的MSE微服務治理版本，基礎版為base，專業版為pro，企業版為ent。
   -Dmse.namespace=default                      # 接入的MSE微服務治理命名空間名稱，可在MSE治理中心控制台查看。
   -Dmse.enable=true                            # 是否接入MSE微服務治理。

   例如：

   您原有的應用啟動命令是：

   java -jar application.jar

   要接入MSE微服務治理，需要改為如下啟動命令：

   java -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Dmse.licenseKey=xxx -Dmse.appName=xxx -Dprofiler.micro.service.mse.version=pro -Dmse.namespace=default -Dmse.enable=true -jar application.jar

   另外，MSE和ARMS共用一個探針。即如果您同時接入了ARMS，則只需要添加參數mse.licenseKey、mse.appName、profiler.micro.service.mse.version、mse.namespace、mse.enable參數，不需要單獨添加javaagent。如果使用4.3.x版本、4.4.x版本的探針還需要指定aliyun.javaagent.regionId。

   參數	說明
   mse.licenseKey	MSE自動產生的接入憑證，可在MSE治理中心控制台的概覽頁面查看，請不要泄露給第三方。MSE治理中心不同地區對應的mse.licenseKey不同，不可混用。
   mse.appName	接入應用程式名稱。請將<yourAppName>替換成您自訂的應用程式名稱。
   profiler.micro.service.mse.version	使用的MSE微服務治理版本。 基礎版為base 專業版為pro 企業版為ent
   mse.namespace	接入的MSE微服務治理命名空間名稱。
   mse.enable	是否接入MSE微服務治理。
   aliyun.javaagent.regionId	接入微服務治理的地區。 重要 使用4.3.x版本、4.4.x版本的探針需要指定該參數。

   說明

   如果需要在同一台ECS中部署多個應用進程，建議增加啟動參數io.opentelemetry.javaagent.mse.shaded.csp.sentinel.log.use.pid=true（Agent 版本 4.3.x 以下參數為csp.sentinel.log.use.pid=true），以區分不同進程的流量防護相關日誌。

步驟三：驗證應用已接入MSE

1. 登入MSE治理中心控制台，並在頂部功能表列選擇地區。

2. 在左側導覽列，選擇治理中心 > 應用治理，查看您的應用是否已接入MSE。