Sentinel 可以简单的分为 Sentinel 核心库和 Dashboard。核心库不依赖 Dashboard，但是结合 Dashboard 可以取得最好的效果。

这篇文章主要介绍 Sentinel 引入和规则配置等使用方法。我们说的资源，可以是任何东西，服务，服务里的方法，甚至是一段代码。

因为Sentinel控制台配置的规则是在内存中的，所以我们需要Nacos来存储规则实现持久化。

本文主要分为四个部分：

Sentinel代码方式示例效果
Sentinel控制台安装
Springboot项目接入Sentinel控制台配置规则
使用Nacos存储规则并实时更新

Sentinel代码方式示例效果

在讲解如何使用nacos存储规则之前，我们先来看下直接代码定义规则和资源的使用方式，这部分不是本文重点。

Sentinel的使用步骤大致可以分为三步：

引入依赖
定义资源
定义规则

我们先来看下Sentinel文档上的一段代码。

1.引入依赖

<dependency>
    <groupId>com.alibaba.csp</groupId>
    <artifactId>sentinel-core</artifactId>
    <version>1.8.0</version>
</dependency>

2.定义资源

public static void main(String[] args) {
    // 配置规则.
    initFlowRules();
    while (true) {
        // 1.5.0 版本开始可以直接利用 try-with-resources 特性，自动 exit entry
        try (Entry entry = SphU.entry("HelloWorld")) {
            // 被保护的逻辑
            System.out.println("hello world");
        } catch (BlockException ex) {
            // 处理被流控的逻辑
            System.out.println("blocked!");
        }
    }
}

在这里我们定义了一个“HelloWorld”的资源，不断打印hello world。

3.定义规则

private static void initFlowRules(){
    List<FlowRule> rules = new ArrayList<>(); //定义规则列表
    FlowRule rule = new FlowRule(); //定义一个规则
    rule.setResource("HelloWorld"); //什么资源应用此规则
    rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
    rule.setCount(20); //没秒只能20次请求
    rules.add(rule);//加入该规则
    FlowRuleManager.loadRules(rules); //载入规则列表
}

这里定义了资源“HelloWorld”每秒只能通过20个请求。

运行该main方法，可以看到控制台输出以下内容。

Sentinel代码方式示例效果

可以看到请求通过20次打印hello world后再请求会阻塞打印blocked!，等到下一秒才会继续打印hello world。

这是一个简单的示例用于说明下Sentinel的作用，下面我们会介绍Sentinel控制台的使用以及搭配Nacos存储规则并实时更新规则。

Sentinel控制台安装

Sentinel控制台提供web可视化页面配置规则，我们需要下载官方提供的jar包安装启动该服务。

1.jar包下载

可以在官网github上下载：https://github.com/alibaba/Sentinel/releases

拉到每个版本信息区块的最下方有jar文件的下载地址。

jar文件的下载地址

2.启动脚本：

注意根据下载的jar包修改文件名

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

启动Sentinel控制台

3.访问Sentinel控制台

地址和账号密码 http://localhost:8080 账号：sentinel 密码：sentinel

访问Sentinel控制台

控制台已经启动完成，可以看到左边首页下面显示了一个sentinel-dashboard的项目，项目包含了监控、链路、各种规则配置和机器列表等菜单可以管理该项目规则，如果有新项目连接到控制台，这里会出现新的项目菜单。

springboot项目接入Sentinel控制台配置规则

1.引入依赖

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

注意我这里没有写版本，因为我在父项目的pom文件中指定了阿里巴巴的依赖版本，子项目的相关依赖会自动寻找版本。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>Hoxton.SR8</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>2.2.3.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

2.配置yml

接下去我们可以在项目中连接到该控制台，这样项目里的资源就可以被控制台管理了。

spring:
  Application:
    name: sentinel
  cloud:
    sentinel:
      transport:
        port: 8719
        dashboard: localhost:8080  #启动本项目后需要请求一次才能向sentinel控制台注册

注意：启动项目后需要请求一次项目才能向sentinel控制台注册。

启动项目后我们请求一下项目随便一个接口，然后在控制台可以看到多了一个新项目的菜单了。

新项目的菜单

3.控制台配置项目资源规则

我在项目里写了一个简单的接口如下：

@RequestMapping("/")
public String test(){
    return "ok";
}

可以在控制台的簇点链路菜单看到这个接口资源。

簇点链路菜单

可以看到表格右边有四个按钮，可以对该资源进行流控、降级、热点、授权的配置。

流控
流量控制，可以在流控中设置主要三块内容：阈值类型+阈值、流控模式、流控效果。

流控

