一、hystrix参数使用方法
通过注解@HystrixCommand的commandProperties去配置,
如下就是hystrix命令超时时间命令执行超时时间,为1000ms和执行是不启用超时
1 @RestController
2 public class MovieController {
3 @Autowired
4 private RestTemplate restTemplate;
5
6 @GetMapping("/movie/{id}")
7 @HystrixCommand(commandProperties = {
8 @HystrixProperty(name = "execution.isolation.thread.timeoutInMilliseconds", value = "1000"),
9 @HystrixProperty(name = "execution.timeout.enabled", value = "false")},fallbackMethod = "findByIdFallback")
10 public User findById(@PathVariable Long id) {
11 return this.restTemplate.getForObject("http://microservice-provider-user/simple/" + id, User.class);
12 }
13
14 /**
15 * fallback方法
16 * @param id
17 * @return
18 */
19 public User findByIdFallback(Long id) {
20 User user = new User();
21 user.setId(5L);
22 return user;
23 }
24 }
二、hystrix参数如下
1 hystrix.command.default和hystrix.threadpool.default中的default为默认CommandKey
2
3 Command Properties
4 Execution相关的属性的配置:
5 hystrix.command.default.execution.isolation.strategy 隔离策略,默认是Thread, 可选Thread|Semaphore
6
7 hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds 命令执行超时时间,默认1000ms
8
9 hystrix.command.default.execution.timeout.enabled 执行是否启用超时,默认启用true
10 hystrix.command.default.execution.isolation.thread.interruptOnTimeout 发生超时是是否中断,默认true
11 hystrix.command.default.execution.isolation.semaphore.maxConcurrentRequests 最大并发请求数,默认10,该参数当使用ExecutionIsolationStrategy.SEMAPHORE策略时才有效。如果达到最大并发请求数,请求会被拒绝。理论上选择semaphore size的原则和选择thread size一致,但选用semaphore时每次执行的单元要比较小且执行速度快(ms级别),否则的话应该用thread。
12 semaphore应该占整个容器(tomcat)的线程池的一小部分。
13 Fallback相关的属性
14 这些参数可以应用于Hystrix的THREAD和SEMAPHORE策略
15
16 hystrix.command.default.fallback.isolation.semaphore.maxConcurrentRequests 如果并发数达到该设置值,请求会被拒绝和抛出异常并且fallback不会被调用。默认10
17 hystrix.command.default.fallback.enabled 当执行失败或者请求被拒绝,是否会尝试调用hystrixCommand.getFallback() 。默认true
18 Circuit Breaker相关的属性
19 hystrix.command.default.circuitBreaker.enabled 用来跟踪circuit的健康性,如果未达标则让request短路。默认true
20 hystrix.command.default.circuitBreaker.requestVolumeThreshold 一个rolling window内最小的请求数。如果设为20,那么当一个rolling window的时间内(比如说1个rolling window是10秒)收到19个请求,即使19个请求都失败,也不会触发circuit break。默认20
21 hystrix.command.default.circuitBreaker.sleepWindowInMilliseconds 触发短路的时间值,当该值设为5000时,则当触发circuit break后的5000毫秒内都会拒绝request,也就是5000毫秒后才会关闭circuit。默认5000
22 hystrix.command.default.circuitBreaker.errorThresholdPercentage错误比率阀值,如果错误率>=该值,circuit会被打开,并短路所有请求触发fallback。默认50
23 hystrix.command.default.circuitBreaker.forceOpen 强制打开熔断器,如果打开这个开关,那么拒绝所有request,默认false
24 hystrix.command.default.circuitBreaker.forceClosed 强制关闭熔断器 如果这个开关打开,circuit将一直关闭且忽略circuitBreaker.errorThresholdPercentage
25 Metrics相关参数
26 hystrix.command.default.metrics.rollingStats.timeInMilliseconds 设置统计的时间窗口值的,毫秒值,circuit break 的打开会根据1个rolling window的统计来计算。若rolling window被设为10000毫秒,则rolling window会被分成n个buckets,每个bucket包含success,failure,timeout,rejection的次数的统计信息。默认10000
27 hystrix.command.default.metrics.rollingStats.numBuckets 设置一个rolling window被划分的数量,若numBuckets=10,rolling window=10000,那么一个bucket的时间即1秒。必须符合rolling window % numberBuckets == 0。默认10
28 hystrix.command.default.metrics.rollingPercentile.enabled 执行时是否enable指标的计算和跟踪,默认true
29 hystrix.command.default.metrics.rollingPercentile.timeInMilliseconds 设置rolling percentile window的时间,默认60000
30 hystrix.command.default.metrics.rollingPercentile.numBuckets 设置rolling percentile window的numberBuckets。逻辑同上。默认6
31 hystrix.command.default.metrics.rollingPercentile.bucketSize 如果bucket size=100,window=10s,若这10s里有500次执行,只有最后100次执行会被统计到bucket里去。增加该值会增加内存开销以及排序的开销。默认100
32 hystrix.command.default.metrics.healthSnapshot.intervalInMilliseconds 记录health 快照(用来统计成功和错误绿)的间隔,默认500ms
33 Request Context 相关参数
34 hystrix.command.default.requestCache.enabled 默认true,需要重载getCacheKey(),返回null时不缓存
35 hystrix.command.default.requestLog.enabled 记录日志到HystrixRequestLog,默认true
36
37 Collapser Properties 相关参数
38 hystrix.collapser.default.maxRequestsInBatch 单次批处理的最大请求数,达到该数量触发批处理,默认Integer.MAX_VALUE
39 hystrix.collapser.default.timerDelayInMilliseconds 触发批处理的延迟,也可以为创建批处理的时间+该值,默认10
40 hystrix.collapser.default.requestCache.enabled 是否对HystrixCollapser.execute() and HystrixCollapser.queue()的cache,默认true
41
42 ThreadPool 相关参数
43 线程数默认值10适用于大部分情况(有时可以设置得更小),如果需要设置得更大,那有个基本得公式可以follow:
44 requests per second at peak when healthy × 99th percentile latency in seconds + some breathing room
45 每秒最大支撑的请求数 (99%平均响应时间 + 缓存值)
46 比如:每秒能处理1000个请求,99%的请求响应时间是60ms,那么公式是:
47 (0.060+0.012)
48
49 基本得原则时保持线程池尽可能小,他主要是为了释放压力,防止资源被阻塞。
50 当一切都是正常的时候,线程池一般仅会有1到2个线程激活来提供服务
51
52 hystrix.threadpool.default.coreSize 并发执行的最大线程数,默认10
53 hystrix.threadpool.default.maxQueueSize BlockingQueue的最大队列数,当设为-1,会使用SynchronousQueue,值为正时使用LinkedBlcokingQueue。该设置只会在初始化时有效,之后不能修改threadpool的queue size,除非reinitialising thread executor。默认-1。
54 hystrix.threadpool.default.queueSizeRejectionThreshold 即使maxQueueSize没有达到,达到queueSizeRejectionThreshold该值后,请求也会被拒绝。因为maxQueueSize不能被动态修改,这个参数将允许我们动态设置该值。if maxQueueSize == -1,该字段将不起作用
55 hystrix.threadpool.default.keepAliveTimeMinutes 如果corePoolSize和maxPoolSize设成一样(默认实现)该设置无效。如果通过plugin(https://github.com/Netflix/Hystrix/wiki/Plugins)使用自定义实现,该设置才有用,默认1.
56 hystrix.threadpool.default.metrics.rollingStats.timeInMilliseconds 线程池统计指标的时间,默认10000
57 hystrix.threadpool.default.metrics.rollingStats.numBuckets 将rolling window划分为n个buckets,默认10