SpringCloud-Hystrix断路器

---

前言

大概学习了下SpringCloud中的Hystrix的内容

---

一、Hystrix

1、Hystrix是什么

Hystrix是一个用于处理分布式系统的延迟和容错的开源库，在分布式系统里，许多依赖不可避免的会调用失败，比如超时、异常等，Hystrix能够保证在一个依赖出问题的情况下，不会导致整体服务失败，避免级联故障，以提高分布式系统的弹性。

"断路器”本身是一种开关装置，当某个服务单元发生故障之后，通过断路器的故障监控**（类似熔断保险丝)**，向调用方返回一个符合预期的、可处理的备选响应（FallBack)，而不是长时间的等待或者抛出调用方无法处理的异常，这样就保证了服务调用方的线程不会被长时间、不必要地占用，从而避免了故障在分布式系统中的蔓延，乃至雪崩。

2、Hystrix作用

• 服务降级
• 服务熔断
• 接近实时的监控
• …

3、Hystrix的服务降级、熔断、限流概念

1、服务降级
服务器忙，请稍后再试，不让客户端等待并立刻返回一个友好提示，fallback
触发降级的情况

• 程序运行异常
• 超时
• 服务熔断触发服务降级
• 线程池/信号量打满也会导致服务降级

2、服务熔断
断路器类比保险丝，在达到最大服务访问量后，直接拒绝访问（拉闸限电），然后调用服务降级的方法并返回友好提示。
服务降级 —> 进而熔断 —> 恢复调用链路
熔断机制是应对雪崩效应的一种微服务链路保护机制。当扇出链路的某个微服务出错不可用或者响应时间太长时
会进行服务的降级，进而熔断该节点微服务的调用，快速返回错误的响应信息
当检测到该节点微服务调用响应正常后，恢复调用链路。
在Spring Cloud框架里，熔断机制通过Hystrix实现。Hystrix会监控微服务间调用的状况，当失败的调用到一定阈值
缺省是5秒内20次调用失败，就会启动熔断机制。熔断机制的注解是@HystrixCommand。

3、服务限流
秒杀等高并发的操作，严禁一窝蜂的拥挤过来，对服务访问顺序进行排队，一秒钟N个，有序进行。

二、服务降级

1、引入库

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

2、application.yml

server:
  port: 80
spring:
  application:
    name: cloud-consumer-order
eureka:
  client:
    register-with-eureka: false
    fetch-registry: true
    service-url:
      defaultZone: http://eureka7001.com:7001/eureka/
feign:
  client:
    config:
      default:
        #因为测试时使用了sleep，为了防止因为调用其他服务时间过长而导致的ribbon超时，所以要设置超时控制的时间
        readTimeout: 5000
        connectTimeout: 5000
  hystrix:
    enabled: true
hystrix:
  command:
    default:
      execution:
        isolation:
          thread:
            #关键在于feign:hystrix:enabled: true的作用
            #官网解释“Feign将使用断路器包装所有方法”
            #也就是将@FeignClient标记的那个service接口下所有的方法进行了hystrix包装（类似于在这些方法上加了一个@HystrixCommand）
            #这些方法会应用一个默认的超时时间为1s
            #所以service方法也有一个1s的超时时间
            #service超过1s就会报异常，controller立马进入备用方法
            #@HystrixProperty(name="execution.isolation.thread.timeoutInMilliseconds",value="3000"
            #controller上value="3000"就不会有效果，而是默认使用1s
            timeoutInMilliseconds: 5000

3、主启动类

	@SpringBootApplication
	@EnableEurekaClient
	@EnableFeignClients
	@EnableHystrix
	public class OrderHystrixMain80 {
	    public static void main(String[] args) {
	        SpringApplication.run(OrderHystrixMain80.class, args);
	    }
	}

4、Feign的Serivce接口

	@Component
	//普通使用
	@FeignClient(value = "CLOUD-PAYMENT-HYSTRIX-SERVICE")
	//为该接口下的所有方法设置一个全局的fallback方法，并且减少代码的耦合，这样就不需要将全局服务降级写在controller中
	@FeignClient(value = "CLOUD-PAYMENT-HYSTRIX-SERVICE",fallback = PaymentFallbackService.class)
	public interface PaymentHystrixService {
	    @GetMapping("/payment/hystrix/ok/{id}")
	    public String paymentInfo_OK(@PathVariable("id") Integer id);
	
	    @GetMapping("/payment/hystrix/timeout/{id}")
	    public String paymentInfo_TimeOut(@PathVariable("id") Integer id);
	}

5、全局的fallback方法

