<img src="https://user-images.githubusercontent.com/9434884/43697219-3cb4ef3a-9975-11e8-9a9c-73f4f537442d.png" alt="Sentinel Logo" width="50%">
# Sentinel: The Sentinel of Your Microservices
[![Travis Build Status](https://travis-ci.org/alibaba/Sentinel.svg?branch=master)](https://travis-ci.org/alibaba/Sentinel)
[![Codecov](https://codecov.io/gh/alibaba/Sentinel/branch/master/graph/badge.svg)](https://codecov.io/gh/alibaba/Sentinel)
[![Maven Central](https://img.shields.io/maven-central/v/com.alibaba.csp/sentinel-core.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:com.alibaba.csp%20AND%20a:sentinel-core)
[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
[![Gitter](https://badges.gitter.im/alibaba/Sentinel.svg)](https://gitter.im/alibaba/Sentinel)
## 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](https://github.com/alibaba/sentinel-golang) and [C++](https://github.com/alibaba/sentinel-cpp).
- **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](./doc/image/sentinel-features-overview-en.png)
## Documentation
See the [中文文档](https://github.com/alibaba/Sentinel/wiki/%E4%BB%8B%E7%BB%8D) for document in Chinese.
See the [Wiki](https://github.com/alibaba/Sentinel/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](https://github.com/alibaba/Sentinel/wiki/Adapters-to-Popular-Framework) for more information.
If you are using Sentinel, please [**leave a comment here**](https://github.com/alibaba/Sentinel/issues/18) 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**](./doc/awesome-sentinel.md).
## Ecosystem Landscape
![ecosystem-landscape](./doc/image/sentinel-opensource-eco-landscape-en.png)
## 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 Core requires Java 7 or later.
If your're using Maven, just add the following dependency in `pom.xml`.
```xml
<!-- replace here with the latest version -->
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-core</artifactId>
<version>1.8.0</version>
</dependency>
```
If not, you can download JAR in [Maven Center Repository](https://mvnrepository.com/artifact/com.alibaba.csp/sentinel-core).
### 2. Define Resource
Wrap your code snippet via Sentinel API: `SphU.entry(resourceName)`.
In below example, it is `System.out.println("hello world");`:
```java
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](https://github.com/alibaba/Sentinel/blob/master/sentinel-extension/sentinel-annotation-aspectj/README.md) 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.
```java
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](https://github.com/alibaba/Sentinel/wiki/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, success 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](https://github.com/alibaba/Sentinel/wiki/How-to-Use) section.
The working principles of Sentinel can be found in [How it works](https://github.com/alibaba/Sentinel/wiki/How-it-works) section.
Samples can be found in the [sentinel-demo](https://github.com/alibaba/Sentinel/tree/master/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](https://user-images.githubusercontent.com/9434884/55449295-84866d80-55fd-11e9-94e5-d3441f4a2b63.png)
For details please refer to [Dashboard](https://github.com/alibaba/Sentinel/wiki/Dashboard).
## Trouble Shooting and Logs
Sentinel will generate logs for troubleshooting and real-time monitoring.
All the information can be found in [logs](https://github.com/alibaba/Sentinel/wiki/Logs).
## Bugs and Feedback
For bug report, questions and discussions please submit [GitHub Issues](https://github.com/alibaba/sentinel/issues).
Contact us via [Gitter](https://gitter.im/alibaba/Sentinel) or [Email](mailto:sentinel@linux.alibaba.com).
## Contributing
Contributions are always welcomed! Please refer to [CONTRIBUTING](./CONTRIBUTING.md) for detailed guidelines.
You can start with the issues labeled with [`good first issue`](https://github.com/alibaba/Sentinel/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).
## Credits
Thanks [Guava](https://github.co
没有合适的资源?快使用搜索试试~ 我知道了~
sentinel 1.8 规则持久化版(源码)
共4089个文件
class:1362个
java:1081个
prefs:231个
3星 · 超过75%的资源 需积分: 47 47 下载量 85 浏览量
2020-11-04
14:56:03
上传
评论
收藏 49.24MB ZIP 举报
温馨提示
版本:1.8 内容:已经对源码进行改造,使用push方式进行规则持久化 持久化的规则有:授权规则、降级规则、流控规则、热点规则、系统规则 其他说明:默认请求的nacos地址是127.0.0.1:8848 注意!注意!注意!:这个是源码,需要自己打包,如果需要打包好的请前往https://download.csdn.net/download/u011684553/12888657 为什么分开上传? 因为有些人需要源码二次改造,看了CSDN后台并没有发现可以重新上传资源的功能,只能再传一次。
资源详情
资源评论
资源推荐
收起资源包目录
sentinel 1.8 规则持久化版(源码) (4089个子文件)
com.alibaba.csp.sentinel.adapter.gateway.common.api.ApiDefinitionChangeObserver 93B
com.alibaba.csp.sentinel.adapter.gateway.common.api.ApiDefinitionChangeObserver 93B
com.alibaba.csp.sentinel.adapter.gateway.common.api.ApiDefinitionChangeObserver 82B
com.alibaba.csp.sentinel.adapter.gateway.common.api.ApiDefinitionChangeObserver 82B
com.alibaba.csp.sentinel.adapter.gateway.common.api.ApiDefinitionChangeObserver 81B
com.alibaba.csp.sentinel.adapter.gateway.common.api.ApiDefinitionChangeObserver 81B
SentinelAnnotationQuarkusAdapterProcessor.bsc 106B
SentinelJaxRsQuarkusAdapterProcessor.bsc 96B
SentinelNativeImageProcessor.bsc 83B
SentinelApiClient.class 45KB
ClusterAssignServiceImpl.class 21KB
MetricFetcher.class 18KB
ClusterConfigService.class 18KB
ParamFlowRuleController.class 15KB
GatewayFlowRuleControllerTest.class 14KB
SentinelDubboConsumerFilterTest.class 14KB
GatewayApiControllerTest.class 14KB
GatewayFlowRuleController.class 13KB
ClusterParamFlowRuleManager.class 13KB
ClusterConfigController.class 13KB
DemoClusterInitFunc.class 13KB
ClusterFlowRuleManager.class 13KB
FlowControllerV1.class 13KB
SentinelRuleLocator.class 13KB
ClusterServerConfigManager.class 12KB
GatewayApiController.class 12KB
HttpEventTask.class 12KB
HttpServerHandler.class 12KB
ClusterEntityUtils.class 12KB
AbstractSentinelInterceptorSupport.class 12KB
GatewayParamParserTest.class 12KB
CtSphTest.class 12KB
AbstractSentinelAspectSupport.class 12KB
ClientFilterTest.class 11KB
SystemController.class 11KB
DegradeController.class 11KB
ParamFlowRuleUtil.class 11KB
SentinelWebFluxIntegrationTest.class 11KB
ZookeeperDataSource.class 11KB
CtSph.class 10KB
SpringCloudGatewayParamParserTest.class 10KB
FlowControllerV2.class 10KB
SentinelZuulInboundFilter.class 10KB
GatewayFlowRuleEntity.class 10KB
ArrayMetric.class 10KB
AuthorityRuleController.class 10KB
ZookeeperDataSourceTest.class 10KB
MetricWriter.class 10KB
ParamFlowChecker.class 10KB
EagleEyeRollingFileAppender.class 9KB
InMemoryMetricsRepository.class 9KB
SentinelJaxRsQuarkusAdapterTest.class 9KB
StandaloneRedisDataSourceTest.class 9KB
NettyTransportClient.class 9KB
DefaultClusterTokenClient.class 9KB
FlowRuleUtil.class 9KB
MonoSentinelOperatorIntegrationTest.class 9KB
GatewayRuleManager$GatewayRulePropertyListener.class 9KB
CommonFilterTest.class 9KB
SystemRuleManager.class 9KB
ProviderFilterTest.class 9KB
EurekaDataSource.class 9KB
ParamFlowDefaultCheckerTest.class 8KB
HttpServerHandlerTest.class 8KB
DegradeRuleManager.class 8KB
SentinelReactorSubscriber.class 8KB
LeapArray.class 8KB
SentinelGatewayFilter.class 8KB
SentinelModeRedisDataSourceTest.class 8KB
FlowRuleChecker.class 8KB
MetricController.class 8KB
RedisDataSource.class 8KB
SentinelDubboConsumerFilter.class 8KB
AsyncEntryIntegrationTest.class 8KB
PullConsumerDemo.class 8KB
SentinelZuulPreFilter.class 8KB
AsyncEntryDemo.class 8KB
MessageFormatter.class 8KB
CircuitBreakingIntegrationTest.class 8KB
ConsulDataSource.class 7KB
StatisticNode.class 7KB
ParamFlowCheckerTest.class 7KB
ExceptionRatioCircuitBreakerDemo.class 7KB
SimpleHttpClient.class 7KB
SentinelAnnotationQuarkusAdapterTest.class 7KB
SentinelDubboProviderFilterTest.class 7KB
DubboUtilsTest.class 7KB
EagleEye.class 7KB
InMemoryMetricsRepositoryTest.class 7KB
SentinelConfig.class 7KB
NettyTransportServer.class 7KB
ApiDefinitionEntity.class 7KB
ParameterMetric.class 7KB
ParamFlowRule.class 7KB
GatewayApiDefinitionManager.class 7KB
SlowRatioCircuitBreakerDemo.class 7KB
ClusterStateManager.class 7KB
StatEntry.class 7KB
NacosConfig.class 7KB
AbstractCircuitBreaker.class 7KB
共 4089 条
- 1
- 2
- 3
- 4
- 5
- 6
- 41
放飞的承诺
- 粉丝: 48
- 资源: 9
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功
评论2