您可以将部署在ECS以及非阿里云虚拟机等部署环境的应用接入MSE治理中心,使用MSE提供的一系列服务治理能力,大幅提升线上微服务的稳定性和开发效率。本文介绍如何将ECS微服务应用接入MSE治理中心。

前提条件

接入流程

将ECS中的应用接入MSE治理中心包含以下步骤:

步骤一:下载MSE Java Agent

  1. 登录ECS管理控制台
  2. 在左侧导航栏,选择实例与镜像 > 实例
  3. 在顶部菜单栏,选择地域
  4. 实例列表页面,搜索需要连接的实例,单击该实例对应操作列下的远程连接
  5. 在弹出的远程连接与命令对话框中,选择相应的链接方式进行登录,详情请参见 连接方式概述 ECS远程连接操作指南
  6. 下载MSE Java Agent。

    以杭州Region为例,通过Shell脚本方式下载MSE Java Agent。

    • 公网脚本地址:
      wget http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/ms/AliyunJavaAgent.zip -O AliyunJavaAgent.zip
    • VPC脚本地址(公网脚本地址无法下载时使用VPC脚本地址下载):
      wget http://arms-apm-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/ms/AliyunJavaAgent.zip -O AliyunJavaAgent.zip

步骤二:安装MSE Java Agent

重要 安装MSE Java Agent需要确保对应节点,至少预留300 MB内存。

MSE Java Agent下载成功后需要进行解压和安装。

  1. AliyunJavaAgent.zip中的所有文件解压到任意目录中。
    unzip AliyunJavaAgent.zip -d /{user.workspace}/
    说明 “{user.workspace}”是示例路径,请根据具体环境替换为正确的路径。
  2. 在应用启动参数上添加AppName以及LicenseKey参数。
    -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar
    -Dmse.licenseKey=<yourLicenseKey>    # <yourLicenseKey>系统为您自动生成的LicenseKey,请勿泄露。
    -Dmse.appName=<yourAppName>          # <yourAppName>自定义应用名称。
    -Dmse.namespace=default
    -Dmse.enable=true
示例代码如下:
java -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Dmse.licenseKey=xxx -Dmse.appName=xxx -Dmse.enable=true -jar application.jar

MSE和ARMS共用一个agent。即如果您同时接入了ARMS,则只需要添加mse.licenseKeymse.appNamemse.enable参数,不需要单独添加javaagent参数。

参数说明
mse.licenseKey系统自动生成的接入凭证,请不要泄露给第三方。

不同Region对应的mse.licenseKey不同,不可混用。

mse.appName应用名称。请将<yourAppName>替换成您自定义的应用名称。
mse.namespace您接入的MSE微服务治理命名空间名称。

步骤三:验证应用已接入MSE

  1. 登录MSE治理中心控制台,并在顶部菜单栏选择地域。
  2. 在左侧导航栏,选择治理中心 > 应用治理,查看您的应用是否已接入MSE。

后续步骤

完成上述步骤后,您就为部署在ECS以及非阿里云虚拟机等部署环境的应用开启了MSE微服务治理能力。登录MSE治理中心控制台,即可使用MSE微服务治理对您的Spring Cloud和Dubbo应用进行服务治理。