Sentinel: 分布式系统的流量防卫兵

1、快速上手

Sentinel 是什么？

随着微服务的流行，服务和服务之间的稳定性变得越来越重要。Sentinel 以流量为切入点，从流量控制、熔断降级、系统负载保护等多个维度保护服务的稳定性。

Sentinel 具有以下特征:

丰富的应用场景：Sentinel 承接了阿里巴巴近10 年的双十一大促流量的核心场景，例如秒杀，即突发流量控制在系统容量可以承受的范围；消息削峰填谷；实时熔断下游不可用应用，等等。
完备的监控功能： Sentinel 同时提供最实时的监控功能，您可以在控制台中看到接入应用的单台机器秒级数据，甚至500 台以下规模的集群的汇总运行情况。
简单易用的扩展点： Sentinel 提供简单易用的扩展点，您可以通过实现扩展点，快速的定制逻辑。例如定制规则管理，适配数据源等。

Sentinel 分为两个部分:

核心库（Java 客户端）不依赖任何框架/库，能够运行于所有Java 运行时环境，同时对Dubbo / Spring Cloud 等框架也有较好的支持。
控制台（Dashboard）基于Spring Boot 开发，打包后可以直接运行，不需要额外的Tomcat 等应用容器。

详细文档 请移步 Wiki，查阅详细的文档、示例以及使用说明。

Please refer to README for README in English。

与Sentinel 相关的生态（包括社区用户实现的扩展、整合、示例以及文章）可以参见Awesome Sentinel，欢迎补充！

如果您正在使用Sentinel，欢迎在这里留言告诉我们您的使用场景，以便我们更好地去改进。

Quick Start 下面的例子将展示应用如何三步接入Sentinel。同时，Sentinel 也提供一个所见即所得的控制台，可以实时监控资源以及管理规则。

在应用中引入Sentinel Jar 包注意: Sentinel JAR 包仅支持Java 6 或者以上版本。如果应用使用pom 工程，则在pom.xml 文件中加入以下代码即可：

<dependency>
	<groupId>com.alibaba.csp</groupId>
	<artifactId>sentinel-core</artifactId>
	<version>x.y.z</version>
</dependency>

如果您未使用依赖管理工具，请到Maven Center Repository 直接下载JAR 包。

定义资源接下来，把需要控制流量的代码用Sentinel API SphU.entry(“HelloWorld”) 和entry.exit() 包围起来即可。在下面的例子中，

我们将System.out.println(“hello wolrd”); 作为资源，用API 包围起来。参考代码如下:

    public static void main(String[] args) {
        initFlowRules();
        while (true) {
            Entry entry = null;
            try {
                entry = SphU.entry("HelloWorld");
                System.out.println("hello world");
            } catch (BlockException e1) {
                System.out.println("block!");
            } finally {
                if (entry != null) {
                    entry.exit();
                }
            }
        }
    }

完成以上两步后，代码端的改造就完成了。

定义规则接下来，通过规则来指定允许该资源通过的请求次数，例如下面的代码定义了资源"hello world"每秒最多只能通过20 个请求。

    private static void initFlowRules(){
        List<FlowRule> rules = new ArrayList<FlowRule>();
        FlowRule rule = new FlowRule();
        rule.setResource("HelloWorld");
        rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
        // Set limit QPS to 20.
        rule.setCount(20);
        rules.add(rule);
        FlowRuleManager.loadRules(rules);
    }

完成上面3 步，Sentinel 就能够正常工作了。

检查效果 Demo 运行之后，我们可以在日志~/logs/csp/metrics.log.xXXX 里看到下面的输出:

|--timestamp-|------date time----|--resource-|p |block|s |e|rt
1529998904000|2018-06-26 15:41:44|hello world|20|0 |20|0|0
1529998905000|2018-06-26 15:41:45|hello world|20|5579 |20|0|728
1529998906000|2018-06-26 15:41:46|hello world|20|15698|20|0|0
1529998907000|2018-06-26 15:41:47|hello world|20|19262|20|0|0
1529998908000|2018-06-26 15:41:48|hello world|20|19502|20|0|0
1529998909000|2018-06-26 15:41:49|hello world|20|18386|20|0|0

其中p 代表通过的请求, block 代表被阻止的请求, s 代表成功通过Sentinel 的请求个数, e 代表用户自定义的异常, rt 代表平均响应时长。

可以看到，这个程序每秒稳定输出"hello world" 20 次，和规则中预先设定的阈值是一样的。

启动Sentinel 控制台 Sentinel 同时提供控制台，可以实时监控各个资源的运行情况，并且可以实时地修改限流规则。

快速学习-Sentinel: 分布式系统的流量防卫兵

Sentinel: 分布式系统的流量防卫兵

1、快速上手

Sentinel 是什么？

Sentinel 具有以下特征:

Sentinel 分为两个部分: