微服务引擎MSE：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

   以杭州地域为例，通过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。