THIS IS A TEST INSTANCE ONLY! REPOSITORIES CAN BE DELETED AT ANY TIME!

把流量作为切入点,从流量控制、熔断降级、系统负载保护等多个维度保护服务的稳定性。
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
jiajiangnan 2c12b07534
dashboard: Fix the incorrect function name in ParamFlowRuleEntity (#2173)
1 week ago
.circleci Disable spell checking in Circle CI lint temporary (need more config later) 2 years ago
.github Add GitHub Actions CI workflow (#1992) 2 months ago
doc Polish sentinel-opensource-eco-landscape-en.png 11 months ago
sentinel-adapter test: Improve exception checking in SentinelAnnotationQuarkusAdapterTest (#2116) 1 month ago
sentinel-benchmark Bump version to 1.8.2-SNAPSHOT 3 months ago
sentinel-cluster dependency: Upgrade Netty to 4.1.48.Final in sentinel-cluster pom (#2015) 2 months ago
sentinel-core Support config from system env in SentinelConfig and polish TransportConfig (#2154) 2 weeks ago
sentinel-dashboard dashboard: Fix the incorrect function name in ParamFlowRuleEntity (#2173) 1 week ago
sentinel-demo demo: Improve remoteAddress and groupId of sentinel-demo-nacos-datasource (#2134) 3 weeks ago
sentinel-extension Support Redis cluster mode in Redis data-source extension (#1751) 2 months ago
sentinel-logging Bump version to 1.8.2-SNAPSHOT 3 months ago
sentinel-transport Support config from system env in SentinelConfig and polish TransportConfig (#2154) 2 weeks ago
.codecov.yml Update codecov conf file 2 years ago
.gitignore Fix the parsing issue in large post request for sentinel-transport-simple-http (#1255) 1 year ago
.travis.yml CI: Polish dependencies for ARM64 and add ARM64 job to Travis CI (#1765) 6 months ago
CODE_OF_CONDUCT.md Update document to meet Markdown lint 2 years ago
CONTRIBUTING.md Update document to meet Markdown lint 2 years ago
LICENSE Welcome to the world, Sentinel 3 years ago
README.md doc: Update README.md and add QualityGate code maintainability badge (#2144) 2 weeks ago
pom.xml Add sentinel-transport-spring-mvc module (#1957) 2 months ago

README.md

Sentinel Logo

Sentinel: The Sentinel of Your Microservices

Travis Build Status Codecov Maven Central License Gitter Maintainability

Introduction

As distributed systems become increasingly popular, the reliability between services is becoming more important than ever before. Sentinel takes "flow" as breakthrough point, and works on multiple fields including flow control, traffic shaping, circuit breaking and system adaptive protection, to guarantee reliability and resilience for microservices.

Sentinel has the following features:

  • Rich applicable scenarios: Sentinel has been wildly used in Alibaba, and has covered almost all the core-scenarios in Double-11 (11.11) Shopping Festivals in the past 10 years, such as “Second Kill” which needs to limit burst flow traffic to meet the system capacity, message peak clipping and valley fills, circuit breaking for unreliable downstream services, cluster flow control, etc.
  • Real-time monitoring: Sentinel also provides real-time monitoring ability. You can see the runtime information of a single machine in real-time, and the aggregated runtime info of a cluster with less than 500 nodes.
  • Widespread open-source ecosystem: Sentinel provides out-of-box integrations with commonly-used frameworks and libraries such as Spring Cloud, Dubbo and gRPC. You can easily use Sentinel by simply add the adapter dependency to your services.
  • Polyglot support: Sentinel has provided native support for Java, Go and C++.
  • Various SPI extensions: Sentinel provides easy-to-use SPI extension interfaces that allow you to quickly customize your logic, for example, custom rule management, adapting data sources, and so on.

Features overview:

features-of-sentinel

Documentation

See the Sentinel for the document website.

See the 中文文档 for document in Chinese.

See the Wiki for full documentation, examples, blog posts, operational details and other information.

Sentinel provides integration modules for various open-source frameworks (e.g. Spring Cloud, Apache Dubbo, gRPC, Spring WebFlux, Reactor) and service mesh. You can refer to the document for more information.

If you are using Sentinel, please leave a comment here to tell us your scenario to make Sentinel better. It's also encouraged to add the link of your blog post, tutorial, demo or customized components to Awesome Sentinel.

Ecosystem Landscape

ecosystem-landscape

Quick Start

Below is a simple demo that guides new users to use Sentinel in just 3 steps. It also shows how to monitor this demo using the dashboard.

1. Add Dependency

Note: Sentinel requires JDK 1.8 or later.

If you're using Maven, just add the following dependency in pom.xml.

<!-- replace here with the latest version -->
<dependency>
    <groupId>com.alibaba.csp</groupId>
    <artifactId>sentinel-core</artifactId>
    <version>1.8.1</version>
</dependency>

If not, you can download JAR in Maven Center Repository.

2. Define Resource

Wrap your code snippet via Sentinel API: SphU.entry(resourceName). In below example, it is System.out.println("hello world");:

try (Entry entry = SphU.entry("HelloWorld")) {
    // Your business logic here.
    System.out.println("hello world");
} catch (BlockException e) {
    // Handle rejected request.
    e.printStackTrace();
}
// try-with-resources auto exit

So far the code modification is done. We've also provided annotation support module to define resource easier.

3. Define Rules

If we want to limit the access times of the resource, we can set rules to the resource. The following code defines a rule that limits access to the resource to 20 times per second at the maximum.

List<FlowRule> rules = new ArrayList<>();
FlowRule rule = new FlowRule();
rule.setResource("HelloWorld");
// set limit qps to 20
rule.setCount(20);
rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
rules.add(rule);
FlowRuleManager.loadRules(rules);

For more information, please refer to How To Use.

4. Check the Result

After running the demo for a while, you can see the following records in ~/logs/csp/${appName}-metrics.log.{date} (When using the default DateFileLogHandler).

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

p stands for incoming request, block for blocked by rules, s for success handled by Sentinel, e for exception count, rt for average response time (ms), occupied stands for occupiedPassQps since 1.5.0 which enable us booking more than 1 shot when entering.

This shows that the demo can print "hello world" 20 times per second.

More examples and information can be found in the How To Use section.

The working principles of Sentinel can be found in How it works section.

Samples can be found in the sentinel-demo module.

5. Start Dashboard

Note: Java 8 is required for building or running the dashboard.

Sentinel also provides a simple dashboard application, on which you can monitor the clients and configure the rules in real time.

dashboard

For details please refer to Dashboard.

Trouble Shooting and Logs

Sentinel will generate logs for troubleshooting and real-time monitoring. All the information can be found in logs.

Bugs and Feedback

For bug report, questions and discussions please submit GitHub Issues.

Contact us via Gitter or Email.

Contributing

Contributions are always welcomed! Please refer to CONTRIBUTING for detailed guidelines.

You can start with the issues labeled with good first issue.

Credits

Thanks Guava, which provides some inspiration on rate limiting.

And thanks for all contributors of Sentinel!

Who is using

These are only part of the companies using Sentinel, for reference only. If you are using Sentinel, please add your company here to tell us your scenario to make Sentinel better :)

Alibaba Group AntFin Taiping Renshou 拼多多 爱奇艺 Shunfeng Technology 二维火 Mandao 文轩在线 客如云 亲宝宝 杭州光云科技 金汇金融 闪电购