SpringCloud - Spring Cloud Netflix 之 Hystrix（配置），OpenFeign

Posted 2022-06-24 MinggeQingchun

阅读本文前可先参考

SpringCloud - Spring Cloud根/父项目，开发准备（二）_MinggeQingchun的博客-CSDN博客

SpringCloud - Spring Cloud Netflix 之 Hystrix熔断器（七） 

一、Hystrix配置

hystrix.command.default.execution.isolation.strategy 隔离策略，默认是Thread, 可选Thread｜Semaphore（信号量）

hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds 命令执行超时时间，默认1000ms

hystrix.command.default.execution.timeout.enabled 执行是否启用超时，默认启用true

hystrix.command.default.execution.isolation.thread.interruptOnTimeout 发生超时是是否中断，默认true

hystrix.command.default.execution.isolation.semaphore.maxConcurrentRequests 

最大并发请求数，默认10，该参数当使用ExecutionIsolationStrategy.SEMAPHORE策略时才有效。如果达到最大并发请求数，请求会被拒绝。理论上选择semaphore size的原则和选择thread size一致，但选用semaphore时每次执行的单元要比较小且执行速度快（ms级别），否则的话应该用thread。semaphore应该占整个容器（tomcat）的线程池的一小部分。 Fallback相关的属性 这些参数可以应用于Hystrix的THREAD和SEMAPHORE策略；

hystrix.command.default.fallback.isolation.semaphore.maxConcurrentRequest如果并发数达到该设置值，请求会被拒绝和抛出异常并且fallback不会被调用。默认10

hystrix.command.default.fallback.enabled 当执行失败或者请求被拒绝，是否会尝试调用hystrixCommand.getFallback() 。默认true

Circuit Breaker相关的属性

hystrix.command.default.circuitBreaker.enabled 用来跟踪circuit的健康性，如果未达标则让request短路。默认true

hystrix.command.default.circuitBreaker.requestVolumeThreshold 一个rolling window内最小的请求数。如果设为20，那么当一个rolling window的时间内（比如说1个rolling window是10秒）收到19个请求， 即使19个请求都失败，也不会触发circuit break。默认20

hystrix.command.default.circuitBreaker.sleepWindowInMilliseconds 触发短路的时间值，当该值设为5000时，则当触发circuit break后的5000毫秒内都会拒绝request，也就是5000毫秒后才会关闭circuit。 默认5000

hystrix.command.default.circuitBreaker.errorThresholdPercentage错误比率阀值，如果错误率>=该 值，circuit会被打开，并短路所有请求触发fallback。默认50

hystrix.command.default.circuitBreaker.forceOpen 强制打开熔断器，如果打开这个开关，那么拒绝所 有request，默认false

hystrix.command.default.circuitBreaker.forceClosed 强制关闭熔断器 如果这个开关打开，circuit将 一直关闭且忽略circuitBreaker.errorThresholdPercentage

Metrics相关参数

hystrix.command.default.metrics.rollingStats.timeInMilliseconds 设置统计的时间窗口值的，毫秒值，circuit break 的打开会根据1个rolling window的统计来计算。若rolling window被设为10000毫秒， 则rolling window会被分成n个buckets，每个bucket包含success，failure，timeout，rejection的次数的统计信息。默认10000

hystrix.command.default.metrics.rollingStats.numBuckets 设置一个rolling window被划分的数 量，若numBuckets＝10，rolling window＝10000，那么一个bucket的时间即1秒。必须符合rolling window  % numberBuckets == 0。默认10

hystrix.command.default.metrics.rollingPercentile.enabled 执行时是否enable指标的计算和跟踪， 默认true

hystrix.command.default.metrics.rollingPercentile.timeInMilliseconds 设置rolling  percentile window的时间，默认60000

hystrix.command.default.metrics.rollingPercentile.numBuckets 设置rolling percentile  window的numberBuckets。逻辑同上。默认6

hystrix.command.default.metrics.rollingPercentile.bucketSize 如果bucket size＝100，window ＝10s，若这10s里有500次执行，只有最后100次执行会被统计到bucket里去。增加该值会增加内存开销以及排序 的开销。默认100
hystrix.command.default.metrics.healthSnapshot.intervalInMilliseconds 记录health 快照（用 来统计成功和错误绿）的间隔，默认500ms
Request Context 相关参数

hystrix.command.default.requestCache.enabled 默认true，需要重载getCacheKey()，返回null时不 缓存

 hystrix.command.default.requestLog.enabled 记录日志到HystrixRequestLog，默认true
 Collapser Properties 相关参数

 hystrix.collapser.default.maxRequestsInBatch 单次批处理的最大请求数，达到该数量触发批处理，默认 Integer.MAX_VALU

hystrix.collapser.default.timerDelayInMilliseconds 触发批处理的延迟，也可以为创建批处理的时间 ＋该值，默认10

hystrix.collapser.default.requestCache.enabled 是否对HystrixCollapser.execute() and  HystrixCollapser.queue()的cache，默认true

