Sentinel 使用详解、熔断降级实例

文章目录

1、sentinel的下载和安装

sentinel下载地址：https://github.com/alibaba/Sentinel/releases
1.7.1下载地址： https://github.com/alibaba/Sentinel/releases/download/1.7.1/sentinel-dashboard-1.7.1.jar

Windows启动Sentinel

java -jar sentinel-dashboard-1.7.1.jar

访问地址：

http://localhost:8080 //默认端口为：8080，用户名和密码sentinel/sentinel

在这里插入图片描述
Windows启动下如果8080端口被占用，还可以使用其他端口，需要指定一下，如：

java -Dserver.port=8070 -Dcsp.sentinel.dashboard.server=localhost:8070 -Dproject.name=sentinel-dashboard -jar sentinel-dashboard-1.7.1.jar

Sentinel Linux后台启动：

nohup java -Dserver.port=8070 -Dcsp.sentinel.dashboard.server=localhost:8070 -Dproject.name=sentinel-dashboard -jar /java/sentinel-dashboard-1.7.1.jar &

Sentinel 指定日志目录启动：

java -Dserver.port=8070 -Dcsp.sentinel.dashboard.server=localhost:8070 -Dproject.name=sentinel-dashboard -Dcsp.sentinel.log.dir=C:\logs\sentinel-dashboard -jar sentinel-dashboard-1.7.1.jar

启动（是否注册Sentinel自己）：
不注册Sentinel自己

java -Dserver.port=8070 -Dcsp.sentinel.log.dir=C:\logs\sentinel-dashboard -jar sentinel-dashboard-1.7.1.jar

注册Sentinel自己

java -Dserver.port=8070 -Dcsp.sentinel.dashboard.server=localhost:8070 -Dproject.name=sentinel-dashboard -Dcsp.sentinel.log.dir=C:\logs\sentinel-dashboard -jar sentinel-dashboard-1.7.1.jar

访问地址：

http://localhost:8070/

其他配置项参考：

-Dserver.port=8080：用于指定 Sentinel 控制台端口为 8080，如若8080端口冲突，可使用 -Dserver.port=新端口 进行设置。。
-Dcsp.sentinel.dashboard.server=localhost:8080：指定控制台地址和端口，会自动向该地址发送心跳包。地址格式为：hostIp:port，l配置成ocalhost:8080即监控自己
-Dproject.name=sentinel-dashboard：指定Sentinel控制台程序显示的名称
-Dcsp.sentinel.log.dir：指定Sentinel 日志文件目录，默认是：${user.home}/logs/csp/
-Dcsp.sentinel.api.port=xxxx：本地的 Sentinel 客户端端口（可选，默认是 8719，有冲突会尝试向后探测）。若启动多个应用，则需要通过 -Dcsp.sentinel.api.port=xxxx 指定客户端监控 API 的端口（默认是 8719）。
-Dcsp.sentinel.app.type=1：从 1.6.3 版本开始，控制台支持网关流控规则管理。启动参数以将您的服务标记为 API Gateway，在接入控制台时您的服务会自动注册为网关类型，然后您即可在控制台配置网关规则和 API 分组。

用户可以通过如下参数进行鉴权配置：
-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 分钟；

2、Sentinel规则管理及推送

一般来说，规则的推送有下面三种模式:

推送模式说明优点缺点

1、原始模式

API 将规则推送至客户端并直接更新到内存中，扩展写数据源（WritableDataSource）
优点
简单，无任何依赖

缺点
不保证一致性；规则保存在内存中，重启即消失。严重不建议用于生产环境

2、Pull 模式

扩展写数据源（WritableDataSource），客户端主动向某个规则管理中心定期轮询拉取规则，这个规则中心可以是 RDBMS、文件等
优点
简单，无任何依赖；规则持久化不保证一致性；

缺点
实时性不保证，拉取过于频繁也可能会有性能问题。

3、Push 模式

扩展读数据源（ReadableDataSource），规则中心统一推送，客户端通过注册监听器的方式时刻监听变化，比如使用 Nacos、Zookeeper 等配置中心。这种方式有更好的实时性和一致性保证。生产环境下一般采用 push 模式的数据源。
优点
规则持久化；一致性；快速

缺点
引入第三方依赖

3、整合项目配置Sentinel，在Sentinel dashboard实现监控

1.如果是在spring cloud Alibaba 微服务架构的生态下，则引入一个包即可：

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

如果在其他生态下，想要使用注解来定义资源需要引入专属的AOP 包：

<!-- 开启注解 -->
<dependency>
	<groupId>com.alibaba.csp</groupId>
	<artifactId>sentinel-annotation-aspectj</artifactId>
</dependency>

配置信息：

server:
  port: 8000
spring:
  application:
    name: datacenter
  datasource:
    username: root
    password: root
    url: jdbc:mysql://localhost:3306/elq_master?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
    driver-class-name: com.mysql.cj.jdbc.Driver
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
    #sentinel 相关配置
    sentinel:
      transport:
        #默认是：localhost:8080
        dashboard: localhost:8080
  redis:
    host: 192.168.56.10
    port: 6379
#
#feign:
#  sentinel:
#    enabled: true
#  jackson:
#    date-format: yyyy-MM-dd HH:mm:ss
mybatis-plus:
  mapper-locations: classpath:/mapper/**/*.xml

