Sentinel

1、概述

1⃣️与Hystrix类似

2⃣️功能：服务雪崩、服务降级、服务熔断、服务限流

3⃣️运行命令：java -jar sentinel-dashboard-1.8.4.jar

4⃣️访问sentinel管理界面：http://localhost:8080，登录账号密码均为sentinel。

2、初始化演示工程

2.1 创建Module

1⃣️新建cloudalibaba-sentinel-service8401

2⃣️Pom

<!--SpringCloud ailibaba sentinel -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>

3⃣️yml

server:
  port: 8401

spring:
  application:
    name: cloudalibaba-sentinel-service
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848 #Nacos服务注册中心地址
    sentinel:
      transport:
        dashboard: localhost:8080 #配置Sentinel dashboard地址
        port: 8719
      datasource:
        ds1:
          nacos:
            server-addr: localhost:8848
            dataId: cloudalibaba-sentinel-service
            groupId: DEFAULT_GROUP
            data-type: json
            rule-type: flow

management:
  endpoints:
    web:
      exposure:
        include: '*'

4⃣️主启动：添加注解@EnableDiscoveryClient

5⃣️业务类Controller

2.2 启动Nacos8848

2.3 启动Sentinel

2.4 启动微服务8401

2.5 启动8401微服务后查看sentienl控制台

Sentinel采用的懒加载说明，执行一次访问即可在控制台看到。

3、流量控制

3.1 流控模式

3.1.1 直接

系统默认：直接-快速失败

例如：表示1秒钟内查询1次就是OK，若超过次数1，就直接-快速失败，报默认错误：Blocked by Sentinel (flow limiting)。

3.1.2 关联：当与A关联的资源B达到阀值后，就限流A自己。

3.1.3 链路：多个请求调用了同一个微服务。

3.2 流控效果

3.2.1 默认的流控处理：直接->快速失败

直接失败，抛出异常：Blocked by Sentinel (flow limiting)。

3.2.2 预热

说明：阈值除以coldFactor(默认值为3)，预热时间内达到除以coldFactor，经过预热时长后才会达到阈值。

3.2.3 排队等待

说明：匀速排队，阈值必须设置为QPS

4、降级规则

4.1 概念

Sentinel 熔断降级会在调用链路中某个资源出现不稳定状态时（例如调用超时或异常比例升高），对这个资源的调用进行限制，让请求快速失败，避免影响到其它的资源而导致级联错误。当资源被降级后，在接下来的降级时间窗口之内，对该资源的调用都自动熔断（默认行为是抛出 DegradeException）。

4.2 降级策略

1⃣️RT（平均响应时间，秒级）：平均响应时间   超出阈值  且   在时间窗口内通过的请求>=5，两个条件同时满足后触发降级，窗口期过后关闭断路器。RT最大4900（更大的需要通过-Dcsp.sentinel.statistic.max.rt=XXXX才能生效）。

2⃣️异常比例（秒级）：QPS >= 5 且 异常比例（秒级统计）超过阈值时，触发降级；时间窗口结束后，关闭降级 异常数（分钟级）。

3⃣️异常数（分钟统计）：超过阈值时，触发降级；时间窗口结束后，关闭降级。   

5、热点key限流

5.1 概念

热点即经常访问的数据，很多时候我们希望统计或者限制某个热点数据中访问频次最高的TopN数据，并对其访问进行限流或者其它操作。

5.2 配置及效果

1⃣️@SentinelResource(value = "testHotKey")

异常打到了前台用户界面看到，不友好。

@GetMapping("/testHotKey")
@SentinelResource(value = "testHotKey")
public String testHotKey(@RequestParam(value = "p1",required = false) String p1,
                         @RequestParam(value = "p2",required = false) String p2)
{
    // int age = 10/0;
    return "------testHotKey";
}

2⃣️@SentinelResource(value = "testHotKey",blockHandler = "dealHandler_testHotKey")

方法testHotKey里面第一个参数只要QPS超过每秒1次，马上降级处理，调用dealHandler_testHotKey方法。

@GetMapping("/testHotKey")
@SentinelResource(value = "testHotKey",blockHandler = "deal_testHotKey")
public String testHotKey(@RequestParam(value = "p1",required = false) String p1,
                         @RequestParam(value = "p2",required = false) String p2)
{
    // int age = 10/0;
    return "------testHotKey";
}
public String deal_testHotKey (String p1, String p2, BlockException exception)
{
    return "------deal_testHotKey,o(╥﹏╥)o";  //sentinel系统默认的提示：Blocked by Sentinel (flow limiting)
}

