概念
- 商品 ID 為參數,統計一段時間內最常購買的商品 ID 并進行限制
- 用戶 ID 為參數,針對一段時間內頻繁訪問的用戶 ID 進行限制
熱點參數限流會統計傳入參數中的熱點參數,并根據配置的限流閾值與模式,對包含熱點參數的資源調用進行限流。
熱點參數限流可以看做是一種特殊的流量控制,僅對包含熱點參數的資源調用生效。
Sentinel 利用 LRU 策略統計最近最常訪問的熱點參數,結合令牌桶算法來進行參數級別的流控。
使用熱單參數限流式不能使用資源路徑,必須要使用資源名的方式。
Sentinel提供了@SentinelResource 注解用于定義資源
@SentinelResource
@SentinelResource
用于定義資源,并提供可選的異常處理和 fallback 配置項。
@SentinelResource
注解包含以下屬性:
-
value
:資源名稱,必需項(不能為空) -
entryType
:entry 類型,可選項(默認為EntryType.OUT
) -
blockHandler
/blockHandlerClass
:blockHandler
對應處理BlockException
的函數名稱,可選項。blockHandler 函數訪問范圍需要是public
,返回類型需要與原方法相匹配,參數類型需要和原方法相匹配并且最后加一個額外的參數,類型為BlockException
。blockHandler 函數默認需要和原方法在同一個類中。若希望使用其他類的函數,則可以指定blockHandlerClass
為對應的類的Class
對象,注意對應的函數必需為 static 函數,否則無法解析。 -
fallbac
/fallbackClass
:fallback 函數名稱,可選項,用于在拋出異常的時候提供 fallback 處理邏輯。fallback 函數可以針對所有類型的異常(除了exceptionsToIgnore
里面排除掉的異常類型)進行處理。fallback 函數簽名和位置要求:
1.返回值類型必須與原函數返回值類型一致;
2.方法參數列表需要和原函數一致,或者可以額外多一個 Throwable
類型的參數用于接收對應的異常。
3.fallback 函數默認需要和原方法在同一個類中。若希望使用其他類的函數,則可以指定
fallbackClass
為對應的類的 Class
對象,注意對應的函數必需為 static 函數,否則無法解析。
-
defaultFallback
(since 1.6.0):默認的 fallback 函數名稱,可選項,通常用于通用的 fallback 邏輯(即可以用于很多服務或方法)。默認 fallback 函數可以針對所有類型的異常(除了exceptionsToIgnore
里面排除掉的異常類型)進行處理。若同時配置了 fallback 和 defaultFallback,則只有 fallback 會生效。defaultFallback 函數簽名要求:
1.返回值類型必須與原函數返回值類型一致;
2.方法參數列表需要為空,或者可以額外多一個 Throwable
類型的參數用于接收對應的異常。
3.defaultFallback 函數默認需要和原方法在同一個類中。若希望使用其他類的函數,
則可以指定 fallbackClass
為對應的類的 Class
對象,注意對應的函數必需為 static 函數,否則無法解析。
-
exceptionsToIgnore
(since 1.6.0):用于指定哪些異常被排除掉,不會計入異常統計中,也不會進入 fallback 邏輯中,而是會原樣拋出。
注意:注解方式埋點不支持 private 方法特別地,若 blockHandler 和 fallback 都進行了配置,
則被限流降級而拋出 BlockException 時只會進入 blockHandler 處理邏輯。
若未配置 blockHandler、fallback 和 defaultFallback,
則被限流降級時會將 BlockException 直接拋出
(若方法本身未定義 throws BlockException 則會被 JVM 包裝一層 UndeclaredThrowableException)。
小試牛刀
TestController.java
我們將之前的TestController中的/test/hello
方法做以下處理:
import com.alibaba.csp.sentinel.annotation.SentinelResource; import com.alibaba.csp.sentinel.slots.block.BlockException; import com.alibaba.csp.sentinel.slots.block.degrade.DegradeException; import com.alibaba.csp.sentinel.slots.block.flow.FlowException; import com.alibaba.csp.sentinel.slots.block.flow.param.ParamFlowException; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; /** * @Author Christy * @Date 2021/8/6 10:17 **/ @RestController @RequestMapping("/test") public class TestController { private static final Logger log = LoggerFactory.getLogger(TestController.class); /** * @SentinelResource: 代表這是一個sentinel資源 * value: 資源名稱 * blockHandler: 使用sentinel進行不同規則控制時的默認處理方案 * fallback: 自定義業務出錯時默認處理方案 * defaultFallback: 業務錯誤時的默認處理方案 */ @RequestMapping("/hello") @SentinelResource(value = "hello",blockHandler = "blockHandler",fallback = "fallback",defaultFallback = "defaultFallback") public String sayHello(Integer id){ log.info("Hello, Sentinel!"); if(id < 0){ throw new RuntimeException(); } return "Hello, Sentinel!"; } public String blockHandler(Integer id, BlockException e){ if(e instanceof FlowException){ return "當前請求被流控!"; } if(e instanceof DegradeException){ return "當前請求被降級!"; } if(e instanceof ParamFlowException){ return "當前請求被熱點參數限流!"; } return "當前訪問人數太多,請稍后再試!"; } public String fallback(Integer id){ return "fallback函數處理的異常!"; } public String defaultFallback(){ return "默認的fallback函數處理的異常!"; } @RequestMapping("/bye") public String sayBye(){ log.info("Bye, Sentinel!"); return "Bye, Sentinel!"; } }
defaultFallback
首先我們來試下沒有自定義fallback的情況,我們將TestControler中的/test/hello
修改如下:
@RequestMapping("/hello") @SentinelResource(value = "hello",blockHandler = "blockHandler",defaultFallback = "defaultFallback") public String sayHello(Integer id){ log.info("Hello, Sentinel!"); if(id < 0){ throw new RuntimeException(); } return "Hello, Sentinel!"; }
然后我們啟動項目,在瀏覽器中訪問http://localhost:8990/test/hello?id=-1,
界面會返回默認的fallback函數處理的異常!如下圖所示:
fallback
同樣的方式我們將TestControler中的/test/hello
修改如下
@RequestMapping("/hello") @SentinelResource(value = "hello",blockHandler = "blockHandler",fallback = "fallback",defaultFallback = "defaultFallback") public String sayHello(Integer id){ log.info("Hello, Sentinel!"); if(id < 0){ throw new RuntimeException(); } return "Hello, Sentinel!"; }
我們再次啟動項目,在瀏覽器中訪問http://localhost:8990/test/hello?id=-1,
界面會返回默認的fallback函數處理的異常!
如下圖所示:
流量控制
我們在Sentinel中的流控規則中新增一個規則,
如下所示:
然后我們在瀏覽器中訪問http://localhost:8990/test/hello,
發現結果被流控
熔斷降級
我們刪除上面的流控規則,按照下圖所示新增一個熔斷規則,
如圖所示:
然后我們在瀏覽器中訪問http://localhost:8990/test/hello?id=-1,
發現結果被降級
熱點參數限流
同樣的我們刪除上面的熔斷規則,按照下圖所示新增一個熱點參數規則。
如圖所示:
然后我們在瀏覽器中訪問http://localhost:8990/test/hello?id=-1
發現結果被熱點參數限流
高級選項
在熱點規則的底部有高級選項功能,點開它如下圖所示:
- 參數類型:是上述參數索引對應參數的類型。比如我們訪問:http://localhost:8990/test/hello?id=?值得就是id的類型
- 參數值:我們上面寫的是2,意思是只對id=2這個進行熱點參數限流,其余的放過;
- 限流閾值:在統計時長內超過設定的閾值就會被限流
我們在瀏覽器訪問http://localhost:8990/test/hello?id=1可以發現是沒有問題的,沒有被限流。
但是當訪問http://localhost:8990/test/hello?id=2時就會被限流。
如圖所示
熱點限流的高級選項中可以添加多個參數例外項
以上就是Sentinel熱點規則示例詳解分析的詳細內容,更多關于Sentinel熱點規則的資料請關注服務器之家其它相關文章!
原文鏈接:https://blog.csdn.net/bbxylqf126com/article/details/119906245