ECS微服务应用接入MSE治理中心
您可以将部署在ECS以及非阿里云虚拟机等部署环境的应用接入MSE治理中心,使用MSE提供的一系列服务治理能力,大幅提升线上微服务的稳定性和开发效率。本文介绍如何将ECS微服务应用接入MSE治理中心。
前提条件
已创建ECS实例。具体操作,请参见创建方式导航。
已安装JDK并配置环境变量。具体操作,请参见Java Downloads。
接入流程
将ECS中的应用接入MSE治理中心包含以下步骤:
步骤一:下载MSE Java Agent
登录ECS管理控制台。
在左侧导航栏,选择 。
在顶部菜单栏,选择地域。
在实例列表页面,搜索需要连接的实例,单击该实例对应操作列下的远程连接。
在弹出的远程连接与命令对话框中,选择相应的链接方式进行登录,详情请参见连接方式概述ECS远程连接操作指南。
下载MSE Java Agent。
各Region的MSE Java Agent公网下载地址为:
http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/ms/AliyunJavaAgent.zip
VPC网络下载地址:
http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/ms/AliyunJavaAgent.zip
以杭州Region为例,通过Shell脚本方式下载MSE Java Agent。
说明各Region的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下载成功后需要进行解压和安装。
将
AliyunJavaAgent.zip
中的所有文件解压到任意目录中。unzip AliyunJavaAgent.zip -d /{user.workspace}/
说明“{user.workspace}”是示例路径,请根据具体环境替换为正确的路径。
在应用启动参数上添加appName、licenseKey、profiler.micro.service.mse.version参数。
-javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Dmse.licenseKey=<yourLicenseKey> # <yourLicenseKey>系统为您自动生成的LicenseKey,请勿泄露。 -Dmse.appName=<yourAppName> # <yourAppName>自定义应用名称。 -Dprofiler.micro.service.mse.version=pro -Dmse.namespace=default -Dmse.enable=true
示例代码如下:
java -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Dmse.licenseKey=xxx -Dmse.appName=xxx -Dprofiler.micro.service.mse.version=pro -Dmse.enable=true -jar application.jar
MSE和ARMS共用一个agent。即如果您同时接入了ARMS,则只需要添加mse.licenseKey、mse.appName、mse.enable参数,不需要单独添加javaagent参数。
参数 | 说明 |
mse.licenseKey | 系统自动生成的接入凭证,请不要泄露给第三方。 不同Region对应的mse.licenseKey不同,不可混用。 |
mse.appName | 应用名称。请将 |
profiler.micro.service.mse.version | 使用的MSE微服务治理版本。基础版为base,专业版为pro,企业版为ent。 |
mse.namespace | 您接入的MSE微服务治理命名空间名称。 |
步骤三:验证应用已接入MSE
- 登录MSE治理中心控制台,并在顶部菜单栏选择地域。
在左侧导航栏,选择 ,查看您的应用是否已接入MSE。
后续步骤
完成上述步骤后,您就为部署在ECS以及非阿里云虚拟机等部署环境的应用开启了MSE微服务治理能力。登录MSE治理中心控制台,即可使用MSE微服务治理对您的Spring Cloud或Dubbo应用进行服务治理。