Spring Cloud Netflix: Hystrix

What is a Hystrix:

Hystrix is a circuit breaker library developed by Netflix. Hystrix is used in distributed systems to achieve resilience because of it’s fault tolerance mechanism.

Why do we use hystrix?

In a distributed system like microservice architecture, we have multiple services that interact with each other to achieve certain business goals. In this type of architecture, it is very easy that if a single service fails, all the subsequent services depending on or getting data from that service will also fail. And eventually, the error will propagate to the customer which will cause bad customer experience. Hence, it is better to have a fall back mechanism so that whenever some underlying application is not behaving as expected we will stop making calls to that service and call the fallback method. This will also give some time to the unhealthy system to allow it to recover which is not possible, if the unhealthy service is getting requests continuously.

Hystrix is circuit breaker library which means that after getting failure from the unhealthy microservice a certain number of times, the circuit breaker will trip and not allow requests to go through.

Circuit breaker

After the circuit trips the service will depend on the fallback method to get the response. This will prevent a cascading of errors to all the dependent services.

For example, let us consider the figure below which has a critical service payment. It is dependent on a microservice promotion and due to some reason there is a failure in the promotion microservice. The promotion microservice is not very critical because even if a customer can’t apply the promotion code for the purchase, he should be allowed to pay and purchase the product. So when promotion throws an error we can call the fallback method to show an error message saying that the promotion code can’t be applied. And after seeing this message, if the customer wishes he can purchase the product, without applying the promotion code.

Real-time example of microservice architecture

Thus a hystrix is helpful in graceful degradation of an error as it stops the propagation of error, using it’s fallback mechanism system.

How to add Hystrix in your project ?

Now that we know all about Hystrix, let’s implement it to any of our project.

Add the following hystrix dependency provided by Spring cloud Netflix to pom.xml file.

Then add the annotation @EnableCircuitBreaker or @EnableHystrix (this annotation is particularly for enabling hystrix only) to the configuration file.

Add @HystrixCommand annotation to the method that can cause system failure and in case of an error, add the name of the method that it should fallback to. In our case validatePromotionCouponFallbackMethod will be the fallback method.

Then write the method validatePromotionCouponFallbackMethod() which will handle graceful degradation of the error.

So whenever the promotion microservice is not responding the fallback method validatePromotionCouponFallbackMethod() will be called which will return a custom message for customer.

This way Hystrix will be added to your project to achieve resiliency in few simple steps.

Configurations for a Hystrix:

There are multiple properties that a Hystrix provides which we can configure according to our will. This properties can be specified either, in the configuration file or in the properties file. If none of them are configured, the hystrix will take the default properties. The threshold, fallback properties, command properties, thread-pool properties for hystrix can be configured. If you have multiple hystrix configured you can have dynamic instances containing specific properties for each hystrix. All the netflix libraries use Archaius for default properties implementation.


A hystrix adds the ability to fallback to a certain method and skip an intended call in case of an error. It provides circuit breakers which will trip after the threshold. Hence it prepares developer for failure beforehand instead of thinking what to do after the failure has already occurred.


Originally published at .

Like what you read? Give Coviam Technologies a round of applause.

From a quick cheer to a standing ovation, clap to show how much you enjoyed this story.