快速体验 Sentinel 集群限流功能，只需简单几步

深藏阁楼爱情的钟 2024-03-25 17:03 53阅读 0赞

Pic by Alibaba Tech on Facebook

[集群限流][Link 1] 可以限制某个资源调用在集群内的总 QPS，并且可以解决单机流量不均导致总的流控效果不佳的问题，是保障服务稳定性的利器。

![format_png][]

Sentinel 从 [1.4.0][] 版本开始提供集群流控特性，但使用 Sentinel 集群限流需要对一系列的动态数据源进行相关配置，并且需要对开源控制台进行一些改造，有一定的使用成本。为了大家更好地理解集群流控并快速地使用，我们提供了云上版本的 Sentinel 集群限流控制台示例。只需要简单的几步即可快速接入 AHAS Sentinel 集群限流控制台，无需手动配置动态数据源。

> 注：本控制台示例位于云上环境，需要使用阿里云账号登录。

### 1. 引入依赖 ###

我们只需要在 Maven 中引入以下依赖：

<dependency>
      <groupId>com.alibaba.csp</groupId>
      <artifactId>ahas-sentinel-client</artifactId>
      <version>1.1.0</version>
    </dependency>

`ahas-sentinel-client` 中会包含 `sentinel-core` 以及集群限流等必要依赖（基于 Sentinel 1.4.1 版本），以及连接阿里云 AHAS Sentinel 控制台所需模块（鉴权、通信等）。同时 `ahas-sentinel-client` 实现了 push 模式的数据源并且会自动注册所有规则配置和集群配置数据源，在控制台推送即可实时生效：

![format_png 1][]

若之前接入了开源 Sentinel 控制台，则需要将相关的通信依赖（如 `sentinel-transport-simple-http` 或 `sentinel-transport-netty-http`）替换成此依赖，否则将无法正确连接 AHAS Sentinel 控制台。若希望从 AHAS Sentinel 控制台切换到开源 Sentinel 控制台，只需要将依赖替换回来，修改一下启动参数即可。

> 注意：ahas-sentinel-client 1.1.x 仅兼容 Sentinel 1.4.1 及以上版本。

### 2. 开通 AHAS，获取启动参数 ###

引入依赖后，我们需要到 [阿里云控制台][Link 2] 开通 AHAS 功能（免费）。可以根据 [开通 AHAS 文档][AHAS] 和 [Sentinel 流控降级 Demo 快速入门][Sentinel _ Demo] 里面的指引进行开通。注意若应用运行在非阿里云 ECS 环境或本地，需要在左上角选择切换 **公网** 环境。

开通后我们可以点击左侧侧边栏的 **流控降级**，进入 Sentinel 控制台应用总览页面。在页面右上角，单击 **应用接入**，选择 Java SDK 接入页签，到 **配置启动参数** 页签拿到需要的 JVM 启动参数（详情请参考 [SDK 接入文档][SDK]），类似于：

-Dproject.name=AppName -Dahas.license=<License>

其中 `project.name` 代表应用名（会显示在控制台），`ahas.license` 代表自己的授权 license。

> 注意：若应用运行在非阿里云 ECS 环境或本地，需要在左上角切换到 **公网** 环境。

详细接入步骤可以参考 [AHAS Sentinel 控制台文档][AHAS Sentinel]。

### 3. 启动应用实例 ###

接下来我们就可以在本地启动应用了，启动应用时需要加上拿到的启动参数。若要在本地体验集群限流功能，需要在本机启动多个应用实例，并额外添加 `-Dcsp.sentinel.log.use.pid=true` 参数（用于区分同个应用多个实例）。启动之后，我们就可以在对应应用的机器列表页面看到接入的机器了：

![format_png 2][]

### 4. 分配 Token Server ###

集群限流中共有两种身份：

*  Token Client 即集群流控客户端，用于向所属 Token Server 通信请求 token。集群限流服务端会返回给客户端结果，决定是否限流。Sentinel 集群流控的通信底层采用 Netty 实现。
 *  Token Server 即集群流控服务端，处理来自 Token Client 的请求，根据配置的集群规则判断是否应该发放 token（是否允许通过）。

本示例中 Token Server 模式为嵌入模式，即作为内置的 Token Server 与应用在同一进程中启动，无需单独部署：

![format_png 3][]

我们需要通过特定的 URL 来进入 AHAS 集群流控 Demo 页面（其中 `appName` 后面的参数替换成我们的应用名）：

