Sentinel 热点规则 (ParamFlowRule)

╰+哭是因爲堅強的太久メ 2024-02-18 11:04 14阅读 0赞

[Sentinel][] 是面向分布式、多语言异构化服务架构的流量治理组件，主要以流量为切入点，从流量路由、流量控制、流量整形、熔断降级、系统自适应过载保护、热点流量防护等多个维度来帮助开发者保障微服务的稳定性。

[Springboot+Dubbo+Nacos 集成 Sentinel（入门）-CSDN博客][Springboot_Dubbo_Nacos _ Sentinel_-CSDN]

## 1.热点规则介绍 ##

热点参数限流会统计传入参数中的热点参数，并根据配置的限流阈值与模式，对包含热点参数的资源调用进行限流。热点参数限流可以看做是一种特殊的流量控制，仅对包含热点参数的资源调用生效。

![8a1c7deebc7540b2940240504e0801ab.png][]

Sentinel 利用 LRU 策略统计最近最常访问的热点参数，结合令牌桶算法来进行参数级别的流控。

热点参数规则（**`ParamFlowRule`**）类似于流量控制规则（**`FlowRule`**）：

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>说明</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>resource</td> 
   <td>资源名，必填</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>count</td> 
   <td>限流阈值，必填</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>grade</td> 
   <td>限流模式</td> 
   <td>QPS 模式</td> 
  </tr> 
  <tr> 
   <td>durationInSec</td> 
   <td>统计窗口时间长度（单位为秒），1.6.0 版本开始支持</td> 
   <td>1s</td> 
  </tr> 
  <tr> 
   <td>controlBehavior</td> 
   <td>流控效果（支持快速失败和匀速排队模式），1.6.0 版本开始支持</td> 
   <td>快速失败</td> 
  </tr> 
  <tr> 
   <td>maxQueueingTimeMs</td> 
   <td>最大排队等待时长（仅在匀速排队模式生效），1.6.0 版本开始支持</td> 
   <td>0ms</td> 
  </tr> 
  <tr> 
   <td>paramIdx</td> 
   <td>热点参数的索引，必填，对应&nbsp;<code>SphU.entry(xxx, args)</code>&nbsp;中的参数索引位置</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>paramFlowItemList</td> 
   <td>参数例外项，可以针对指定的参数值单独设置限流阈值，不受前面&nbsp;<code>count</code>&nbsp;阈值的限制。<strong>仅支持基本类型和字符串类型)</strong></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>clusterMode</td> 
   <td>是否是集群参数流控规则</td> 
   <td><code>false</code></td> 
  </tr> 
  <tr> 
   <td>clusterConfig</td> 
   <td>集群流控相关配置</td> 
  </tr> 
 </tbody> 
</table>

![0e6c2df9bbe44d2cbdb6960b1aff12e8.png][]

##  ##

## 2.资源名（resource） ##

资源名，即限流规则的作用对象（可以是代码中指定名称或者指定路由）。

![01343099716d4eb186f8043b72c8c8dd.png][]

##  ##

## 3.限流模式（grade） ##

默认QPS 模式。

### 4.参数索引（paramIdx） ###

热点参数的索引，必填，对应 SphU.entry(xxx, args) 中的参数索引位置。

![0148abd8a1c7450cb9dc968df74c27dd.png][]

##  ##

## 5.限流阈值（count） ##

![e20bb6a4c00a4b7f90811f262c354e89.png][]

##  ##

## 6.统计窗口时长（durationInSec） ##

统计窗口时间长度（单位为秒），1.6.0 版本开始支持。非集群模式。

![8fcf2724130340779122c938c80e0dcc.png][]

##  ##

## 7.流控效果（controlBehavior） ##

流控效果（支持快速失败和匀速排队模式），1.6.0 版本开始支持 ,默认快速失败。

### 7.1 最大排队等待时长(maxQueueingTimeMs) ###

最大排队等待时长（仅在匀速排队模式生效），1.6.0 版本开始支持。

## 8.是否是集群(clusterMode) ##

是否是集群参数流控规则。

![1dfdb083851042aa96bc69f9cd1b33a0.png][]

### 8.1 集群阈值模式 (clusterConfig)![19de52dd3b474e0593c8f0155c030af4.png][] ###