3⃣️可视化配置

此时只要p1存在并不符合流控要求的时候就会触发限流，没有p1即使不符合流控要求也不会触发。

5.3 参数例外项

 1⃣️上述案例演示了第一个参数p1，当QPS超过1秒1次点击后马上被限流，我们期望p1参数当它是某个特殊值时，它的限流值和平时不一样，假如当p1的值等于5时，它的阈值可以达到200。

2⃣️可视化配置

⚠️热点参数的注意点，参数必须是基本类型或者String。

 3⃣️测试

http://localhost:8401/testHotKey?p1=5：阈值是200

http://localhost:8401/testHotKey?p1=3：阈值是1

6、@SentinelResource注解

6.1 在Controller中写兜底方法，如上述@SentinelResource(value = "testHotKey",blockHandler = "dealHandler_testHotKey")，会造成耦合度高，代码混乱。

6.1 自定义限流处理逻辑

1⃣️创建CustomerBlockHandler类用于自定义限流处理逻辑

public class CustomerBlockHandler
{
    public static CommonResult handlerException(BlockException exception)
    {
        return new CommonResult(4444,"按客戶自定义,global handlerException----1");
    }
    public static CommonResult handlerException2(BlockException exception)
    {
        return new CommonResult(4444,"按客戶自定义,global handlerException----2");
    }
}

2⃣️在@SentinelResource注解中标注blockHandlerClass和blockHandler。

@GetMapping("/rateLimit/customerBlockHandler")
@SentinelResource(value = "customerBlockHandler",
        blockHandlerClass = CustomerBlockHandler.class,
        blockHandler = "handlerException2")
public CommonResult customerBlockHandler()
{
    return new CommonResult(200,"按客戶自定义",new Payment(2020L,"serial003"));
}

3⃣️测试：http://localhost:8401/rateLimit/customerBlockHandler

4⃣️在Sentinel控制台配置，如果访问不符合控流策略就会调用配置好的handleException2方法。

7、服务熔断功能

7.1 Sentienl整合Ribbon系列

7.1.1 提供者

1⃣️新建cloudalibaba-provider-payment9003/9004

2⃣️Pom

<!--SpringCloud ailibaba nacos -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

3⃣️yml

4⃣️主启动：添加@EnableDiscoveryClient

5⃣️业务类

7.1.2 消费者

1⃣️新建cloudalibaba-consumer-nacos-order84

2⃣️POM

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<!--SpringCloud ailibaba sentinel -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>

3⃣️yml

server:
  port: 84


spring:
  application:
    name: nacos-order-consumer
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
    sentinel:
      transport:
        #配置Sentinel dashboard地址
        dashboard: localhost:8080
        #默认8719端口，假如被占用会自动从8719开始依次+1扫描,直至找到未被占用的端口
        port: 8719

#消费者将要去访问的微服务名称(注册成功进nacos的微服务提供者)
service-url:
  nacos-user-service: http://nacos-payment-provider

# 激活Sentinel对Feign的支持
feign:
  sentinel:
    enabled: true

4⃣️主启动：添加@EnableDiscoveryClient 和 @EnableFeignClients

5⃣️业务类ApplicationContextConfig

6⃣️业务类Controller

@RestController
@Slf4j
public class CircleBreakerController
{
    public static final String SERVICE_URL = "http://nacos-payment-provider";

    @Resource
    private RestTemplate restTemplate;

    @RequestMapping("/consumer/fallback/{id}")
    // @SentinelResource(value = "fallback") //没有配置
    // @SentinelResource(value = "fallback",fallback = "handlerFallback") //fallback只负责业务异常
    // @SentinelResource(value = "fallback",blockHandler = "blockHandler") //blockHandler只负责sentinel控制台配置违规
    // @SentinelResource(value = "fallback",fallback = "handlerFallback",blockHandler = "blockHandler")
    @SentinelResource(value = "fallback",fallback = "handlerFallback",blockHandler = "blockHandler",
            exceptionsToIgnore = {IllegalArgumentException.class})
    public CommonResult<Payment> fallback(@PathVariable Long id)
    {
        CommonResult<Payment> result = restTemplate.getForObject(SERVICE_URL + "/paymentSQL/"+id,CommonResult.class,id);

        if (id == 4) {
            throw new IllegalArgumentException ("IllegalArgumentException,非法参数异常....");
        }else if (result.getData() == null) {
            throw new NullPointerException ("NullPointerException,该ID没有对应记录,空指针异常");
        }

        return result;
    }

