本章节介绍数据库治理中的数据库灰度 概述 数据库灰度在应用层提供灰度环境数据隔离能力。其原理是将数据层的流量路由到数据库影子表中，从而与原有数据进行隔离。结合全链路灰度，可以实现网关到后端服务再到数据库的全链路环境隔离，方便进行灰度环境的服务验证。 使用限制 JDBC驱动支持的版本如下： 框架 限制 详情 Druid Spring Cloud Dalston及以上版本 HikariCP 2.3.13或以上版本 jdk版本 1.8+ 功能入口 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择应用治理。 3. 在应用治理页面的应用卡片页签单击目标应用卡片。 4. 在左侧导航栏选择数据库治理，在数据库灰度页签下可以进行数据库灰度的配置。 步骤一 开启前检查灰度影子表，需要您先开启全链路灰度，针对需要灰度的数据库表进行对应灰度表的创建（灰度表创建规则为默认环境的表名后面加上“标签名”，例如gray环境，默认环境表名为msetable，那么灰度表名为msetablegray）。 如果您只需要针对某些表进行灰度操作，那么您需要配置“需要灰度的数据库表”列表，填入您需要进行灰度访问的数据库表名集合，同时确保您需要灰度的表都有提前创建灰度表。 步骤二 开启数据库灰度。 步骤三 开始验证灰度版本，灰度环境的SQL流量会自动操作对应环境的灰度表。

本章节介绍网关治理功能的节点详情 概述 在节点详情页面，可以查看所有节点的通过QPS、限流QPS、异常QPS、RT、并发等指标，并且可以在此页面对接口管理流控规则进行操作。一个节点对应一个JVM进程，当多个JVM接入单机后，即展示为多个节点。 功能入口 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择网关治理。 3. 在网关治理页面的应用卡片页签单击目标网关卡片。 4. 在左侧导航栏中选择节点详情。 功能介绍 节点页面展示了应用的所有节点详细信息以及这些节点当前的通过QPS、限流QPS、异常QPS和RT等数据。同时，该页面还展示5分钟内的流量监控指标，节点所在机器的CPU信息、LOAD信息、物理内存、DISK和网络流量。 此外，该页面还提供了所在节点的5min内的JVM信息，包括堆内存详情，非堆内存详情，元空间详情，JVM线程数，缓冲区详情和GC等数据。

框架 限制 详情 Spring Cloud Spring Cloud Dalston及以上版本 客户端：Feign、RestTemplate Dubbo 2.5.3+ 无 jdk版本 1.8+ 无

参数 说明 DatabaseName 数据库的名称。 MaxConnectionSize 最大连接数。 QueryTimeout SQL请求的超时时长。 TransactionQueryTimeout SQL事务的超时时长。 WaitThreadCount 当前等待获取连接的线程数。 ActivePeak 活跃连接峰值。 ActivePeakTime 活跃连接数量处于峰值的时间。 ActiveConnectionSize 活跃的连接数。 ErrorCount SQL请求的错误数。 ExecuteCount SQL请求的执行数。 CommitCount SQL请求的提交数。 RollBackCount SQL请求的回滚数。 PoolingCount 连接池中数据库连接的数量。 PoolingPeak 连接池中数据库连接数量的峰值。 PoolingPeakTime 连接池数量处于峰值的时间。

本章节介绍数据库治理的基本详情 概述 数据库治理针对开发运维人员访问、使用数据库时的常见场景，提供SQL访问审计、数据库稳定性治理、数据流量治理三个方面的能力。MSE提供了SQL监控统计、SQL流量防护、连接池治理、数据库灰度、数据库读写路由等功能，可以从数据库服务维度进行开发提效和性能优化。 基本详情 基本详情页提供应用SQL访问流量和应用资源的实时统计数据。根据数据库相关的应用实时指标，可以及时发现由数据库访问引起的应用性能下降问题，并定位高并发或高RT的SQL以及异常的数据库连接，从而支撑后续SQL语句优化、SQL接口流量防护和连接池配置等系统调优操作。 功能入口 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择应用治理。 3. 在应用治理页面的应用卡片页签单击目标应用卡片。 4. 在左侧导航栏选择数据库治理，在基本详情页签下可以查看应用的SQL流量概览、应用事件、Top SQL洞察和Druid连接池统计数据。 SQL流量概览 可以查看应用在一定时间内SQL流量的通过QPS、限流QPS、异常QPS指标、RT、并发数据。 应用事件 可以查看SQL请求触发的应用防护事件。 Top SQL洞察 可以查看相对高RT的SQL语句及其QPS、RT和并发数据，快速定位SQL对应用业务的具体影响。并且可以通过单击操作下方的SQL防护，管理和配置SQL接口的流量控制和并发隔离规则。