实现feign的service接口，这样在调用接口的方法时如果出现了异常等情况，会有固定的处理方法
在测试中发现：该方法似乎会被controller中的@HystrixCommand所覆盖

@Component
public class PaymentFallbackService implements PaymentHystrixService{
    @Override
    public String paymentInfo_OK(Integer id) {
        return "-----PaymentFallbackService fall back-paymentInfo_OK ,o(╥﹏╥)o";
    }
    @Override
    public String paymentInfo_TimeOut(Integer id) {
        return "-----PaymentFallbackService fall back-paymentInfo_TimeOut ,o(╥﹏╥)o";
    }
}

6、controller

	@RestController
	@Slf4j
	//在该类中的全局服务降级处理，处理方法为payment_Global_FallbackMethod
	@DefaultProperties(defaultFallback = "payment_Global_FallbackMethod")
	public class OrderHystrixController {
	    @Resource
	    private PaymentHystrixService paymentHystrixService;
	
	    @GetMapping("/consumer/payment/hystrix/ok/{id}")
	    public String paymentInfo_OK(@PathVariable("id") Integer id){
	        return paymentHystrixService.paymentInfo_OK(id);
	    }
	
	    @GetMapping("/consumer/payment/hystrix/timeout/{id}")
	    //可以为部分方法设置特殊的服务降级处理方法，处理方法为paymentInfo_TimeOutHandler
	    @HystrixCommand(fallbackMethod = "paymentInfo_TimeOutHandler",commandProperties = {
	    		//需要处理的条件
	            @HystrixProperty(name="execution.isolation.thread.timeoutInMilliseconds",value="10000")
	    })
	    //如果需要使用该类中全局服务降级处理，需要添加注解
	    @HystrixCommand
	    public String paymentInfo_TimeOut(@PathVariable("id") Integer id){
	//        int a=10/0;
	        return paymentHystrixService.paymentInfo_TimeOut(id);
	    }
	
		//特殊的fallback方法
	    public String paymentInfo_TimeOutHandler(Integer id){
	        return "我是消费者80,对方支付系统繁忙请10秒钟后再试或者自己运行出错请检查自己,o(╥﹏╥)o"+id;
	    }
	
	    //全局fallback方法
	    public String payment_Global_FallbackMethod()
	    {
	        return "Global异常处理信息，请稍后再试，/(ㄒoㄒ)/~~";
	    }
	}

7、注意

在初步测试中发现：处理权限似乎是3>2>1

//1:通过Feign去调用其他服务的接口中的fallback方法----->统一和自定义的分开，防止代码混乱
//以Feign为例：在需要调用其他的服务时，必然会通过Feign所指明的服务接口
//那么通过实现该服务接口的方式，重写该服务接口的每一个方法，来设置不同的fallback方法
//这样在某处调用该服务接口的某个方法时，会有默认的fallback方法来处理
@FeignClient(value = "CLOUD-PAYMENT-HYSTRIX-SERVICE",fallback = PaymentFallbackService.class)
public interface PaymentHystrixService{}
@Component
public class PaymentFallbackService implements PaymentHystrixService{}

//2:控制器中的全局fallback方法----->通用的和独享的各自分开，避免了代码膨胀，合理减少了代码量
//不可能为每一个控制器方法设置一个fallback方法，所有需要一个全局通用的fallback方法
//在为需要服务降级的方法上添加注解@HystrixCommand即可
@DefaultProperties(defaultFallback = "payment_Global_FallbackMethod")
public class OrderHystrixController{}
public String payment_Global_FallbackMethod(){}

//3:特殊的fallback方法
//独立设置一个服务降级方法，需要指明处理条件
@HystrixCommand(fallbackMethod = "paymentInfo_TimeOutHandler",commandProperties = {
            @HystrixProperty(name="execution.isolation.thread.timeoutInMilliseconds",value="10000")
    })
public String methodName(@PathVariable("id") Integer id){}
public String paymentInfo_TimeOutHandler(Integer id){}

三、服务熔断

1、service

@Service
public class PaymentServiceImpl implements PaymentService {
	......
    //=====服务熔断
    @HystrixCommand(fallbackMethod = "paymentCircuitBreaker_fallback",commandProperties = {
            @HystrixProperty(name = "circuitBreaker.enabled",value = "true"),// 是否开启断路器
            @HystrixProperty(name = "circuitBreaker.requestVolumeThreshold",value = "10"),// 请求次数
            @HystrixProperty(name = "circuitBreaker.sleepWindowInMilliseconds",value = "10000"), // 时间窗口期
            @HystrixProperty(name = "circuitBreaker.errorThresholdPercentage",value = "60"),// 失败率达到多少后跳闸
    })
    public String paymentCircuitBreaker(@PathVariable("id") Integer id) {
        if(id < 0) {
            throw new RuntimeException("******id 不能负数");
        }
        String serialNumber = IdUtil.simpleUUID();
        return Thread.currentThread().getName()+"\t"+"调用成功，流水号: " + serialNumber;
    }
    public String paymentCircuitBreaker_fallback(@PathVariable("id") Integer id) {
        return "id 不能负数，请稍后再试，/(ㄒoㄒ)/~~   id: " +id;
    }
}

