Spring Cloud Alibaba基础教程：使用Sentinel实现接口限流

￡神魔★判官ぃ 2022-02-21 04:43 181阅读 0赞

> 最近管点闲事浪费了不少时间，感谢网友`libinwalan`的留言提醒。及时纠正路线，继续跟大家一起学习Spring Cloud Alibaba。

Nacos作为注册中心和配置中心的基础教程，到这里先告一段落，后续与其他结合的内容等讲到的时候再一起拿出来说，不然内容会有点跳跃。接下来我们就来一起学习一下Spring Cloud Alibaba下的另外一个重要组件：Sentinel。

## Sentinel是什么 ##

Sentinel的官方标题是：分布式系统的流量防卫兵。从名字上来看，很容易就能猜到它是用来作服务稳定性保障的。对于服务稳定性保障组件，如果熟悉Spring Cloud的用户，第一反应应该就是Hystrix。但是比较可惜的是Netflix已经宣布对Hystrix停止更新。那么，在未来我们还有什么更好的选择呢？除了Spring Cloud官方推荐的resilience4j之外，目前Spring Cloud Alibaba下整合的Sentinel也是用户可以重点考察和选型的目标。

Sentinel的功能和细节比较多，一篇内容很难介绍完整。所以下面我会分多篇来一一介绍Sentinel的重要功能。本文就先从限流入手，说说如何把Sentinel整合到Spring Cloud应用中，以及如何使用Sentinel Dashboard来配置限流规则。通过这个简单的例子，先将这一套基础配置搭建起来。

## 使用Sentinel实现接口限流 ##

Sentinel的使用分为两部分：

*  sentinel-dashboard：与hystrix-dashboard类似，但是它更为强大一些。除了与hystrix-dashboard一样提供实时监控之外，还提供了流控规则、熔断规则的在线维护等功能。
 *  客户端整合：每个微服务客户端都需要整合sentinel的客户端封装与配置，才能将监控信息上报给dashboard展示以及实时的更改限流或熔断规则等。

下面我们就分两部分来看看，如何使用Sentienl来实现接口限流。

### 部署Sentinel Dashboard ###

本文采用的spring cloud alibaba版本是0.2.1，可以查看依赖发现当前版本使用的是sentinel 1.4.0。为了顺利完成本文的内容，我们可以挑选同版本的sentinel dashboard来使用是最稳妥的。

下载地址：[https://github.com/alibaba/Sentinel/releases/download/1.4.0/sentinel-dashboard-1.4.0.jar][https_github.com_alibaba_Sentinel_releases_download_1.4.0_sentinel-dashboard-1.4.0.jar]  
其他版本：[https://github.com/alibaba/Sentinel/releases][https_github.com_alibaba_Sentinel_releases]

> 同以往的Spring Cloud教程一样，这里也不推荐大家跨版本使用，不然可能会出现各种各样的问题。

通过命令启动：

java -jar sentinel-dashboard-1.4.0.jar

sentinel-dashboard不像Nacos的服务端那样提供了外置的配置文件，比较容易修改参数。不过不要紧，由于sentinel-dashboard是一个标准的spring boot应用，所以如果要自定义端口号等内容的话，可以通过在启动命令中增加参数来调整，比如：`-Dserver.port=8888`。

默认情况下，sentinel-dashboard以8080端口启动，所以可以通过访问：`localhost:8080`来验证是否已经启动成功，如果一切顺利的话，可以看到如下页面：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5Yzg3MTEy_size_16_color_FFFFFF_t_70]

### 整合Sentinel ###

**第一步**：在Spring Cloud应用的`pom.xml`中引入Spring Cloud Alibaba的Sentinel模块：

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
        </dependency>
    
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.2</version>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

**第二步**：在Spring Cloud应用中通过`spring.cloud.sentinel.transport.dashboard`参数配置sentinel dashboard的访问地址，比如：

spring.application.name=alibaba-sentinel-rate-limiting
    server.port=8001
    
    # sentinel dashboard
    spring.cloud.sentinel.transport.dashboard=localhost:8080

**第三步**：创建应用主类，并提供一个rest接口，比如：

@SpringBootApplication
    public class TestApplication { 
    
        public static void main(String[] args) { 
            SpringApplication.run(TestApplication.class, args);
        }
    
        @Slf4j
        @RestController
        static class TestController { 
    
            @GetMapping("/hello")
            public String hello() { 
                return "didispace.com";
            }
    
        }
    
    }

**第四步**：启动应用，然后通过postman或者curl访问几下`localhost:8001/hello`接口。

$ curl localhost:8001/hello
    didispace.com

此时，在上一节启动的Sentinel Dashboard中就可以当前我们启动的`alibaba-sentinel-rate-limiting`这个服务以及接口调用的实时监控了。具体如下图所示：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5Yzg3MTEy_size_16_color_FFFFFF_t_70 1]

### 配置限流规则 ###

在完成了上面的两节之后，我们在`alibaba-sentinel-rate-limiting`服务下，点击`簇点链路`菜单，可以看到如下界面：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5Yzg3MTEy_size_16_color_FFFFFF_t_70 2]  
其中`/hello`接口，就是我们上一节中实现并调用过的接口。通过点击`流控`按钮，来为该接口设置限流规则，比如：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5Yzg3MTEy_size_16_color_FFFFFF_t_70 3]

这里做一个最简单的配置：

*  阈值类型选择：QPS
 *  单机阈值：2

综合起来的配置效果就是，该接口的限流策略是每秒最多允许2个请求进入。

点击`新增`按钮之后，可以看到如下界面：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5Yzg3MTEy_size_16_color_FFFFFF_t_70 4]

