Spring Cloud Alibaba基礎教程：使用Sentinel實作接口限流

最近管點閑事浪費了不少時間，感謝網友

libinwalan

的留言提醒。及時糾正路線，繼續跟大家一起學習Spring Cloud Alibaba。

Nacos作為注冊中心和配置中心的基礎教程，到這裡先告一段落，後續與其他結合的内容等講到的時候再一起拿出來說，不然内容會有點跳躍。接下來我們就來一起學習一下Spring Cloud Alibaba下的另外一個重要元件：Sentinel。

https://blog.didispace.com/spring-cloud-alibaba-sentinel-1/#Sentinel%E6%98%AF%E4%BB%80%E4%B9%88 Sentinel是什麼

Sentinel的官方标題是：分布式系統的流量防衛兵。從名字上來看，很容易就能猜到它是用來作服務穩定性保障的。對于服務穩定性保障元件，如果熟悉Spring Cloud的使用者，第一反應應該就是Hystrix。但是比較可惜的是Netflix已經宣布對Hystrix停止更新。那麼，在未來我們還有什麼更好的選擇呢？除了Spring Cloud官方推薦的resilience4j之外，目前Spring Cloud Alibaba下整合的Sentinel也是使用者可以重點考察和選型的目标。

Sentinel的功能和細節比較多，一篇内容很難介紹完整。是以下面我會分多篇來一一介紹Sentinel的重要功能。本文就先從限流入手，說說如何把Sentinel整合到Spring Cloud應用中，以及如何使用Sentinel Dashboard來配置限流規則。通過這個簡單的例子，先将這一套基礎配置搭建起來。

https://blog.didispace.com/spring-cloud-alibaba-sentinel-1/#%E4%BD%BF%E7%94%A8Sentinel%E5%AE%9E%E7%8E%B0%E6%8E%A5%E5%8F%A3%E9%99%90%E6%B5%81 使用Sentinel實作接口限流

Sentinel的使用分為兩部分：

• sentinel-dashboard：與hystrix-dashboard類似，但是它更為強大一些。除了與hystrix-dashboard一樣提供實時監控之外，還提供了流控規則、熔斷規則的線上維護等功能。
• 用戶端整合：每個微服務用戶端都需要整合sentinel的用戶端封裝與配置，才能将監控資訊上報給dashboard展示以及實時的更改限流或熔斷規則等。

下面我們就分兩部分來看看，如何使用Sentienl來實作接口限流。

https://blog.didispace.com/spring-cloud-alibaba-sentinel-1/#%E9%83%A8%E7%BD%B2Sentinel-Dashboard 部署Sentinel Dashboard

補充（2019-04-28）：本文案例已更新Spring Cloud Alibaba 0.2.2，由于該版本中更新了Sentinel到1.5.2，是以對sentinel-dashboard做一次更新。但是sentinel-dashboard的1.5.2版本的打封包件沒有提供下載下傳，如果一定要該版本的話，需要自己編譯。這裡筆者嘗試了一下直接使用1.6.0的sentinel-dashboard，暫時也沒有發現什麼問題，是以就以這個版本為例。

• 下載下傳位址： sentinel-dashboard-1.6.0.jar
• 其他版本： Sentinel/releases

同以往的Spring Cloud教程一樣，這裡也不推薦大家跨版本使用，不然可能會出現各種各樣的問題。

通過指令啟動：

java -jar sentinel-dashboard-1.6.0.jar      

sentinel-dashboard不像Nacos的服務端那樣提供了外置的配置檔案，比較容易修改參數。不過不要緊，由于sentinel-dashboard是一個标準的spring boot應用，是以如果要自定義端口号等内容的話，可以通過在啟動指令中增加參數來調整，比如：

-Dserver.port=8888

。

預設情況下，sentinel-dashboard以8080端口啟動，是以可以通過通路：

localhost:8080

來驗證是否已經啟動成功，如果一切順利的話，可以看到如下頁面：

注意：隻有1.6.0及以上版本，才有這個簡單的登入頁面。預設使用者名和密碼都是