2、HystrixCommandProperties配置类

@HystrixProperty中的属性在HystrixCommandProperties配置类中

package com.netflix.hystrix;
...
public abstract class HystrixCommandProperties {
    private static final Logger logger = LoggerFactory.getLogger(HystrixCommandProperties.class);
    /* defaults */
    /* package */ static final Integer default_metricsRollingStatisticalWindow = 10000;// default => statisticalWindow: 10000 = 10 seconds (and default of 10 buckets so each bucket is 1 second)
    private static final Integer default_metricsRollingStatisticalWindowBuckets = 10;// default => statisticalWindowBuckets: 10 = 10 buckets in a 10 second window so each bucket is 1 second
    private static final Integer default_circuitBreakerRequestVolumeThreshold = 20;// default => statisticalWindowVolumeThreshold: 20 requests in 10 seconds must occur before statistics matter
    private static final Integer default_circuitBreakerSleepWindowInMilliseconds = 5000;// default => sleepWindow: 5000 = 5 seconds that we will sleep before trying again after tripping the circuit
    private static final Integer default_circuitBreakerErrorThresholdPercentage = 50;// default => errorThresholdPercentage = 50 = if 50%+ of requests in 10 seconds are failures or latent then we will trip the circuit
    private static final Boolean default_circuitBreakerForceOpen = false;// default => forceCircuitOpen = false (we want to allow traffic)
    /* package */ static final Boolean default_circuitBreakerForceClosed = false;// default => ignoreErrors = false 
    private static final Integer default_executionTimeoutInMilliseconds = 1000; // default => executionTimeoutInMilliseconds: 1000 = 1 second
    private static final Boolean default_executionTimeoutEnabled = true;

    ...
}

3、ALL配置