## 9.参数例外项(paramFlowItemList) ##

参数例外项，可以针对指定的参数值单独设置限流阈值，不受前面 count 阈值的限制。仅支持基本类型和字符串类型)。

![66f82d44c0aa445ab3fb467c857a4e7f.png][]

## **10. 测试示例** ##

### **10.1 客户端代码** ###

@GetMapping(value = "/api/user/{id}")
        @SentinelResource(value = "u-getUserById")
        public String getUserById(@PathVariable("id") Long id) {
            return userService.getName();
        }

### 10.2 控制台-简单配置 ###

![92fe642fac364174a04d1632e82d6319.png][]

### 10.3 控制台-例外配置 ###

特别注意：例外参数类型要与客户端参数一致否则类外配置失效 !!!

![97a3a3bbc8f643e3bd02bc6b5e91f5e8.png][]

## 11.规则持久化 ##

[Sentinel 规则持久化-CSDN博客][Sentinel _-CSDN]

持久化Json数据格式

[
    	{
    		"resource": "u-getUserById",
    		"grade": 1,
    		"paramIdx": 0,
    		"count": 1,
    		"controlBehavior": 0,
    		"maxQueueingTimeMs": 0,
    		"burstCount": 0,
    		"durationInSec": 1,
    		"paramFlowItemList": [
    			{
    				"object": "0",
    				"count": 20,
    				"classType": "long"
    			}
    		],
    		"clusterMode": false,
    		"clusterConfig": {
    			"flowId": null,
    			"thresholdType": 0,
    			"fallbackToLocalWhenFail": true,
    			"sampleCount": 10,
    			"windowIntervalMs": 1000
    		}
    	}
    ]

spring:
      application:
        name: user
      cloud:
        nacos:
          config:
            server-addr: 127.0.0.1:8848
            prefix: dubbo-user-api
            file-extension: yml
        sentinel:
          transport:
            dashboard: 127.0.0.1:6780
          eager: true # 取消懒加载
          datasource:
            ds-user-paramFlow-rule:
              nacos:
                server-addr: 127.0.0.1:8848
                dataId: user-paramFlow-rule
                groupId: user-sentinel
                namespace: sentinel
                rule-type: PARAM_FLOW # AUTHORITY(授权规则) DEGRADE(熔断规则) FLOW(流控规则) GW_API_GROUP GW_FLOW PARAM_FLOW(热点规则) SYSTEM(系统规则)

[Sentinel]: https://so.csdn.net/so/search?q=Sentinel&spm=1001.2101.3001.7020
[Springboot_Dubbo_Nacos _ Sentinel_-CSDN]: https://blog.csdn.net/qq_34253002/article/details/134327732?spm=1001.2014.3001.5501
[8a1c7deebc7540b2940240504e0801ab.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/2877fbdcc1c5414e9a3f48e43bf581f6.png
[0e6c2df9bbe44d2cbdb6960b1aff12e8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/826ead067e064bf99d9a5935e1b4bf36.png
[01343099716d4eb186f8043b72c8c8dd.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/018a848c042e405d9cb14fae4bc26dec.png
[0148abd8a1c7450cb9dc968df74c27dd.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/18ac81af112f454c95b16da11456498f.png
[e20bb6a4c00a4b7f90811f262c354e89.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/441918108c664f889a46f31542ec9fb1.png
[8fcf2724130340779122c938c80e0dcc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/4aaf9942bcb046f3a2ba18d8d61076b6.png
[1dfdb083851042aa96bc69f9cd1b33a0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/8402bb5e888c48089c461a84e0843f68.png
[19de52dd3b474e0593c8f0155c030af4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/577afe70e3dd41c4b2918005c898ebc4.png
[66f82d44c0aa445ab3fb467c857a4e7f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/e22ad757e80547c4849a7631ca8d8c7b.png
[92fe642fac364174a04d1632e82d6319.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/1f2359f02e1b42f08c5b56c4670f11f8.png
[97a3a3bbc8f643e3bd02bc6b5e91f5e8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/18/bd1589e7d0e3426aa24793330b2cccfc.png
[Sentinel _-CSDN]: https://blog.csdn.net/qq_34253002/article/details/134422314?spm=1001.2014.3001.5501