ThreadPool 相关参数

线程数默认值10适用于大部分情况（有时可以设置得更小），如果需要设置得更大，那有个基本得公式可以 follow： requests per second at peak when healthy × 99th percentile latency in seconds + some  breathing room 每秒最大支撑的请求数 (99%平均响应时间 + 缓存值) 比如：每秒能处理1000个请求，99%的请求响应时间是60ms，那么公式是： 1000 （0.060+0.012）基本得原则时保持线程池尽可能小，他主要是为了释放压力，防止资源被阻塞。 当一切都是正常的时候，线程池一般仅会有1到2个线程激活来提供服务

hystrix.threadpool.default.coreSize 并发执行的最大线程数，默认10

hystrix.threadpool.default.maxQueueSize BlockingQueue的最大队列数，当设为－1，会使用
SynchronousQueue，值为正时使用LinkedBlcokingQueue。该设置只会在初始化时有效，之后不能修改threadpool的queue size，除非reinitialising thread executor。默认－1。

hystrix.threadpool.default.queueSizeRejectionThreshold 即使maxQueueSize没有达到，达到 queueSizeRejectionThreshold该值后，请求也会被拒绝。因为maxQueueSize不能被动态修改，这个参数将允 许我们动态设置该值。if maxQueueSize == 1，该字段将不起作用 hystrix.threadpool.default.keepAliveTimeMinutes 如果corePoolSize和maxPoolSize设成一样（默认 实现）该设置无效。如果通过plugin（https://github.com/Netflix/Hystrix/wiki/Plugins）使用自定义 实现，该设置才有用，默认1.

hystrix.threadpool.default.metrics.rollingStats.timeInMilliseconds 线程池统计指标的时间，默 认10000

hystrix.threadpool.default.metrics.rollingStats.numBuckets 将rolling window划分为n个 buckets，默认10；

二、OpenFeign 支持 Hystrix

OpenFeign 默认是支持hystrix的， 但是在Spring Cloud Dalston 版本之后就默认关闭（业务需求不一定要使用）

1、要使用首先得开启，在application.properties文件加上如下配置：

feign.hystrix.enabled=true

 将超时设置全都注释掉

#ribbon.ReadTimeout=6000
#ribbon.ConnectTimeout=3000

#hystrix.command.default.execution.timeout.enabled=true
#hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds=5000

#feign支持hystrix可用
feign.hystrix.enabled=true

2、在 springcloud-2-service-common 项目中添加注解@FeignClient  

@Component
@FeignClient(value = "springcloud-6-service-eureka-hystrix-provider",
        fallback = HystrixProviderGoodsRemoteClientFallBack.class
        /*fallbackFactory = HystrixProviderGoodsRemoteClientFallBackFactory.class*/)
public interface HystrixProviderGoodsRemoteClient 

    /**
     * 声明一个feign的接口，它的实现是服务提供者的controller实现
     */
    @GetMapping(value = "/eureka/hystrix/service/goodList")
    public ResultObject goods();

在feign客户端的注解上 有个属性叫fallback 然后指向一个类

如果需要拿到具体的服务错误信息，客户端指定一个fallbackFactory 指向一个类

HystrixProviderGoodsRemoteClientFallBack

@Component
public class HystrixProviderGoodsRemoteClientFallBack implements HystrixProviderGoodsRemoteClient
    @Override
    public ResultObject goods() 
        System.out.println("HystrixProviderGoodsRemoteClientFallBack ---- openfeign服务调用降级goods()方法");
        return new ResultObject(1,"HystrixProviderGoodsRemoteClientFallBack ---- openfeign服务调用降级goods()方法");
    

HystrixProviderGoodsRemoteClientFallBackFactory 类

@Component
public class HystrixProviderGoodsRemoteClientFallBackFactory implements FallbackFactory<HystrixProviderGoodsRemoteClient> 
    @Override
    public HystrixProviderGoodsRemoteClient create(Throwable throwable) 
        return new HystrixProviderGoodsRemoteClient() 
            @Override
            public ResultObject goods() 
                String message = throwable.getMessage();
                System.out.println("HystrixProviderGoodsRemoteClientFallBackFactory ---- openfeign远程调用异常：" + message);
                return new ResultObject(1,"HystrixProviderGoodsRemoteClientFallBackFactory ---- openfeign远程调用异常：" + message);
            
        ;
    

3、编写controller 测试

@RestController
public class GoodsController 

    //OpenFeign 整合 Hystrix
    @GetMapping(value = "/springcloud/eureka/openfeignhystrix/goodList")
    public @ResponseBody Object getGoodOpenFeignHystrixList()
        // 调用远程的一个controller, restful的调用，通过openfeign这种声明式的远程调用，providerGoodsRemoteClient就像dubbo里面的接口层一样
        return  hystrixProviderGoodsRemoteClient.goods();
    

测试结果 HystrixProviderGoodsRemoteClientFallBack

HystrixProviderGoodsRemoteClientFallBackFactory