SpringBoot進階教程(六十八)Sentinel實現限流降級

2020 年 12 月 26 日
筆記
Spring Boot, springboot, 限流

前面兩篇文章nginx限流配置和SpringBoot進階教程(六十七)RateLimiter限流，我們介紹了如何使用nginx和RateLimiter限流，這篇文章介紹另外一種限流方式—Sentinel。

Sentinel 是阿里中間件團隊開源的，面向分散式服務架構的輕量級高可用流量控制組件，主要以流量為切入點，從流量控制、熔斷降級、系統負載保護等多個維度來幫助用戶保護服務的穩定性。歷次在雙十一大促等核心場景的應用更是使其大放異彩。今天就來介紹介紹Alibaba sentinel。

vsentinel主要特性

圖片來源於網路，侵刪。

vLinux sentinel安裝與部署

1.1 下載sentinel_dashboardjar包

可以在//github.com/alibaba/Sentinel/releases找到合適的版本，當前最新版本sentinel-dashboard-1.8.0.jar下載

1.1 部署

java -Dserver.port=8080 -Dcsp.sentinel.dashboard.server=localhost:8858 -Dproject.name=sentinel-dashboard -jar sentinel-dashboard-1.8.0.jar

-Dserver.port=8080 代表看板項目的埠號，-Dcsp.sentinel.dashboard.server=localhost:8858代表本dashboard服務將會被註冊，-Dproject.name=sentinel-dashboard代表本身服務的項目名稱。訪問localhost:8858；輸入用戶名，密碼(用戶名/密碼默認值sentinel)。

也可以自定義用戶名密碼，在啟動命令加上 -Dsentinel.dashboard.auth.username=toutou -Dsentinel.dashboard.auth.password=123456 。

vdocker sentinel安裝與部署

我在虛擬機裝了docker，所以下文中實例中講解的部分，是基於docker的sentinel。若未安裝docker的朋友可以看看這篇文章Docker從安裝部署到Hello World。

2.1 拉取sentinel鏡像

docker pull bladex/sentinel-dashboard:1.8.0

2.2 創建容器

docker run --name sentinel -d -p 8858:8858 bladex/sentinel-dashboard:1.8.0

2.3 啟動容器

docker start sentinel

v驗證安裝效果

訪問 //ip:8858/

上文已經介紹了，使用用戶名/密碼默認值sentinel登錄。

默認會有一個sentinel-dashboard。

vspringboot整合sentinel

3.1 添加依賴pom.xml

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
            <version>0.9.0.RELEASE</version>
        </dependency>

3.2 添加配置application.properties

spring.cloud.sentinel.transport.port=9719
spring.cloud.sentinel.transport.dashboard=toutou.com:8858

3.3 添加兜底方法

/**
 * @author toutou
 * @date by 2020/12
 * @des   //www.cnblogs.com/toutou
 */
@Slf4j
public class BlockHandlerUtil {
    public Result message(BlockException blockExe){
        log.info(blockExe.toString());
        return Result.setErrorResult(555, "網路擁堵，請稍後再試。");
    }
}

3.4 添加controller

/**
 * @author toutou
 * @date by 2020/12
 * @des   //www.cnblogs.com/toutou
 */
@Slf4j
@RestController
public class IndexController {
    @GetMapping("/hello")
    @SentinelResource(value="hello",blockHandlerClass = BlockHandlerUtil.class, blockHandler = "message")
    public Result hello(@RequestParam(value = "name",defaultValue = "toutou",required = false)String name){
        return Result.setSuccessResult("hello " + name);
    }
}

3.5 @SentinelResource註解

@SentinelResource可以涵蓋Sentinel的大部分應用場景，所以搞懂@SentinelResource就能更好的使用Sentinel。

屬性名	是否必填	說明
value	是	資源名稱。（必填項，需要通過 `value` 值找到對應的規則進行配置）
entryType	否	entry類型，標記流量的方向，取值IN/OUT，默認是OUT
blockHandler	否	處理BlockException的函數名稱(可以理解為對Sentinel的配置進行方法兜底)。函數要求： 1.必須是 public 修飾 2.返回類型與原方法一致 3. 參數類型需要和原方法相匹配，並在最後加 BlockException 類型的參數。 4. 默認需和原方法在同一個類中。若希望使用其他類的函數，可配置 blockHandlerClass ，並指定blockHandlerClass裡面的方法。
blockHandlerClass	否	存放blockHandler的類。對應的處理函數必須 public static 修飾，否則無法解析，其他要求：同blockHandler。
fallback	否	用於在拋出異常的時候提供fallback處理邏輯(可以理解為對Java異常情況方法兜底)。 fallback函數可以針對所有類型的異常（除了 exceptionsToIgnore 裡面排除掉的異常類型）進行處理。函數要求： 1.返回類型與原方法一致 2.參數類型需要和原方法相匹配，Sentinel 1.6開始，也可在方法最後加 Throwable 類型的參數。 3.默認需和原方法在同一個類中。若希望使用其他類的函數，可配置 fallbackClass ，並指定fallbackClass裡面的方法。
fallbackClass	否	存放fallback的類。對應的處理函數必須static修飾，否則無法解析，其他要求：同fallback。
defaultFallback	否	用於通用的 fallback 邏輯。默認 fallback 函數可以針對所有類型的異常（除了 exceptionsToIgnore 裡面排除掉的異常類型）進行處理。若同時配置了 fallback 和 defaultFallback，以fallback為準。函數要求： 1.返回類型與原方法一致 2.方法參數列表為空，或者有一個 Throwable 類型的參數。 3.默認需要和原方法在同一個類中。若希望使用其他類的函數，可配置 fallbackClass ，並指定 fallbackClass 裡面的方法。
exceptionsToIgnore	否	指定排除掉哪些異常。排除的異常不會計入異常統計，也不會進入fallback邏輯，而是原樣拋出。
exceptionsToTrace	否	需要trace的異常

vSentinel 控制台

用瀏覽器打開//localhost:8301/hello，這時Sentinel 控制台相關的可配置菜單和可視化介面的參數就會對應的展示出來。

4.1 添加流控規則

在”簇點鏈路”中可以添加各種規則，比如我們添加的”流控”，添加以後便可以在”流控規則”中查看。

4.2 ab test測試

使用ab test測試工具測試下流控規則， ab -n 30 -c 5 //localhost:8301/hello 。如果ab test不會用的，可以看看這篇文章ab test壓力測試。

上圖是Sentinel 控制台中的實時監控，可以看出流控規則已經生效。同時我們用瀏覽器訪問//localhost:8301/hello，效果如下圖，可以看到返回值與我們設置的code一致。

4.3 降級規則

參數說明：

v源碼地址

//github.com/toutouge/javademosecond/tree/master/hellolearn

作　　者：請叫我頭頭哥

出　　處：//www.cnblogs.com/toutou/

關於作者：專註於基礎平台的項目開發。如有問題或建議，請多多賜教！

版權聲明：本文版權歸作者和部落格園共有，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文鏈接。

特此聲明：所有評論和私信都會在第一時間回復。也歡迎園子的大大們指正錯誤，共同進步。或者直接私信我

聲援部落客：如果您覺得文章對您有幫助，可以點擊文章右下角【推薦】一下。您的鼓勵是作者堅持原創和持續寫作的最大動力！

Tags: Spring Boot springboot 限流