sentinel

。對于使用者登入的相關配置可以在啟動指令中增加下面的參數來進行配置：

• -Dsentinel.dashboard.auth.username=sentinel

  : 用于指定控制台的登入使用者名為 sentinel；

• -Dsentinel.dashboard.auth.password=123456

  : 用于指定控制台的登入密碼為 123456；如果省略這兩個參數，預設使用者和密碼均為 sentinel

• -Dserver.servlet.session.timeout=7200

  : 用于指定 Spring Boot 服務端 session 的過期時間，如 7200 表示 7200 秒；60m 表示 60 分鐘，預設為 30 分鐘；

輸入賬戶密碼登入後，可以看到如下頁面：

整合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

這個服務以及接口調用的實時監控了。具體如下圖所示：

配置限流規則

在完成了上面的兩節之後，我們在

alibaba-sentinel-rate-limiting

服務下，點選

簇點鍊路

菜單，可以看到如下界面：

其中

/hello

接口，就是我們上一節中實作并調用過的接口。通過點選

流控

按鈕，來為該接口設定限流規則，比如：

這裡做一個最簡單的配置：

• 門檻值類型選擇：QPS
• 單機門檻值：2

綜合起來的配置效果就是，該接口的限流政策是每秒最多允許2個請求進入。

點選

新增

按鈕之後，可以看到如下界面：

其實就是左側菜單中

流控規則

的界面，這裡可以看到目前設定的所有限流政策。

https://blog.didispace.com/spring-cloud-alibaba-sentinel-1/#%E9%AA%8C%E8%AF%81%E9%99%90%E6%B5%81%E8%A7%84%E5%88%99 驗證限流規則

在完成了上面所有内容之後，我們可以嘗試一下快速的調用這個接口，看看是否會觸發限流控制，比如：

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

可以看到，快速的調用兩次

/hello

接口之後，第三次調用被限流了。

https://blog.didispace.com/spring-cloud-alibaba-sentinel-1/#%E4%BB%A3%E7%A0%81%E7%A4%BA%E4%BE%8B 代碼示例

本文介紹内容的用戶端代碼，示例讀者可以通過檢視下面倉庫中的

alibaba-sentinel-rate-limiting

項目：

• Github： https://github.com/dyc87112/SpringCloud-Learning/
• Gitee： https://gitee.com/didispace/SpringCloud-Learning/

如果您對這些感興趣，歡迎star、follow、收藏、轉發給予支援！

https://blog.didispace.com/spring-cloud-alibaba-sentinel-1/#%E5%8F%82%E8%80%83%E8%B5%84%E6%96%99 參考資料

下面是Sentinel的倉庫位址與官方文檔，讀者也可以自己查閱文檔學習：

• Github
• Sentinel官方文檔
• Spring Cloud Alibaba Sentinel文檔

https://blog.didispace.com/spring-cloud-alibaba-sentinel-1/#%E7%B3%BB%E5%88%97%E5%9B%9E%E9%A1%BE 系列回顧

• 《Spring Cloud Alibaba基礎教程：使用Nacos實作服務注冊與發現》
• 《Spring Cloud Alibaba基礎教程：支援的幾種服務消費方式》
• 《Spring Cloud Alibaba基礎教程：使用Nacos作為配置中心》
• 《Spring Cloud Alibaba基礎教程：Nacos配置的加載規則詳解》
• 《Spring Cloud Alibaba基礎教程：Nacos配置的多環境管理》
• 《Spring Cloud Alibaba基礎教程：Nacos配置的多檔案加載與共享配置》
• 《Spring Cloud Alibaba基礎教程：Nacos的資料持久化》
• 《Spring Cloud Alibaba基礎教程：Nacos的叢集部署》

https://blog.didispace.com/spring-cloud-alibaba-sentinel-1/#%E4%B8%93%E9%A2%98%E6%8E%A8%E8%8D%90 專題推薦

• Spring Boot基礎教程
• Spring Cloud基礎教程