Sentinel之控制台dashboard

一、源码结构

目录结构

1、pom.xml

首先我们看下pom.xml,这也是我看源码的习惯，看完目录结构再看pom文件。
通过pom文件，可以了解到该项目：

基于Spring boot快速开发的，且spring boot版本为2.0.5.RELEASE
基于JDK8编译开发的
引用了sentinel-web-servlet、sentinel-transport-simple-http等依赖，sentinel-web-servlet是一个sentinel的适配器，因此该项目可能也可以进行限流降级控制

2、client

主要可以看到SentinelApiClient，这个类的功能是通过http获取引用的监控指标以及设置限流、降级、熔断的规则并发送到对应的应用中。
可以看到大致有以下方法：
fetch拉取方法

fetchResourceOfMachine：获取应用的资源
fetchFlowRuleOfMachine：获取应用限流规则
fetchDegradeRuleOfMachine：获取应用降级规则
fetchSystemRuleOfMachine：获取应用的系统保护规则
fetchParamFlowRulesOfMachine：获取热点参数限流参数
fetchAuthorityRulesOfMachine：获取机器的授权规则

set设置方法

setFlowRuleOfMachine：设置限流规则
setDegradeRuleOfMachine：设置降级规则
setSystemRuleOfMachine：设置系统规则
setAuthorityRuleOfMachine：设置授权规则
setParamFlowRuleOfMachine：设置热点参数规则

然后通过httpGetContent方法调用。
这里只是简单介绍了有哪些调用方法，具体调用调用方法会请求到哪，其实会到sentinel-transpor模块中，其中有个CommandHandler接口，通过SPI的形式实现了很多Handler处理器。具体调用链后续文章会讲解。

3、config

只有一个文件WebConfig：

继承了WebMvcConfigurerAdapter，用来设置web的资源目录、控制器、过滤器等
增加@Configuration，表示该项目启动时加载
增加了CommonFilter，用设置可以限流、降级的资源，可以看到设置资源为/*

4、datasource.entity

不用说，这里放的是实体对象地方，主要有服务实体、指标实体、各种监控规则实体等

5、discovery

这个包下主要是sentinel客户端信息，也就是使用sentinel框架的客户端信息

主要可以看下SimpleMachineDiscovery这个方法，应用的信息会被保存在apps这个Map中。
dashboard应用在启动后，客户端会调用/registry/machine（view包下的MachineRegistryController类）这个接口把服务信息写到Map中
dashborad应用获取应用就是从map中拿的

6、domain

只有一个类ResourceTreeNode，就是监控指标的对象实体，主要包括qps，异常信息等信息。

7、metirc

只有个MetricFetcher类，表示获取应用的统计信息，也就是拉取实时监控信息

启动是通过构造函数调用start方法进行定时拉取所有客户端指标信息。执行周期是10+n1（秒）*
fetchService线程池用来拉取该APP所有机器的metric
fetchWorker工作线程池用来调用http获取实时指标信息
最后通过writeMetric方法调用的MetricsRepository的saveAll方法保存所有指标信息

8、repository

主要是metric和rule的信息保存

metric的信息来源已经说过了，通过InMemoryMetricsRepository的save方法可以看到客户端实时指标信息在dashboard中保留5分钟
rule包下的类主要是获取下一个为使用的id

9、util

RuleUtils用来解析Rule的JSON对象
VersionUtils解析Sentinel版本

10 view

这个包下就是一些资源控制器了，主要是前端提供接口

AppController：应用列表控制器
AuthorityRuleController：授权规则控制器
DegradeController：降级控制器
FlowController：降流控制器
MachineRegistryController：应用注册控制，这个控制器比较特殊并不是给前端的，而是客户端注册使用的
MetricController ：实时监控控制器
ParamFlowRuleController：热点参数规则
ResourceController ：机器资源
SystemController ：系统规则控制

11、DashboardApplication

应用启动类，可以直接启动，默认端口号8080

12、resources

资源配置文件：application.properties

13、webapp

这个就是前端资源目录，前端使用的是angularjs开发的，二次开发需要搭建前端环境，可以见目录下的README_zh.md文件。

二、分析

1、dashborad模块代码比较简单，主要数据都是从内存获取的
2、在面向生产使用时，还是缺少一些内容的，比如权限控制，数据持久化，登录功能等
3、前端使用angularjs开发，对未接触过人来说，二次开发前端页面难度较大

三、我的小结

1、sentinel系列通过先分享dashboard模块，主要考虑在一个可视化的界面中设置规则，方便后续模块的调试跟踪
2、大致分析了dashboard每个包下的内容
3、针对面向生产时，面对dashbord的痛点。下篇文章会介绍如何扩展一个生产使用的控制台传送门, 主要扩展以下功能：

A: 登录功能、设置统一拦截器
B: 系统权限功能，就是用户只能看到用户权限的系统
C: 核心数据持久化

4、以上内容，若有不当之处，谢谢指正。