Comprehensive Guide to Alibaba Sentinel: Installation, Configuration, Flow Control, Degrade Rules, Hot Parameter Limiting, System Adaptive Limits, Persistence, Cluster Flow Control, and Integration

Sentinel, also known as the "flow guard" in Alibaba's ecosystem, is a mature open‑source library for traffic protection, circuit breaking, and system load safeguarding, widely used in large‑scale e‑commerce scenarios such as Double‑11.

Key Features include rich application scenarios, real‑time monitoring, extensive open‑source ecosystem integration (Spring Cloud, Dubbo, gRPC, Quarkus), and a flexible SPI extension mechanism.

Installation : Download the Sentinel dashboard JAR (e.g., sentinel-dashboard-1.7.1.jar ) and run it with Java options such as -Dserver.port=8080 , -Dcsp.sentinel.dashboard.server=localhost:8080 , and -Dproject.name=sentinel-dashboard . Default credentials are sentinel/sentinel . Adjust JDK version ( >=1.8 ) and optional parameters as needed.

Microservice Integration : Register the service with Nacos, add the Sentinel starter dependency ( <dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-sentinel</artifactId></dependency> ), and configure the dashboard address in application.yml ( spring.cloud.sentinel.transport.dashboard: localhost:8080 ). Example controller and service code snippets demonstrate how to define endpoints and use @SentinelResource for resource protection.

Flow Control Configuration : Define FlowRule elements such as resource , count , grade , limitApp , strategy , and controlBehavior . Three flow‑control effects are supported: fast fail, warm‑up, and queue waiting, implemented via FlowException , WarmUpController , and RateLimiterController respectively.

Degrade (Circuit‑Breaker) Rules : Use DegradeRule with strategies like average response time ( DEGRADE_GRADE_RT ), exception ratio, and exception count. Configure thresholds, time windows, and optional max RT via startup parameters.

Hot Parameter Limiting : Limit specific parameter values using ParamFlowRule , with support for LRU tracking and token‑bucket algorithm. Example shows limiting the first method argument p1 to 1 QPS, with exception items for high‑traffic values.

System Adaptive Limits : Protect the entire system based on metrics such as load, CPU usage, average RT, concurrent threads, and entry QPS. These rules are configured in the Sentinel console and can be fine‑tuned per service.

Custom Block Handlers and Fallbacks : Use @SentinelResource attributes blockHandler , blockHandlerClass , fallback , fallbackClass , and defaultFallback to provide custom responses for blocked or exception‑thrown requests. Handlers can be placed in the same class or a separate static utility class.

Blacklist/Whitelist (Authority Rules) : Control access based on request origin using AuthorityRule , specifying resource , limitApp , and strategy (white or black list). Implement RequestOriginParser to extract origin information (e.g., IP).

Persistence with Nacos (Push Mode) : Add sentinel-datasource-nacos dependency and configure spring.cloud.sentinel.datasource for flow and degrade rules. Rules are stored as JSON in Nacos data IDs (e.g., ${spring.application.name}-flow ) and automatically pushed to the dashboard.

JSON Rule Formats : Provide sample JSON structures for flow rules, degrade rules, hot‑parameter rules, system rules, and authority rules, illustrating required fields and optional parameters.

Bidirectional Synchronization : Modify Sentinel dashboard source code to enable rule publishing back to Nacos (e.g., replace test‑scope dependencies, move Nacos rule provider/publisher to main code, adjust FlowControllerV1 to use Nacos beans, and configure Nacos server address in NacosConfig ).

Cluster Flow Control : Deploy Sentinel in embedded mode across multiple instances (e.g., ports 9009, 9011, 9013), designate one instance as token server, and configure cluster flow rules either via the console or Nacos. This ensures consistent rate limiting across the entire service cluster.

Overall, the guide equips developers with step‑by‑step instructions, code examples, and configuration details to fully leverage Sentinel for robust traffic management in Spring Cloud microservices.