参数 说明 接口类型 需要进行读写流量路由接口的类型。 接口名称 需要进行读写流量路由接口的名称。 是否需要强一致性保证 开启强一致性保证，MSE会异步校验数据库主从实例的同步状态，保证当前接口的读请求在主从状态一致的条件下，才会路由至只读实例。 是否开启 接口级别的读写分离开关，当存在读写流量路由规则时，只有开启状态下的规则内所涉及的接口会被路由。

本章节介绍网关治理中的流量防护功能 请求分组管理 可以创建请求分组，并自定义每个请求分组下的URL路径匹配规则，以增强网关防护功能。通过这种方式，您可以对特定的请求分组进行流量控制，以确保网络安全。网关防护可以针对自定义的请求分组进行流量控制。 新建自定义请求 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择网关治理。 3. 在网关治理页面的应用卡片页签单击目标网关卡片。 4. 在左侧导航栏选择网关防护 请求分组管理，单击新增请求分组。 5. 在新建自定义请求分组对话框中，填写请求分组名称（说明该名称需要全局唯一，并且不能与路由配置文件中的路由ID重复）。 6. 填写URL路径匹配规则，先选择匹配模式，再根据匹配模式的要求填写匹配串。匹配模式分为以下三类： 精确模式：严格按照给定的匹配串来匹配URL路径。示例：/path代表严格按照/path这个路径来匹配。 前缀模式：按照给定的匹配串来进行前缀匹配，匹配串需符合Spring Web风格。示例：/path/ 代表匹配以/path/开头的所有URL，像/path/123这种URL都可以匹配。 正则模式：按照给定的正则表达式匹配串来进行匹配。 匹配串：根据匹配模式的要求填写匹配串。 7. 单击+新增匹配规则，可添加多个URL路径匹配规则。 8. 单击新增，完成自定义请求分组的创建。新增的请求分组将出现在请求分组管理页面。

本章节介绍不同账号之间迁移实例的方法 目前暂不支持在不同账号之间迁移实例，若您需要将实例进行迁移，请遵循如下步骤进行手动迁移： Nacos 1. 开通新账号，新建Nacos实例； 2. 迁移Nacos配置。使用Nacos配置导入导出能力，将旧实例的完整配置下载为本地文件，再导入到新实例； 3. 迁移Nacos服务。提供了Nacos Sync迁移工具，可提供服务自动平滑迁移能力，但目前仅支持相同vpc下实例的自动迁移，您需要将服务手动注册到新实例上，以完成服务迁移； 4. 迁移命名空间、访问权限等信息。目前没有针对该类元数据信息的迁移方案，需要用户在新实例进行手动创建。 Zookeeper 1. 开通新账号，新建Zookeeper实例； 2. 迁移Zookeeper持久化数据。迁移Zookeeper的Znode数据，方法详见Zookeeper持久化数据的迁移的迁移章节； 3. 迁移Zookeeper服务。由于Zookeeper服务数据默认为非持久化数据，对服务数据的迁移目前没有对应的平滑迁移方案，您需要将服务手动注册到新实例上，以完成服务迁移。 Eureka 1. 开通新账号，新建Eureka实例； 2. 迁移Eureka服务。对服务数据的迁移目前没有对应的平滑迁移方案，您需要将服务手动注册到新实例上，以完成服务迁移。

解决方案 将您服务消费者客户端配置中的数据获取间隔（eureka.client.registryfetchintervalseconds）时间改小，如改为5秒，如下图所示。但过小的时间间隔会增大客户端的工作负担。

本章节介绍什么是应用网关治理 可以对网关进行流量控制，支持流量治理和网关防护，网关防护可以从流量入口处拦截突发的流量，防止下游服务被压垮。网关防护的主要功能包括： 1. 对路由配置中的特定路由进行流量控制，或者自定义一组API进行流量控制。 2. 对请求的客户端IP、Header或者URL参数进行流控。 3. 限制某个API的调用频率，支持秒、分钟、小时、天等多个时间维度。

本章节介绍Zookeeper持久化数据迁移方案 数据迁移功能是利用ZooKeeper的快照（Snapshot）进行持久化数据的迁移。 前提条件 已创建MSE ZooKeeper集群。具体操作，请参考创建ZooKeeper引擎。 使用限制 1. 迁移前确保源ZooKeeper停止同步服务，并且有生成最新的快照文件。 2. 该方式不支持同步分布式锁、临时节点数据。 迁移步骤 步骤一：导出源ZooKeeper快照 1. 在源ZooKeeper部署机器上，查看zoo.cfg配置文件，获取dataDir配置目录。 2. 进入dataDir目录后，进入version2/目录找到最新的快照文件进行下载保存。 3. 在MSE ZooKeeper实例详情页面中，进入数据管理>Znode管理>点击数据导入。 4. 点击上传文件，选中刚刚下载保存的快照文件，点击确定，等待集群重启完毕即可，预计需要等待25分钟。 5. 验证数据迁移结果，可以在Znode管理中查看相应的节点数据验证。