@HystrixCommand(fallbackMethod = "fallbackMethod", 
                groupKey = "strGroupCommand", 
                commandKey = "strCommand", 
                threadPoolKey = "strThreadPool",
                
                commandProperties = {
                    // 设置隔离策略，THREAD 表示线程池 SEMAPHORE：信号池隔离
                    @HystrixProperty(name = "execution.isolation.strategy", value = "THREAD"),
                    // 当隔离策略选择信号池隔离的时候，用来设置信号池的大小（最大并发数）
                    @HystrixProperty(name = "execution.isolation.semaphore.maxConcurrentRequests", value = "10"),
                    // 配置命令执行的超时时间
                    @HystrixProperty(name = "execution.isolation.thread.timeoutinMilliseconds", value = "10"),
                    // 是否启用超时时间
                    @HystrixProperty(name = "execution.timeout.enabled", value = "true"),
                    // 执行超时的时候是否中断
                    @HystrixProperty(name = "execution.isolation.thread.interruptOnTimeout", value = "true"),
                    
                    // 执行被取消的时候是否中断
                    @HystrixProperty(name = "execution.isolation.thread.interruptOnCancel", value = "true"),
                    // 允许回调方法执行的最大并发数
                    @HystrixProperty(name = "fallback.isolation.semaphore.maxConcurrentRequests", value = "10"),
                    // 服务降级是否启用，是否执行回调函数
                    @HystrixProperty(name = "fallback.enabled", value = "true"),
                    // 是否启用断路器
                    @HystrixProperty(name = "circuitBreaker.enabled", value = "true"),
                    // 该属性用来设置在滚动时间窗中，断路器熔断的最小请求数。例如，默认该值为 20 的时候，如果滚动时间窗（默认10秒）内仅收到了19个请求， 即使这19个请求都失败了，断路器也不会打开。
                    @HystrixProperty(name = "circuitBreaker.requestVolumeThreshold", value = "20"),
                    
                    // 该属性用来设置在滚动时间窗中，表示在滚动时间窗中，在请求数量超过 circuitBreaker.requestVolumeThreshold 的情况下，如果错误请求数的百分比超过50, 就把断路器设置为 "打开" 状态，否则就设置为 "关闭" 状态。
                    @HystrixProperty(name = "circuitBreaker.errorThresholdPercentage", value = "50"),
                    // 该属性用来设置当断路器打开之后的休眠时间窗。 休眠时间窗结束之后，会将断路器置为 "半开" 状态，尝试熔断的请求命令，如果依然失败就将断路器继续设置为 "打开" 状态，如果成功就设置为 "关闭" 状态。
                    @HystrixProperty(name = "circuitBreaker.sleepWindowinMilliseconds", value = "5000"),
                    // 断路器强制打开
                    @HystrixProperty(name = "circuitBreaker.forceOpen", value = "false"),
                    // 断路器强制关闭
                    @HystrixProperty(name = "circuitBreaker.forceClosed", value = "false"),
                    // 滚动时间窗设置，该时间用于断路器判断健康度时需要收集信息的持续时间
                    @HystrixProperty(name = "metrics.rollingStats.timeinMilliseconds", value = "10000"),
                    
                    // 该属性用来设置滚动时间窗统计指标信息时划分"桶"的数量，断路器在收集指标信息的时候会根据设置的时间窗长度拆分成多个 "桶" 来累计各度量值，每个"桶"记录了一段时间内的采集指标。
                    // 比如 10 秒内拆分成 10 个"桶"收集这样，所以 timeinMilliseconds 必须能被 numBuckets 整除。否则会抛异常
                    @HystrixProperty(name = "metrics.rollingStats.numBuckets", value = "10"),
                    // 该属性用来设置对命令执行的延迟是否使用百分位数来跟踪和计算。如果设置为 false, 那么所有的概要统计都将返回 -1。
                    @HystrixProperty(name = "metrics.rollingPercentile.enabled", value = "false"),
                    // 该属性用来设置百分位统计的滚动窗口的持续时间，单位为毫秒。
                    @HystrixProperty(name = "metrics.rollingPercentile.timeInMilliseconds", value = "60000"),
                    // 该属性用来设置百分位统计滚动窗口中使用 “ 桶 ”的数量。
                    @HystrixProperty(name = "metrics.rollingPercentile.numBuckets", value = "60000"),
                    // 该属性用来设置在执行过程中每个 “桶” 中保留的最大执行次数。如果在滚动时间窗内发生超过该设定值的执行次数，
                    // 就从最初的位置开始重写。例如，将该值设置为100, 滚动窗口为10秒，若在10秒内一个 “桶 ”中发生了500次执行，
                    // 那么该 “桶” 中只保留 最后的100次执行的统计。另外，增加该值的大小将会增加内存量的消耗，并增加排序百分位数所需的计算时间。
                    @HystrixProperty(name = "metrics.rollingPercentile.bucketSize", value = "100"),
                    
                    // 该属性用来设置采集影响断路器状态的健康快照（请求的成功、 错误百分比）的间隔等待时间。
                    @HystrixProperty(name = "metrics.healthSnapshot.intervalinMilliseconds", value = "500"),
                    // 是否开启请求缓存
                    @HystrixProperty(name = "requestCache.enabled", value = "true"),
                    // HystrixCommand的执行和事件是否打印日志到 HystrixRequestLog 中
                    @HystrixProperty(name = "requestLog.enabled", value = "true"),

                },
                threadPoolProperties = {
                    // 该参数用来设置执行命令线程池的核心线程数，该值也就是命令执行的最大并发量
                    @HystrixProperty(name = "coreSize", value = "10"),
                    // 该参数用来设置线程池的最大队列大小。当设置为 -1 时，线程池将使用 SynchronousQueue 实现的队列，否则将使用 LinkedBlockingQueue 实现的队列。
                    @HystrixProperty(name = "maxQueueSize", value = "-1"),
                    // 该参数用来为队列设置拒绝阈值。 通过该参数， 即使队列没有达到最大值也能拒绝请求。
                    // 该参数主要是对 LinkedBlockingQueue 队列的补充,因为 LinkedBlockingQueue 队列不能动态修改它的对象大小，而通过该属性就可以调整拒绝请求的队列大小了。
                    @HystrixProperty(name = "queueSizeRejectionThreshold", value = "5"),
                }
               )
public String doSomething() {
	...
}

4、总结

1、熔断类型

• 熔断打开：求不再进行调用当前服务，内部设置时钟一般为MTTR(平均故障处理时间)，当打开时长达到所设时钟则进入半熔断状态。
• 熔断关闭：熔断关闭不会对服务进行熔断。
• 熔断半开：部分请求根据规则调用当前服务，如果请求成功且符合规则则认为当前服务恢复正常，关闭熔断。