[https://ahas.console.aliyun.com/\#/SystemGuardClusterServerPage?appName=web-demo&regionId=public][https_ahas.console.aliyun.com_SystemGuardClusterServerPage_appName_web-demo_regionId_public]

然后我们就进入到了集群流控 Token Server 列表页面：

![format_png 4][]

我们可以点击右上角的 **新增 Token Server** 按钮来新增 Token Server 并执行分配。我们首先需要在新增 Token Server 对话框内选择一台 Token Server，并配置该 Token Server 的端口以及最大的 QPS 配额（用于限制资源使用，防止嵌入模式下影响应用本身）。接下来我们就在下面的选择框中为该 Token Server 分配 Token Client。在上面图中的例子中，我们的应用共有两个实例，其中一个指定为 Token Server，另一个指定为 Token Client。选择完成后点击“保存”按钮保存分配。

![format_png 5][]

保存成功后，我们就能在 Token Server 列表页面看到刚刚分配的 Token Server 了：

![format_png 6][]

点击左侧的下拉按钮，可以看到该 Token Server 和所管理的 Token Client 的实时信息：

![format_png 7][]

### 5. 配置规则，查看效果 ###

接下来我们去流控规则页面给我们的应用配置流控规则。先对某个资源配置普通的流控规则，单机 QPS 阈值设置为 10：

![format_png 8][]

然后分别持续请求两台机器对应的资源，可以在监控页面看到总 QPS 为 20（每个单机 QPS 各为 10）：

![format_png 9][]

接下来我们编辑刚才新建的规则，开启集群模式，阈值模式选择“**总体阈值**”，代表对该资源限制集群内的调用总量为 10。保存规则：

![format_png 10][]

等待一段时间，我们可以在监控页面看到资源的总 QPS 被限到了 10：

![format_png 11][]

有关 Sentinel 集群流控的更多特性和用法，可以参考 [Sentinel 集群流控文档][Link 1] 以及之前的集群流控的文章。我们同时提供了嵌入模式下应用配置集群流控配置源的 Demo

来源：[快速体验 Sentinel 集群限流功能，只需简单几步 - 知乎][Sentinel _ -]

[Link 1]: https://link.zhihu.com/?target=https%3A//github.com/alibaba/Sentinel/wiki/
[format_png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/094fc9b6dc664573b8aafeb51d9f505e.png
[1.4.0]: https://link.zhihu.com/?target=https%3A//mp.weixin.qq.com/s%3F__biz%3DMzU4NzU0MDIzOQ%3D%3D%26mid%3D2247485392%26idx%3D2%26sn%3Dc65cd230c2c2195bbba41c61b3849162%26chksm%3Dfdeb35b0ca9cbca6b6baa4af2276fff01771d4dbe1aa55c5d7d972282118a60f94cf5058e9e1%26token%3D1795393417%25E2%258C%25A9%3Dzh_CN%23rd
[format_png 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/b95c33bc6a3d4fc3b0871875a3a5d888.png
[Link 2]: https://link.zhihu.com/?target=https%3A//ahas.console.aliyun.com/
[AHAS]: https://link.zhihu.com/?target=https%3A//help.aliyun.com/document_detail/90323.html
[Sentinel _ Demo]: https://link.zhihu.com/?target=https%3A//help.aliyun.com/document_detail/101410.html
[SDK]: https://link.zhihu.com/?target=https%3A//help.aliyun.com/document_detail/101088.html
[AHAS Sentinel]: https://link.zhihu.com/?target=https%3A//github.com/alibaba/Sentinel/wiki/AHAS-Sentinel-%25E6%258E%25A7%25E5%2588%25B6%25E5%258F%25B0
[format_png 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/1d9d46a641944a34935584b43878aa0c.png
[format_png 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/dc941d475a4043c2b3d0b9a2d5df0b85.png
[https_ahas.console.aliyun.com_SystemGuardClusterServerPage_appName_web-demo_regionId_public]: https://link.zhihu.com/?target=https%3A//ahas.console.aliyun.com/%23/SystemGuardClusterServerPage%3FappName%3Dweb-demo%26regionId%3Dpublic
[format_png 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/c17eae8146f54ddcbcbe80e3f4de6dee.png
[format_png 5]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/59a1ecc9a29b409d8346b190f312bc89.png
[format_png 6]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/c1dd47f63b0a4c1ba59d6468c4f93047.png
[format_png 7]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/32ae420cc0374090beece41fe120d50a.png
[format_png 8]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/6f9160e39f9d41cf8d117cf8bd8d2c63.png
[format_png 9]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/2054a13dae864de7a4914f7a7ac2c76e.png
[format_png 10]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/7ddbbbedc942435a997a1a94917d9ad0.png
[format_png 11]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/25/0e4b6110e0074bd590d974eab6f2a7bc.png
[Sentinel _ -]: https://zhuanlan.zhihu.com/p/57215816