本章节介绍数据库治理中的SQL详情 概述 SQL详情页提供SQL接口维度的监控能力以及防护配置能力。通过SQL流量监控能力，可以及时定位异常SQL，并针对异常的SQL采用流量防护提供的接口流控和并发隔离能力，避免异常SQL挤占应用的资源。 使用限制 JDBC驱动支持的版本如下： 组件 支持驱动版本 MySQL JDBC 5.x/8.x 功能入口 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择应用治理。 3. 在应用治理页面的应用卡片页签单击目标应用卡片。 4. 在左侧导航栏选择数据库治理，在SQL详情页签下可以查看应用的不同SQL的QPS、RT和并发等详细数据。 5. 单击节点详情可以查看分节点流量。 6. 在接口概览页签，单击新增防护规则，在新增规则对话框内选择接口流控或并发隔离页签进行防护规则配置。 接口流控：流控规则会控制流量在阈值之内，拒绝阈值外的请求，可以避免异常SQL请求占用过多服务资源，保证高优先级的请求正常处理。详情请参考流量防护配置流控规则。 并发隔离：隔离规则会控制流量保持在稳态，在请求堆积的情况下保证已有请求的可用资源。详情请参考流量防护配置隔离规则。

配置服务 查询配置 async function getConfig(dataId, group) {String} dataId data id {String} group group name 发布配置 async function publishSingle(dataId, group, content) {String} dataId data id {String} group group name {String} content content you want to publish 删除配置 async function remove(dataId, group) {String} dataId data id {String} group group name 监听配置 function subscribe(info, listener) {Object} info {String} dataId data id {String} group group name {Function} listener callback handler 监听回调函数 取消配置监听 function unSubscribe(info, [listener]) {Object} info {String} dataId data id {String} group group {Function} listener callback handler（optional，remove all listener when it is null） 监听取消回调函数

参数 说明 泳道名称 泳道的名称。 添加应用 选择应用所属的标签。

框架 限制 详情 Spring Cloud Spring Cloud Dalston及以上版本 支持负载均衡组件为ribbon的应用 不支持负载均衡组件为Spring Cloud LoadBalancer的应用。 Dubbo 2.5.3+ Jdk版本 1.8+

使用场景 常用场景 1 ：当资源争抢时，需留足资源给优先级高的接口 为了确保提交的数据不丢失，我们将数据库读写分离，并给写库分配了更高的优先级。对于读取数据的请求，如果过于频繁，会对写入操作进行限流。 在新建流控防护规则对话框中配置以下规则信息： 1. 统计维度选择关联接口。 2. 流控效果选择快速失败。 3. 关联接口阈值为10。 当写库操作的QPS超过10之后，读库操作会被限流以保证留足资源给写库操作，避免写库操作数据丢失。 常用场景 2 ：预热启动避免大流量冲击 采用流量控制的方法，在流量入口处进行控制，以缓慢增加的方式让流量通过，在一定时间内达到阈值上限，以便系统能够预热。这种方法最适合应对突发流量的场景。 在新建流控防护规则对话框中配置以下规则信息： 1. 统计维度选择链路入口。 2. 流控效果选择预热启动。 3. 单机QPS阈值为90。 4. 预热时间为10s。 预热流控方式下，默认会从设置的QPS阈值的1/3开始慢慢往上增加至QPS设置值。本示例中，当入口的QPS超过30（即90÷3）时，会在预热的10s内缓慢增长至90。 常用场景 3 ：削峰填谷，使流量匀速通过 请求流量具有波峰波谷的特点，流量管理的原理是将前期的高峰流量延迟到后期再处理，以最大化满足所有请求，并保证用户体验。 在新建流控防护规则对话框中配置以下规则信息： 1. 统计维度选择当前接口。 2. 流控效果选择排队等待。 3. 配置匀速模式下请求单机QPS阈值为5。 4. 等待时长为5s。

在接口详情页面,主要展示该应用的通过QPS、限流QPS、异常QPS指标、RT、并发数据等 接口详情 在接口详情页面，主要展示该应用所有接口的通过QPS、限流QPS、异常QPS指标、RT、并发数据等。 功能入口 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择网关治理。 3. 在网关治理页面的应用卡片页签单击目标网关卡片。 4. 在左侧导航栏选择接口详情。

