alibaba /Sentinel
A powerful flow control component enabling reliability, resilience and monitoring for microservices. (面向云原生微服务的高可用流控防护组件)
★ 23,147⑂ 8,117👁 765⑃ 1,189● 2,363▤ 27
+0
日增长
-1
周增长
+1
月增长
23,147
stars
8,117
forks
765
watchers
1,189
prs
2,363
issues
27
releases
README
Sentinel: The Sentinel of Your Microservices
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,
concurrency limiting, circuit breaking and system adaptive overload 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, gRPC, Apache Dubbo and Quarkus. You can easily use Sentinel by simply add the adapter dependency to your services.
- Polyglot support: Sentinel has provided native support for Java, Go, C++ and Rust.
- 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
The community is also working on the specification of traffic governance and fault-tolerance.
Please refer to OpenSergo for details.
Documentation
See the Sentinel Website for the official website of Sentinel.
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, Quarkus, 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.
xml
com.alibaba.csp
sentinel-core
1.8.10
If not, you can download JAR in Maven Center Repository.
2. Define Resource
Wrap your code snippet via Sentinel API: SphU.eTop issues
#18Wanted: Who is using Sentinel104 comments · 2018-08-01#59关于线程限流问题的讨论24 comments · 2018-08-14#1842Support recording error code as "error" for API gateway circuit breaking21 comments · 2020-11-05#1486引入sentinel后,客户端机器每天凌晨的读磁盘次数飙升21 comments · 2020-05-15#1401Circuit breaking was not triggered with Spring WebFlux and reactive WebClient20 comments · 2020-04-13#863Circuit breaking by parameters19 comments · 2019-06-25#2420强烈官网、增加Nacos持久化的双向同步15 comments · 2021-10-15#2901无法监听熔断规则变更后的熔断器状态变换事件!!!14 comments · 2022-10-10
Discussions
#3472自定义SentinelGlobalResourceInterceptor,偶发出现 ErrorEntryFreeException0 comments · 2024-11-06#3424How to use it in scenarios where resource names are not fixed1 comments · 2024-07-02#3394WarmUpController的warningTakens的计算方式1 comments · 2024-05-10#3374能否不开通8721端口号?1 comments · 2024-04-16#3373如何控制不在服务器上生成sentinel的文件(csp路径下的那些文件)1 comments · 2024-04-16#3330New branch model enabled | 新分支模型启用0 comments · 2024-02-01#3312为什么官方不提供基于不同存储方式的 MetricExtension 实现和配置方案呢1 comments · 2024-01-20#3306求助!8719端口扫描出XSS漏洞如何修复?0 comments · 2024-01-15
Latest release
v1.8.10 1.8.10 2026-05-21Features / Enhancements - Add Apache HttpClient 5.x adapter for Sentinel (3614) - Support Spring RestClient (3602) - Add optional switch to skip regex resource matching when exact match exists, default disabled for backward compatibility (3565) Bug Fixes - Ensure requests are blocked when errRatioThreshold reaches 100% (1857) - Fix EndpointtoString host formatting (3578) - Fix the bug in spring-webmvc-v6x adapter where HTTP method prefix was not concatenated when http-method-specify is enabled (3569) Dashboard - Fix incorrect time unit in the tooltip when adding a new circuit breaker ru