文档

ECS微服务应用接入MSE治理中心

更新时间:

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

前提条件

接入流程

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

步骤一:下载MSE Java Agent

  1. 登录ECS管理控制台

  2. 在左侧导航栏,选择实例与镜像 > 实例

  3. 在顶部菜单栏,选择地域

  4. 实例列表页面,搜索需要连接的实例,单击该实例对应操作列下的远程连接

  5. 在弹出的远程连接与命令对话框中,选择相应的链接方式进行登录,详情请参见连接方式概述ECS远程连接操作指南

  6. 下载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下载成功后需要进行解压和安装。

  1. AliyunJavaAgent.zip中的所有文件解压到任意目录中。

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

    “{user.workspace}”是示例路径,请根据具体环境替换为正确的路径。

  2. 在应用启动参数上添加appNamelicenseKeyprofiler.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.licenseKeymse.appNamemse.enable参数,不需要单独添加javaagent参数。

参数

说明

mse.licenseKey

系统自动生成的接入凭证,请不要泄露给第三方。

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

mse.appName

应用名称。请将<yourAppName>替换成您自定义的应用名称。

profiler.micro.service.mse.version

使用的MSE微服务治理版本。基础版为base,专业版为pro,企业版为ent

mse.namespace

您接入的MSE微服务治理命名空间名称。

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

  1. 登录MSE治理中心控制台,并在顶部菜单栏选择地域。

  2. 在左侧导航栏,选择治理中心 > 应用治理,查看您的应用是否已接入MSE。

后续步骤

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

  • 本页导读 (1)
文档反馈