本章节介绍如何配置隔离规则 配置隔离规则 隔离规则，通过控制接口或调整依赖的并发线程数，以保证系统的稳定性。这种方法适用于应用程序内部或下游依赖出现不稳定的情况，例如慢SQL或下游应用响应时间变慢等。 功能入口 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择应用治理。 3. 在应用治理页面的应用卡片页签单击目标应用卡片。 4. 进入应用之后，新建隔离规则：在左侧导航栏，单击流量防护，在流量防护 规则管理 隔离规则页，单击新增流控规则按钮。 5. 在新建隔离规则对话框中配置规则信息： 1. 在选择防护场景页面，修改接口名称，然后单击下一步。 2. 在配置防护规则页面，配置防护规则，然后单击下一步（说明若需对隔离防护规则进行编辑，则直接进入配置防护规则）。 3. 在配置防护行为页面，然后单击下一步并单击新增。 4. 在隔离规则页面，选择对应的规则并在状态栏下单击开启。 5. 在温馨提示页面，单击确定，开启已配置的防护规则。 使用场景 常用场景 1：保障自身资源充足 当运行该请求的响应时间变长，会导致线程的并发数变大。当并发数超过阈值以后，微服务治理将拒绝多余的请求，直到堆积的任务完成，并发线程数变少。达到将异常隔离，减小不稳定性的效果。例如某个SQL执行时间为20毫秒，预期该请求每秒有50个。 在新增隔离防护规则对话框中配置以下规则信息： 1. 填写接口名称和来源应用。 2. 统计维度选择当前接口。 3. 并发数阈值为50。

本章节介绍如何配置WEB行为 配置WEB行为 在Web行为分析中，可以对Web类型的埋点资源进行监控，以便在满足某种规则时触发自定义处理行为。例如，如果某个Web接口触发了流控规则，则可以返回"Blocked by Sentinel"的提示文本。 新增行为 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择应用治理。 3. 在应用治理页面的应用卡片页签单击目标应用卡片。 4. 进入应用之后，在左侧导航栏，单击流量防护，在流量防护 防护配置 行为管理，单击新增行为，在新增行为对话框中完成以下配置，然后单击新建。 修改或删除行为 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择应用治理。 3. 在应用治理页面的应用卡片页签单击目标应用卡片。 4. 进入应用之后，在左侧导航栏，单击流量防护，在流量防护 防护配置 行为管理。 5. 行为列表页，您可以查看各个行为的具体描述，修改或删除行为。 关联行为 1. 登录微服务治理控制台。 2. 在控制台左侧导航栏中选择应用治理。 3. 在应用治理页面的应用卡片页签单击目标应用卡片。 4. 在左侧导航栏选择规则管理，在流控规则页签单击新增流控规则，然后在弹出的对话框中配置规则信息。 5. 完成选择防护场景和配置防护规则后，在配置限流行为区域，完成下列设置： 选择接口类型为Web；在关联行为的下拉列表中选择目标行为进行关联，或单击新增行为来创建新的行为进行关联。

本节主要介绍如何在智能视图服务控制台查看、检索及删除设备告警。 说明 设备告警需设备端支持。 在设备告警模块，可以通过切换业务组查看到已绑定告警模板的设备及其告警情况，支持用户删除目标告警信息，绑定告警模板流程可参考【模板管理告警模板】。 用户可在该页面通过告警时间筛选显示设备告警，也可通过输入设备名称进行搜索。

参数 参数类型 说明 示例 下级对象 statusCode String 返回状态码（2000成功，5000系统错误,18xxxx业务错误） 2000 error String 业务错误码，RCCstatusCode RCC1000 message String 返回结果描述 SUCCESS returnObj Object 返回数据体 returnObj

参数 参数类型 说明 示例 下级对象 statusCode String 返回状态码（2000成功，5000系统错误,18xxxx业务错误） 2000 error String 业务错误码，RCCstatusCode RCC1000 message String 返回结果描述 SUCCESS returnObj Object 返回数据体 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 name 是 String 设备标签键 uuid value 否 Array of Strings 设备标签键所对应的值 ['9dc489794e1945e2b5235d3c70d516b3']

参数 参数类型 说明 示例 下级对象 statusCode Integer 返回状态码（800为成功，900为失败），默认值：800 800 errorCode String 失败时的错误代码，参见公共错误码说明 message String 失败时的错误描述，一般为英文描述 Success msgDesc String 失败时的错误描述，一般为中文描述 成功 returnObj Object 返回参数，参考returnObj对象结构 returnObj error String 错误码，请求成功时，不返回该字段 Openapi.Parameter.Error