2、断路器在什么情况下起作用

 @HystrixCommand(fallbackMethod = "paymentCircuitBreaker_fallback",commandProperties = {
            @HystrixProperty(name = "circuitBreaker.enabled",value = "true"),// 是否开启断路器
            @HystrixProperty(name = "circuitBreaker.requestVolumeThreshold",value = "10"),// 请求次数
            @HystrixProperty(name = "circuitBreaker.sleepWindowInMilliseconds",value = "10000"), // 时间窗口期
            @HystrixProperty(name = "circuitBreaker.errorThresholdPercentage",value = "60"),// 失败率达到多少后跳闸
    })

3、断路器的三个重要参数：

1. 快照时间窗：断路器确定是否打开需要统计一些请求和错误数据，而统计的时间范围就是快照时间窗，默认为最近的10秒。
2. 请求总数阈值：在快照时间窗内，必须满足请求总数阀值才有资格熔断。默认为20，意味着在10秒内，如果该hystrix命令的调用次数不足20次7,即使所有的请求都超时或其他原因失败，断路器都不会打开。
3. 错误百分比阈值：当请求总数在快照时间窗内超过了阀值，比如发生了30次调用，如果在这30次调用中，有15次发生了超时异常，也就是超过50%的错误百分比，在默认设定50%阀值情况下，这时候就会将断路器打开。

4、断路器开启或者关闭的条件

• 达到以下阈值，断路器将会开启：
  当满足一定的阈值的时候（默认10秒没超过20次请求）
  当失败率达到一定的阈值的时候（默认10秒内超过50%次请求失败）
• 当开启的时候，所有的请求都不会进行转发
• 一段时间后（默认是5秒），这个时候断路器是半开状态，会尝试性让其中一个请求进行转发。如果成功，断路器会关闭，若失败，继续开启。

5、断路器打开后

1. 再有请求调用的时候，将不会调用主逻辑，而是直接调用降级fallback。通过断路器，实现了自动地发现错误并将降级逻辑切换为主逻辑，减少响应延迟的效果。
2. 原来的主逻辑由hystrix实现自动恢复
   当断路器打开，对主逻辑进行熔断之后，hystrix会启动一个休眠时间窗，在这个时间窗内，降级逻辑是临时的成为主逻辑，当休眠时间窗到期，断路器将进入半开状态，释放一次请求到原来的主逻辑上，如果此次请求正常返回，那么断路器将继续闭合，主逻辑恢复，如果这次请求依然有问题，断路器继续进入打开状态，休眠时间窗重新计时。

四、服务限流

之后学alibaba的Sentinel

五、Hystrix图形化Dashboard

1、概述

除了隔离依赖服务的调用以外，Hystrix还提供了准实时的调用监控(Hystrix Dashboard)，Hystrix会持续地记录所有通过Hystrix发起的请求的执行信息，并以统计报表和图形的形式展示给用户，包括每秒执行多少请求多少成功，多少失败等。

Netflix通过hystrix-metrics-event-stream项目实现了对以上指标的监控。Spring Cloud也提供了Hystrix Dashboard的整合，对监控内容转化成可视化界面。

2、创建dashboard模块

1、POM

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

2、YML

server:
	port: 9001

3、主启动类

@SpringBootApplication
//开启图形化监控
@EnableHystrixDashboard
public class HystrixDashboardMain9001
{
    public static void main(String[] args) {
        SpringApplication.run(HystrixDashboardMain9001.class, args);
    }
}

4、注意
所有Provider微服务提供类(8001/8002/8003)都需要监控依赖配置

	<dependency>
	    <groupId>org.springframework.boot</groupId>
	    <artifactId>spring-boot-starter-actuator</artifactId>
	</dependency>

浏览器输入http://localhost:9001/hystrix开启监控页面

3、监控测试

1、被监控服务需要修改主启动类

    /**
     *此配置是为了服务监控而配置，与服务容错本身无关，springcloud升级后的坑
     *ServletRegistrationBean因为springboot的默认路径不是"/hystrix.stream"，
     *只要在自己的项目里配置上下面的servlet就可以了
     *否则会报错：Unable to connect to Command Metric Stream 404
     */
    @Bean
    public ServletRegistrationBean getServlet() {
        HystrixMetricsStreamServlet streamServlet = new HystrixMetricsStreamServlet();
        ServletRegistrationBean registrationBean = new ServletRegistrationBean(streamServlet);
        registrationBean.setLoadOnStartup(1);
        registrationBean.addUrlMappings("/hystrix.stream");
        registrationBean.setName("HystrixMetricsStreamServlet");
        return registrationBean;
    }

2、在监控页面中填写监控地址-http://localhost:8001/hystrix.stream-到http://localhost:9001/hystrix页面的输入框

---