    //本例是fallback
    public CommonResult handlerFallback(@PathVariable  Long id,Throwable e) {
        Payment payment = new Payment(id,"null");
        return new CommonResult<>(444,"兜底异常handlerFallback,exception内容  "+e.getMessage(),payment);
    }

    //本例是blockHandler
    public CommonResult blockHandler(@PathVariable  Long id,BlockException blockException) {
        Payment payment = new Payment(id,"null");
        return new CommonResult<>(445,"blockHandler-sentinel限流,无此流水: blockException  "+blockException.getMessage(),payment);
    }
}

7⃣️测试：http://localhost:84/consumer/fallback/1

当id为1-3时正常打出信息，当id为4时报非法参数异常，为其他时报空指针异常。

fallback管运行异常，blockHandler管配置违规。

• 没有任何配置@SentinelResource(value = "fallback")：给客户error页面，不友好。
• 只配置fallback@SentinelResource(value = "fallback",fallback = "handlerFallback")：fallback只负责业务异常，即当id为4或者其他的时候，业务出现异常，会调用handlerFallback函数。
• 只配置blockHandler@SentinelResource(value = "fallback",blockHandler = "blockHandler") ：blockHandler只负责sentinel控制台配置违规，即当配置台配置一秒钟只能访问一次时，若一秒钟访问多次就会触发blockHandler方法，此时若出现业务问题会报错误页面给客户。
• fallback和blockHandler都配置@SentinelResource(value = "fallback",fallback = "handlerFallback",blockHandler = "blockHandler")：这时谁违规就调用对应的“兜底”方法，比如超过访问次数调用blockHandler，业务出现问题调用handlerFallback。当两者同时出现的时候，就会调用违规sentinel时调用的blockHandler方法。
• 忽略属性@SentinelResource(value = "fallback",fallback = "handlerFallback",blockHandler = "blockHandler",exceptionsToIgnore = {IllegalArgumentException.class}): 忽略IllegalArgumentException报错，当出现这个错误的时候，不会调用fallback方法，会直接显示error页面。

7.2 Sentienl整合Feign系列

1⃣️修改84模块，84消费者调用提供者9003。

2⃣️POM

<!--SpringCloud openfeign -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

3⃣️yml

# 激活Sentinel对Feign的支持
feign:
  sentinel:
    enabled: true

4⃣️主启动：@EnableFeignClients

5⃣️业务类

• Service：

@FeignClient(value = "nacos-payment-provider",fallback = PaymentFallbackService.class)
public interface PaymentService
{
    @GetMapping(value = "/paymentSQL/{id}")
    public CommonResult<Payment> paymentSQL(@PathVariable("id") Long id);
}

---

• fallback：

@Component
public class PaymentFallbackService implements PaymentService
{
    @Override
    public CommonResult<Payment> paymentSQL(Long id)
    {
        return new CommonResult<>(44444,"服务降级返回,---PaymentFallbackService",new Payment(id,"errorSerial"));
    }
}

• Controller：

@RestController
@Slf4j
public class CircleBreakerController
{
    //==================OpenFeign
    @Resource
    private PaymentService paymentService;

    @GetMapping(value = "/consumer/paymentSQL/{id}")
    public CommonResult<Payment> paymentSQL(@PathVariable("id") Long id)
    {
        return paymentService.paymentSQL(id);
    }
}

6⃣️测试：http://localhost:84/consumer/paymentSQL/1

8、规则持久化

1⃣️修改cloudalibaba-sentinel-service8401

2⃣️POM

<!--SpringCloud ailibaba nacos -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<!--SpringCloud ailibaba sentinel-datasource-nacos 后续做持久化用到-->
<dependency>
    <groupId>com.alibaba.csp</groupId>
    <artifactId>sentinel-datasource-nacos</artifactId>
</dependency>

3⃣️yml

cloud:
    nacos:
      discovery:
        server-addr: localhost:8848 #Nacos服务注册中心地址

4⃣️添加Nacos业务规则配置

说白了，就是将Sentinel配置用代码的形式配置到nacos里面，当下次在开启服务的时候可以自动读取从而做到持久化。