阈值类型+阈值：可以设置QPS的阈值，代表每秒最多允许请求多少次资源；可以设置线程数，代表可以同时运行的线程数量。
流控模式：有直接、关联、链路三种。
--直接：代表超过阈值直接限流
--关联：代表关联的资源达到阈值时也进行限流（比如支付接口不行了把下单接口也限流掉）。
--链路：代表当服务到达阈值时，所有使用该服务的服务也限流。
流控效果：有快速失败、Warm Up、排队等待三种。
--快速失败：直接限流操作。
--Warm Up：冷启动，需要配置预热时长，意思是当突然有大量请求时慢慢的放一些请求通过，预热时长过后恢复到正常限流状态，达到阈值时再进行限流。
--排队等待：让限流的请求排队等待系统空闲时再通过，需要配置超时时间，过了超时时间再拒绝请求。

降级
降级有慢调用比例、异常比例、异常数三种熔断策略。

降级

--慢调用比例：需要设置最大RT（最大的响应时间）和比例阈值（0.0至1.0之间），请求大于最大RT的判定为慢调用，当慢调用比例到达比例阈值时进行熔断降级。
--异常比例：需要设置一个比例阈值，当异常比例达到该阈值时进行熔断降级。
--异常数：需要设置一个异常数，达到该异常数时进行熔断降级。
降级需要设置一个熔断时长和最小请求数，代表熔断持续的时间，当大于最小请求数时降级规则才生效。

热点
热点即经常访问的数据，很多时候我们希望统计某个热点数据中访问频次最高的 Top K 数据，并对其访问进行限制。对请求中携带的参数进行判断是否是热点数据，是热点数据则根据规则限流。需要设置参数所有和阈值，参数所有从0开始代表请求的第几个参数是热点参数。

授权
授权其实就是黑白名单的设置，黑名单模式代表黑名单里的不允许访问，白名单模式代表白名单里的才允许访问。需要设置对应的应用名称。

4.示例配置

我们以流控操作来做个示例，我们在根请求接口的资源上配置一个流控规则。

示例配置

设置阈值类型为QPS，阈值为1，代表每秒只能通过1个请求。我们来看看效果。

浏览器请求接口，然后按F5不停刷新，可以看到每秒会出现一次返回一次正确信息，其他都会返回限流信息。

返回正确信息

返回限流信息

项目接入控制台部分就讲到这了，需要注意的是这里的控制台配置是存在内存中的，如果你的项目重新启动配置的规则就没了，所以我们需要一个可以持久化配置规则的地方，接下去我们介绍下Nacos来持久化存储Sentinel配置规则。

使用Nacos存储规则并实时更新

Sentinel提供了多种数据源的支持，包括Nacos、Zookeeper、文件数据源等。

使用Nacos存储需要先安装Nacos，可以看我的另外一篇Nacos安装教程文章。

1.引入Nacos依赖

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

2.配置Nacos数据源

安装完Nacos后我们首先在项目中配置Sentinel的数据源为Nacos。

spring:
  application:
    name: sentinel
  cloud:
    sentinel:
      transport:
        port: 8719
        dashboard: localhost:8080  #启动本项目后需要请求一次才能向sentinel控制台注册
      datasource: 
        ds2:
          nacos: 
            server-addr: 192.168.67.129:8848
            data-id: sentinel
            group-id: Sentinel:Demo
            data-type: json
            rule-type: flow

ds2是数据源名称，其他主要配置下：

Nacos的地址
data-id和group-id：等会需要在Nacos控制台新增一个同样的配置才能生效
data-type：配置规则数据类型
rule-type：flow代表流控类型

3.在Nacos控制台配置规则内容

我们在Nacos控制台的配置列表新增一个配置。

新增一个配置

配置内容部分如下：

[
    {
        "resource": "/",
        "limitApp": "default",
        "grade": 1,
        "count": 2,
        "strategy": 0,
        "controlBehavior": 0,
        "clusterMode": false
    }
]

resource：资源名，资源名是限流规则的作用对象

count：限流阈值grade：限流阈值类型，QPS 模式（1）或并发线程数模式（0）

limitApp：流控针对的调用来源

strategy：调用关系限流策略：直接、链路、关联

controlBehavior：流控效果（直接拒绝/WarmUp/匀速+排队等待），不支持按调用关系限流

clusterMode：是否集群限流

4.效果

启动项目，配置好Nacos后，我们可以直接在Sentinel控制台看到nacos的配置已经同步到Sentinel控制台了，并且规则已经生效了，以后该规则只需要在Naocs配置规则就能实时生效了。

Nacos规则同步到Sentinel控制台

需要注意的是，目前只支持Nacos规则同步到Sentinel控制台，不支持在Sentinel控制台配置规则同步到Nacos。

好了，今天的内容就讲到这里了，希望本文对你有所帮助。

Sentinel+Nacos实现资源流控、降级、热点、授权

Sentinel代码方式示例效果

Sentinel控制台安装

springboot项目接入Sentinel控制台配置规则

使用Nacos存储规则并实时更新