步驟一：下載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

   以杭州地域為例，通過Shell腳本方式下載MSE Java探針。

   說明

   各地域的MSE Java探針內容不同，請不要混用。

   • 公網腳本地址：

     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中的所有文件解壓到任意目錄中。

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

   說明

   請根據具體環境替換{user.workspace}為正確的路徑。

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

   -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar
   -Dmse.licenseKey=<yourLicenseKey>    # <yourLicenseKey>系統為您自動生成的LicenseKey，可在MSE治理中心控制臺查看，請勿泄露。
   -Dmse.appName=<yourAppName>          # <yourAppName>自定義應用名稱。
   -Dprofiler.micro.service.mse.version=pro
   -Dmse.namespace=default
   -Dmse.enable=true

   例如：

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

   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、mse.enable參數，不需要單獨添加javaagent參數。

   參數	說明
   mse.licenseKey	系統自動生成的接入憑證，請不要泄露給第三方。 不同地域對應的mse.licenseKey不同，不可混用。
   mse.appName	應用名稱。請將<yourAppName>替換成您自定義的應用名稱。
   profiler.micro.service.mse.version	使用的MSE微服務治理版本。 基礎版為base 專業版為pro 企業版為ent
   mse.namespace	您接入的MSE微服務治理命名空間名稱。

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

1. 登錄MSE治理中心控制臺，并在頂部菜單欄選擇地域。

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