参数 是否必填 参数类型 说明 示例 下级对象 regionID 是 String 资源池ID 81f7728662dd11ec810800155d307d5b taskID 否 String 任务ID TASKtacd8b6b4610b97d202306301808 name 否 String 任务名称，支持模糊搜索 主机数据 pageNo 否 Integer 页码，不传默认为1 1 pageSize 否 Integer 每页大小，不传默认为20 2

响应示例 { "statusCode":800, "returnObj":{ "downloadUrl":" }, "errorCode":"", "message":"Success", "msgDesc":"成功" } 状态码 请参考 状态码 错误码 请参考 错误码

接口功能介绍 参见请求参数说明。 接口约束 资源池ID、任务ID不为空。 URI POST /v4/monitor/taskcenter/deletetask 路径参数 无 Query参数 无 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 regionID 是 String 资源池ID 81f7728662dd11ec810800155d307d5b taskID 是 Array of Strings 任务ID列表 ['TASKtacd8b6b4610b97d202306301808'] 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 返回状态码（800为成功，900为失败），默认值：800 800 errorCode String 失败时的错误代码，参见公共错误码说明 message String 失败时的错误描述，一般为英文描述 Success msgDesc String 失败时的错误描述，一般为中文描述 成功 returnObj Object 返回参数，参考returnObj对象结构 returnObj error String 错误码，请求成功时，不返回该字段 Openapi.Parameter.Error 表 returnObj 参数 参数类型 说明 示例 下级对象 success Boolean 删除成功标识 true 枚举参数 无 请求示例 请求url /v4/monitor/taskcenter/deletetask 请求头header 无 请求体body { "regionID": "81f7728662dd11ec810800155d307d5b", "taskID": [ "TASKtacd8b6b4610b97d202306301808" ] }

参数 参数类型 说明 示例 下级对象 statusCode Integer 返回状态码（800为成功，900为失败），默认值：800 800 errorCode String 失败时的错误代码，参见公共错误码说明 message String 失败时的错误描述，一般为英文描述 Success msgDesc String 失败时的错误描述，一般为中文描述 成功 error String 错误码，请求成功时，不返回该字段 Openapi.Parameter.Error returnObj Object 返回参数，参考returnObj对象结构 returnObj

响应示例 { "statusCode":800, "returnObj":{ "taskID": "TASKtacd8b6b4610b97d202306301808" }, "errorCode":"", "message":"Success", "msgDesc":"成功" } 状态码 请参考 状态码 错误码 请参考 错误码

参数 参数类型 说明 示例 下级对象 statusCode Integer 返回状态码（800为成功，900为失败），默认值：800 800 errorCode String 失败时的错误代码，参见公共错误码说明 message String 失败时的错误描述，一般为英文描述 Success msgDesc String 失败时的错误描述，一般为中文描述 成功 returnObj Object 返回参数，参考returnObj对象结构 returnObj error String 错误码，请求成功时，不返回该字段 Openapi.Parameter.Error

策略绑定 策略生效粒度 当前支持命名空间、服务、工作负载、网关的生效粒度配置，说明如下 生效粒度 说明 命名空间 策略下发到所选择命名空间下所有数据面 服务 策略下发到所选服务关联的工作负载数据面 工作负载 策略下发到指定工作负载的数据面 网关 策略下发到网关 请求匹配规则 支持基于请求特征匹配决定是否执行当前策略，支持的匹配项及说明如下 匹配项 说明 HTTP域名(Host) 匹配一组请求的域名 HTTP路径(Path) 匹配一组请求路径 HTTP方法(Method) 匹配一组请求的HTTP Method 端口(Port) 匹配一组请求的目标服务端口 说明 域名和路径匹配支持以下匹配模式 1. 精确匹配：如abc匹配abc字符串 2. 前缀匹配：abc匹配abc、abcd、abce等 3. 后缀匹配：abc匹配abc、xabc、zabc等 4. 存在匹配：匹配所有非空值 请求匹配支持黑白名单模式 1. 黑名单模式：选中请求必须执行认证策略 2. 白名单模式：选中请求跳过认证策略，其他请求需要执行策略

场景 CPU峰值 内存峰值 proxy推送频率峰值ops/s 推送耗时P99 推送耗时P999 XDS平均请求量峰值 基线 1.8 668M 170 497ms 2.6s 1MB/s 开启瞬间 0.435 (75.8%) 362M (45.8%) 38 (77.6%) 90ms (81.9%) 90ms (96.5%) 23KB/s (97.8%)