Migrate from Hystrix to Sentinel: A Practical Guide

Netflix's Hystrix has announced that it will no longer add new features, prompting developers to consider alternatives such as Resilience4j and Alibaba's Sentinel.

Resilience4j is a lightweight fault‑tolerance library designed for Java 8 and functional programming, using only Vavr as a dependency, whereas Hystrix depends on Archaius and brings additional libraries like Guava.

Provides functional and reactive APIs for Java 8.

Includes rate‑limiting and automatic retry modules.

Encapsulates automatic retry logic to simplify error recovery.

Sentinel, a lightweight high‑availability traffic‑control component for distributed services, offers flow control, circuit breaking, and system load protection to improve service stability.

Command Migration

Hystrix wraps external calls and fallback logic into HystrixCommand or HystrixObservableCommand. Sentinel does not prescribe an execution model; resources are defined via its API.

In Sentinel, resource definition and rule configuration are separated. Users first register a resource with the Sentinel API, then configure rules as needed.

Isolation Strategies

Thread‑pool isolation offers strong isolation but incurs higher thread count and context‑switch overhead, which can affect low‑latency calls. Sentinel prefers semaphore isolation, a lighter‑weight approach.

Hystrix configures semaphore isolation at command definition time:

Sentinel applies semaphore isolation through thread‑count flow‑control rules:

Circuit Breaking

Hystrix supports error‑rate circuit breaking with properties such as circuitBreaker.errorThresholdPercentage and circuitBreaker.sleepWindowInMilliseconds.

In Sentinel, developers configure degradation rules for the desired resources, achieving similar automatic circuit breaking based on error ratio, average response time, or exception count.

Annotation Support

Hystrix provides @HystrixCommand annotations with embedded command properties. Sentinel offers @SentinelResource annotations for defining resources, fallback, and block handlers.

Rules can be loaded programmatically via DegradeRuleManager.loadRules(rules) or managed through the Sentinel console.

Framework Integration and Dynamic Configuration

Sentinel already provides adapters for Servlet, Dubbo, Spring Cloud, gRPC, etc., allowing quick integration without code changes. It also supports dynamic rule data sources such as Nacos, ZooKeeper, Apollo, and Redis via ReadableDataSource and WritableDataSource interfaces.