Hystrix is a latency and fault tolerance library from Netflix designed for distributed systems. In microservices architectures, inter-service communication is common, and failures or delays in one service can cascade and degrade overall system performance. Hystrix mitigates these risks by isolating points of access between services, providing fallback options, and preventing system-wide failures.

Integrating Hystrix with Spring Boot

To add Hystrix support to a Spring Boot application, include the necessary dependency in you're project configuration.

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
</dependency>

Applying Hystrix to a Service Method

The following example demonstrates protecting a REST endpoint with Hystrix. The @HystrixCommand annotation designates a fallback method to execute if the primary method fails.

import com.netflix.hystrix.contrib.javanica.annotation.HystrixCommand;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.client.RestTemplate;

@RestController
public class AccountController {
    
    @Autowired
    private RestTemplate client;
    
    @HystrixCommand(fallbackMethod = "getDefaultAccount")
    @GetMapping("/accounts/{accountId}")
    public String fetchAccount(@PathVariable("accountId") Long accountId) {
        String serviceUrl = "http://account-service/accounts/" + accountId;
        return client.getForObject(serviceUrl, String.class);
    }
    
    public String getDefaultAccount(Long accountId) {
        return "Default Account for ID: " + accountId;
    }
}

In this code:

• The fetchAccount method attempts to retrieve account details from a remote service.
• If the remote call fails or times out, Hystrix invokes the getDefaultAccount method as a fallback, ensuring the application continues to respond.

Configuring Hystrix Properties

Hystrix behavior can be customized via application configuration. The example below sets a timeout threshold of three seconds for command execution.

hystrix:
  command:
    default:
      execution:
        isolation:
          thread:
            timeoutInMilliseconds: 3000

Monitoring with Hystrix Dashboard

For real-time monitoring of Hystrix metrics, integrate the Hystrix Dashboard. First, add the dashboard dependency.

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-hystrix-dashboard</artifactId>
</dependency>

Then, enable the dashboard by annotating the main application class with @EnableHystrixDashboard.