其实就是左侧菜单中`流控规则`的界面，这里可以看到当前设置的所有限流策略。

### 验证限流规则 ###

在完成了上面所有内容之后，我们可以尝试一下快速的调用这个接口，看看是否会触发限流控制，比如：

$ curl localhost:8001/hello
    didispace.com
    $ curl localhost:8001/hello
    didispace.com
    $ curl localhost:8001/hello
    Blocked by Sentinel (flow limiting)

可以看到，快速的调用两次`/hello`接口之后，第三次调用被限流了。

## 代码示例 ##

本文介绍内容的客户端代码，示例读者可以通过查看下面仓库中的`alibaba-sentinel-rate-limiting`项目：

*  *Github：*[https://github.com/dyc87112/SpringCloud-Learning/][https_github.com_dyc87112_SpringCloud-Learning]
 *  *Gitee：*[https://gitee.com/didispace/SpringCloud-Learning/][https_gitee.com_didispace_SpringCloud-Learning]

**如果您对这些感兴趣，欢迎star、follow、收藏、转发给予支持！**

## 参考资料 ##

下面是Sentinel的仓库地址与官方文档，读者也可以自己查阅文档学习：

*  [Github][]
 *  [Sentinel官方文档][Sentinel]
 *  [Spring Cloud Alibaba Sentinel文档][Spring Cloud Alibaba Sentinel]

## 系列回顾 ##

*  [《Spring Cloud Alibaba基础教程：使用Nacos实现服务注册与发现》][Spring Cloud Alibaba_Nacos]
 *  [《Spring Cloud Alibaba基础教程：支持的几种服务消费方式》][Spring Cloud Alibaba]
 *  [《Spring Cloud Alibaba基础教程：使用Nacos作为配置中心》][Spring Cloud Alibaba_Nacos 1]
 *  [《Spring Cloud Alibaba基础教程：Nacos配置的加载规则详解》][Spring Cloud Alibaba_Nacos 2]
 *  [《Spring Cloud Alibaba基础教程：Nacos配置的多环境管理》][Spring Cloud Alibaba_Nacos 3]
 *  [《Spring Cloud Alibaba基础教程：Nacos配置的多文件加载与共享配置》][Spring Cloud Alibaba_Nacos 4]
 *  [《Spring Cloud Alibaba基础教程：Nacos的数据持久化》][Spring Cloud Alibaba_Nacos 5]
 *  [《Spring Cloud Alibaba基础教程：Nacos的集群部署》][Spring Cloud Alibaba_Nacos 6]

## 专题推荐 ##

*  [Spring Boot基础教程][Spring Boot]
 *  [Spring Cloud基础教程][Spring Cloud]

[https_github.com_alibaba_Sentinel_releases_download_1.4.0_sentinel-dashboard-1.4.0.jar]: https://github.com/alibaba/Sentinel/releases/download/1.4.0/sentinel-dashboard-1.4.0.jar
[https_github.com_alibaba_Sentinel_releases]: https://github.com/alibaba/Sentinel/releases
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5Yzg3MTEy_size_16_color_FFFFFF_t_70]: /images/20220221/8aca0168e0ed4d028f1cd9e0907f7eb4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5Yzg3MTEy_size_16_color_FFFFFF_t_70 1]: /images/20220221/fdf45294560a4177ac713ea16b08a335.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5Yzg3MTEy_size_16_color_FFFFFF_t_70 2]: /images/20220221/53eeecb2339b4953a831d14c84966fc3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5Yzg3MTEy_size_16_color_FFFFFF_t_70 3]: /images/20220221/cc04f0146a7f4815a22cf121d7f8828b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2R5Yzg3MTEy_size_16_color_FFFFFF_t_70 4]: /images/20220221/82c3f1a08678454980d62e0391263699.png
[https_github.com_dyc87112_SpringCloud-Learning]: https://github.com/dyc87112/SpringCloud-Learning/tree/master/4-Finchley
[https_gitee.com_didispace_SpringCloud-Learning]: https://gitee.com/didispace/SpringCloud-Learning/tree/master/4-Finchley
[Github]: https://github.com/alibaba/Sentinel
[Sentinel]: https://github.com/alibaba/Sentinel/wiki/%E4%BB%8B%E7%BB%8D
[Spring Cloud Alibaba Sentinel]: https://github.com/spring-cloud-incubator/spring-cloud-alibaba/wiki/Sentinel
[Spring Cloud Alibaba_Nacos]: http://blog.didispace.com/spring-cloud-alibaba-1/
[Spring Cloud Alibaba]: http://blog.didispace.com/spring-cloud-alibaba-2/
[Spring Cloud Alibaba_Nacos 1]: http://blog.didispace.com/spring-cloud-alibaba-3/
[Spring Cloud Alibaba_Nacos 2]: http://blog.didispace.com/spring-cloud-alibaba-nacos-config-1/
[Spring Cloud Alibaba_Nacos 3]: http://blog.didispace.com/spring-cloud-alibaba-nacos-config-2/
[Spring Cloud Alibaba_Nacos 4]: http://blog.didispace.com/spring-cloud-alibaba-nacos-config-3/
[Spring Cloud Alibaba_Nacos 5]: http://blog.didispace.com/spring-cloud-alibaba-4/
[Spring Cloud Alibaba_Nacos 6]: http://blog.didispace.com/spring-cloud-alibaba-5/
[Spring Boot]: http://blog.didispace.com/Spring-Boot%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/
[Spring Cloud]: http://blog.didispace.com/spring-cloud-learning/