4、实例

1、第一个实例（抛出异常的方式定义资源）：

package com.elq.product.app;

import com.alibaba.csp.sentinel.Entry;
import com.alibaba.csp.sentinel.SphU;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.PostConstruct;
import java.util.ArrayList;
import java.util.List;

@RestController
@RequestMapping("/sentinel")
public class SentinelTest {
    
    

    @RequestMapping("/helloWord")
    public String helloWord(){
    
    
        //使用先流规则 helloWord
        try(Entry entry= SphU.entry("helloWord")){
    
    
            return "正常业务~~";
        }catch (Exception e){
    
    
            e.printStackTrace();
            return "被限流了~~系统繁忙~~~~";
        }
    }

    /**
     * 定义先流规则
     * PostConstruct  构造方法执行完成之后执行，定义和加载先流规则
     */
    @PostConstruct
    public void initFloRules(){
    
    
        List<FlowRule> rules=new ArrayList<>();//定义限流规则集合
        FlowRule flowRule = new FlowRule();//定义限流规则
        flowRule.setResource("helloWord");//定义限流资源
        flowRule.setGrade(RuleConstant.FLOW_GRADE_QPS);//定义限流类型为 QPS
        flowRule.setCount(2);//限流的阈值（如这里我们上面类型为QPS ，所以这里的2表示每秒2次）
        rules.add(flowRule);//添加到规则集合中
        FlowRuleManager.loadRules(rules);//添加规则集合
    }

}

快速刷新资源地址：http://localhost:8000/sentinel/helloWord
在这里插入图片描述

2、第二个实例（布尔值判断方式定义资源）

package com.elq.product.app;

import com.alibaba.csp.sentinel.SphO;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/sentinel")
public class SnetinelTest1 {
    
    

    @RequestMapping("/helloword1")
    public String helloword1(){
    
    
        /**
         * 返回布尔值资源
         */
        if(SphO.entry("helloword1")){
    
     //判断资源是否可用
            try{
    
    
                return "正常业务~~";
            }finally {
    
    
                SphO.exit();//必须与 SphO.entry 成对出现！
            }
        }else{
    
    
            return "资源被限制~~";
        }
    }
}

sentinel 资源限流配置：
在这里插入图片描述
快速刷新：http://localhost:8000/sentinel/helloword1

3、第三个实例，也是最常用的（注解方式定义资源）

首先，想要使用注解@SentinelResource，需要引入切面的依赖：

<!-- 开启注解 -->
<dependency>
	<groupId>com.alibaba.csp</groupId>
	<artifactId>sentinel-annotation-aspectj</artifactId>
</dependency>

第二步，配置类：
这里有两种情况，如果你使用的框架集成了 spring cloud Alibaba ,则可以直接来使用 @SentinelResource 注解。
如果没有集成 spring cloud Alibaba ，则需要初始化配置类：

@Configuration
public class SentinelAspectjConfiguration {
    
    
    @Bean
    public SentinelResourceAspect sentinelResourceAspect(){
    
    
        return new SentinelResourceAspect();
    }
}

注解定义资源实例：

package com.elq.product.app;

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.elq.product.service.IndexService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/sentinel")
public class IndexController {
    
    
    @Autowired
    IndexService indexService;

    @SentinelResource(value="index",blockHandler = "indexError")
    @RequestMapping("/index")
    public String index(){
    
    
        String indexList = indexService.getIndexList();
        return indexList;
    }

    public String indexError(BlockException e){
    
    
        return "限流！";
    }
}

添加流控规则：
在这里插入图片描述
快速刷新：http://localhost:8000/sentinel/index

则触发限流如下：
在这里插入图片描述

5、sentinel 配置持久化到nacos

首先，在微服务项目中引入依赖：

<dependency>
  <groupId>com.alibaba.csp</groupId>
  <artifactId>sentinel-datasource-nacos</artifactId>
</dependency>

配置：

server:
  port: 8000
spring:
  application:
    name: datacenter
  datasource:
    username: root
    password: root
    url: jdbc:mysql://localhost:3306/elq_master?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
    driver-class-name: com.mysql.cj.jdbc.Driver
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
        
    #sentinel持久化配置项***********************
    sentinel:
      transport:
        #默认是：localhost:8080
        dashboard: localhost:8080
      datasource:
        ds:
          nacos:
            server-addr: localhost:8848
            data-id: sentinel-datacenter
            group-id: DEFAULT_GROUP #默认分株
            data-type: json #配置类型为json
            rule-type: flow #限流
  #sentinel持久化配置项***********************
  
  redis:
    host: 192.168.56.10
    port: 6379
#
#feign:
#  sentinel:
#    enabled: true
#  jackson:
#    date-format: yyyy-MM-dd HH:mm:ss
mybatis-plus:
  mapper-locations: classpath:/mapper/**/*.xml

nacos 中保存配置项：
在这里插入图片描述

[
    {
    
    
        "resource": "index",
        "limitApp": "default",
        "grade": 0,# 0 是QPS  ，1 是线程
        "count": 2,# 阈值数
        "strategy": 0,
        "controlBehavior": 0,
        "clusterMode": false
    }
]

这样我们重启服务后，再开看sentinel 客户端，就可以看见资源index 被持久化保存了：
在这里插入图片描述