高可用Hystrix
Hystrix名字由来
hystrix对应的中文名字是“豪猪”,豪猪周身长满了刺,能保护自己不受天敌的伤害,代表了一种防御机制,这与hystrix本身的功能不谋而合,因此Netflix团队将该框架命名为Hystrix,并使用了对应的卡通形象做作为logo。
What Is Hystrix
在一个分布式系统里,许多依赖不可避免的会调用失败,比如超时、异常等,如何能够保证在一个依赖出问题的情况下,不会导致整体服务失败,这个就是Hystrix需要做的事情。Hystrix提供了熔断、隔离、Fallback、cache、监控等功能,能够在一个、或多个依赖同时出现问题时保证系统依然可用。
maven配置pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<parent>
<artifactId>youfanshop</artifactId>
<groupId>com.youfan</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>hystrixTest</artifactId>
<dependencies>
<dependency>
<groupId>com.netflix.hystrix</groupId>
<artifactId>hystrix-core</artifactId>
<version>1.5.12</version>
</dependency>
</dependencies>
<!-- 中央库:引入hystrix等-->
<repository>
<id>nexus</id>
<name>local private nexus</name>
<url>http://search.maven.org</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</project>
基本使用1
import java.util.concurrent.Future;
import java.util.concurrent.TimeUnit;
import com.netflix.hystrix.HystrixCommand;
import com.netflix.hystrix.HystrixCommandGroupKey;
/**
* 入门
*/
public class CommandHelloWorld extends HystrixCommand<String> {
private final String name;
protected CommandHelloWorld(String name) {
//最少配置:指定命令组名
super(HystrixCommandGroupKey.Factory.asKey("ExampleGroup"));
this.name = name;
}
@Override
protected String run() throws Exception {
//a real example would do work like a network call here
//依赖逻辑封装在run()方法中
return "Hello " + name + "! thread: " + Thread.currentThread().getName();
}
public static void main(String[] args) throws Exception{
/**
* 每个Command对象只能调用一次,不可以重复调用
* 重复调用对应的异常信息:This instance can only be executed once.
* Please instantiate a new instance
*/
CommandHelloWorld commandHelloWorld = new CommandHelloWorld("Synchronous-hystrix");
//使用execute()同步调用代码,效果等同于:commandHelloWorld.queue().get();
String s = commandHelloWorld.execute();
System.out.println(" 同步 ====== " + s);
//异步调用,可以自由控制获取结果的时机
commandHelloWorld = new CommandHelloWorld("Asynchronous-hystrix");
Future<String> future = commandHelloWorld.queue();
//get()操作不能超过command定义的超时时间,默认为1秒
s = future.get(100, TimeUnit.MILLISECONDS);
System.out.println(" 异步 ====== " + s);
System.out.println(" 主函数 ===== " + Thread.currentThread().getName());
/**
* 注意:
* 异步调用使用 command.queue()get(timeout, TimeUnit.MILLISECONDS);
* 同步调用使用command.execute() 等同于 command.queue().get();
*/
}
}
基本使用2-超时降级
import java.util.concurrent.TimeUnit;
import com.netflix.hystrix.HystrixCommand;
import com.netflix.hystrix.HystrixCommandGroupKey;
import com.netflix.hystrix.HystrixCommandKey;
import com.netflix.hystrix.HystrixCommandProperties;
import com.netflix.hystrix.HystrixThreadPoolKey;
public class CommandHelloWorld2 extends HystrixCommand<String>{
private final String name;
protected CommandHelloWorld2(String name) {
super(
Setter.withGroupKey(HystrixCommandGroupKey.Factory.asKey("HelloWorldGroup")) // 命令分组用于对依赖操作分组,便于统计,汇总等.
.andCommandPropertiesDefaults(HystrixCommandProperties.Setter().withExecutionTimeoutInMilliseconds(500)) // 配置依赖超时时间,500毫秒
.andCommandKey(HystrixCommandKey.Factory.asKey("commandHelloWorld2")) // HystrixCommondKey工厂定义依赖名称
.andThreadPoolKey(HystrixThreadPoolKey.Factory.asKey("HelloWorldPool")) // 使用HystrixThreadPoolKey工厂定义线程池名称
);
this.name = name;
}
@Override
protected String getFallback() {
return "execute Falled";
}
@Override
protected String run() throws Exception {
//sleep 1秒 ,调用会超时
// TimeUnit.MILLISECONDS.sleep(100);
TimeUnit.MILLISECONDS.sleep(1000);
return "Hello " + name + " thread : " + Thread.currentThread().getName();
}
public static void main(String[] args) throws Exception {
CommandHelloWorld2 commandHelloWorld2 = new CommandHelloWorld2("test-Fallback");
String s = commandHelloWorld2.execute();
System.out.println(" 同步 ====== " + s);
/**
* 注意:
* 1.除了HystrixBadRequestException异常之外,所有从run()方法抛出的异常都算作失败,并触发降级getFallback()和断路器逻辑。
2.HystrixBadRequestException用在非法参数或非系统故障异常等不应触发回退逻辑的场景。
3.每个CommandKey代表一个依赖抽象,相同的依赖要使用相同的CommandKey名称。依赖隔离的根本就是对相同CommandKey的依赖做隔离.
4.CommandGroup是每个命令最少配置的必选参数,在不指定ThreadPoolKey的情况下,字面值用于对不同依赖的线程池/信号区分
5.当对同一业务依赖做隔离时使用CommandGroup做区分,但是对同一依赖的不同远程调用如(一个是redis 一个是http),
可以使用HystrixThreadPoolKey做隔离区分.最然在业务上都是相同的组,但是需要在资源上做隔离时,可以使用HystrixThreadPoolKey区分.
6.以下四种情况将触发getFallback调用:
1.)run()方法抛出非HystrixBadRequestException异常。
2.)run()方法调用超时;
3.)熔断器开启拦截调用;
4.)线程池/队列/信号量是是否跑满实现getFallback()后,
执行命令时遇到以上4中情况将被fallback接管,不会抛出异常或其他。
*/
}
}
输出:
同步 ====== execute Falled
说明:
1)上面的例子,执行超时,出发降级getFallback();
2)设置超时时间为500毫秒,上面休眠1000毫秒,所以触发降级操作;
基本例子3-熔断测试
import java.util.concurrent.TimeUnit;
import com.netflix.hystrix.HystrixCommand;
import com.netflix.hystrix.HystrixCommandGroupKey;
import com.netflix.hystrix.HystrixCommandKey;
import com.netflix.hystrix.HystrixCommandProperties;
import com.netflix.hystrix.HystrixThreadPoolKey;
import com.netflix.hystrix.HystrixThreadPoolProperties;
/**
* 测试4-熔断测试
*
*/
public class CommandHelloWorld5 extends HystrixCommand<String>{
private Integer id;
public CommandHelloWorld5(Integer id) {
super(setter());
this.id = id;
}
private static Setter setter() {
return ApiSetter.setter("getNum");
}
@Override
protected String run() throws Exception {
System.out.print("id:" + id);
if (id % 2 == 0 && id <= 10) { //让小于等于10的偶数返回
return "running run():" + id;
} else { //让奇数或大于10的数进入fallback
TimeUnit.MILLISECONDS.sleep(200);
return " XXX ";
}
}
@Override
protected String getFallback() {
return " ====== CircuitBreaker fallback" + id + " ,是否进入熔断:" + super.isCircuitBreakerOpen();
}
public static void main(String[] args) throws Exception {
for(int i = 0; i < 30; i++) {
System.out.println(new CommandHelloWorld5(i).execute());
// /*Future<String> future = new CommandHelloWorld5(i).queue();
// System.out.println(future.get());*/
}
}
private static class ApiSetter {
/**
*
* @param commandKeyName 服务标识名称
* @param threadPoolKeyName 线程程名称
* @return
*/
public static Setter setter(String commandKeyName,String threadPoolKeyName) {
return setter("ApiGroup",commandKeyName,threadPoolKeyName);
}
/**
* @param commandKeyName 服务标识名称
* @return
*/
public static Setter setter(String commandKeyName) {
return setter(commandKeyName,"Api-Pool");
}
/**
* @description 相关参数设置
* @param groupKeyName 服务分组名
* @param commandKeyName 服务标识名称
* @param threadPoolKeyName 线程池名称
* @return
*/
public static Setter setter(String groupKeyName,String commandKeyName,String threadPoolKeyName) {
HystrixCommandGroupKey groupKey = HystrixCommandGroupKey.Factory.asKey(groupKeyName); // 服务分组
HystrixCommandKey commandKey = HystrixCommandKey.Factory.asKey(commandKeyName); // 服务标识
HystrixThreadPoolKey threadPoolKey = HystrixThreadPoolKey.Factory.asKey(threadPoolKeyName); // 线程池名称
HystrixThreadPoolProperties.Setter threadPoolProperties = HystrixThreadPoolProperties.Setter() // 线程配置
.withCoreSize(25) // 设置核心线程池的大小,默认为10
.withKeepAliveTimeMinutes(5) // 设置存活时间,单位分钟。如果coreSize小于maximumSize,那么该属性控制一个线程从实用完成到被释放的时间。默认为1
.withMaxQueueSize(Integer.MAX_VALUE) // 设置BlockingQueue最大的队列值,默认值为-1
//设置队列拒绝的阈值——一个为设置的拒绝访问的最大队列值,即使maxQueueSize还没有达到。
//当将一个线程放入队列等待执行时,HystrixCommand使用该属性
//注意:如果maxQueueSize设置为-1,该属性不可用 ,默认为5
.withQueueSizeRejectionThreshold(10000);
//命令属性的配置
HystrixCommandProperties.Setter commandProperties = HystrixCommandProperties.Setter()
.withExecutionIsolationStrategy(HystrixCommandProperties.ExecutionIsolationStrategy.THREAD)
//设置HystrixCommand.run()的执行是否有超时限制。默认是true
.withExecutionTimeoutEnabled(true)
//使用线程隔离时,是否对命令执行超时的线程调用中断(Thread.interrupt())操作,默认是:true
//即:设置HystrixCommand.run()的执行是否在超时发生时被中断。
.withExecutionIsolationThreadInterruptOnTimeout(true)
//设置调用者等待命令执行的超时限制,超过此时间,HystrixCommand被标记为TIMEOUT,并执行回退逻辑。默认是1000ms
//注意:超时会作用在HystrixCommand.queue(),即使调用者没有调用get()去获得Future对象。
.withExecutionTimeoutInMilliseconds(100)
//使用线程隔离时,调用超时时间,默认:1秒 ,该方法已经不建议使用!
// .withExecutionIsolationThreadTimeoutInMilliseconds(3000)
//失败率达到20%熔断器启动,默认值是50
.withCircuitBreakerErrorThresholdPercentage(20)
// 置为true时,所有请求都将被拒绝,直接到fallback
//.withCircuitBreakerForceOpen(true)
//10秒内请求超过5个的话才会启动熔断器,
//熔断器在设置在一个滚动窗口中,打开断路器的最少请求数。
//默认20。也就是10秒钟内至少请求20次,熔断器才发挥起作用 ,
//比如:如果值是20,在一个窗口内(比如10s),收到19个请求,即使这19个请求都失败了,熔断器也不会打开
//.withCircuitBreakerRequestVolumeThreshold(5)
//是否启用熔断器,默认true. 启动
.withCircuitBreakerEnabled(true)
//设置HystrixCommand.getCacheKey()是否启用,
//由HystrixRequestCache通过请求缓存提供去重复数据功能[默认为true]
.withRequestCacheEnabled(false);
//返回
return HystrixCommand.Setter
.withGroupKey(groupKey) // 服务分组
.andCommandKey(commandKey) // 服务标识
.andThreadPoolKey(threadPoolKey) // 线程池名称
.andThreadPoolPropertiesDefaults(threadPoolProperties) // 线程配置
.andCommandPropertiesDefaults(commandProperties); // 命令属性的配置
}
/**
* ☆参数说明:
1.HystrixCommandGroupKey:服务分组,以上pydyn分组就包括多个服务,必填选项
2.HystrixCommandKey:服务的名称,唯一标识,如果不配置,则默认是类名
3.HystrixThreadPoolKey:线程池的名称,相同线程池名称的线程池是同一个,如果不配置,默认为分组名
4.HystrixThreadPoolProperties:线程池的配置,
coreSize配置核心线程池的大小,
maxQueueSize线程池队列的最大大小,
queueSizeRejectionThreshold,限制当前队列的大小,
实际队列大小由这个参数决定,即到达队列里面条数到达10000,则都会被拒绝。
5.HystrixCommandProperties:配置命令的一些参数,
如executionIsolationStrategy,配置执行隔离策略,默认是使用线程隔离,THREAD即为线程池隔离,
ExecutionIsolationThreadInterruptOnTimeout 使用线程隔离时,是否对命令执行超时的线程调用中断操作.默认:true
和ExecutionTimeoutInMilliseconds配置了启用超时和最大执行时间,这里为3s,
circuitBreakerErrorThresholdPercentage失败率配置,默认为50%,这里配置的为25%,即失败率到达25%触发熔断
*/
}
}
输出:
"C:\Program Files\Java\jdk1.8.0_181\bin\java.exe" "-javaagent:F:\Program Files\JetBrains\IDEA 2018.3.1\IntelliJ IDEA 2018.3.1\lib\idea_rt.jar=63503:F:\Program Files\JetBrains\IDEA 2018.3.1\IntelliJ IDEA 2018.3.1\bin" -Dfile.encoding=UTF-8 -classpath "C:\Program Files\Java\jdk1.8.0_181\jre\lib\charsets.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\deploy.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\access-bridge-64.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\cldrdata.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\dnsns.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\jaccess.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\jfxrt.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\localedata.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\nashorn.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\sunec.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\sunjce_provider.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\sunmscapi.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\sunpkcs11.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\ext\zipfs.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\javaws.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\jce.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\jfr.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\jfxswt.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\jsse.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\management-agent.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\plugin.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\resources.jar;C:\Program Files\Java\jdk1.8.0_181\jre\lib\rt.jar;D:\Development\longguoxueyuan-weifuwu2\youfanshop\hystrixTest\target\classes;D:\Java\MavenlRepository\repo\com\netflix\hystrix\hystrix-core\1.5.12\hystrix-core-1.5.12.jar;D:\Java\MavenlRepository\repo\org\slf4j\slf4j-api\1.7.0\slf4j-api-1.7.0.jar;D:\Java\MavenlRepository\repo\com\netflix\archaius\archaius-core\0.4.1\archaius-core-0.4.1.jar;D:\Java\MavenlRepository\repo\commons-configuration\commons-configuration\1.8\commons-configuration-1.8.jar;D:\Java\MavenlRepository\repo\commons-lang\commons-lang\2.6\commons-lang-2.6.jar;D:\Java\MavenlRepository\repo\commons-logging\commons-logging\1.1.1\commons-logging-1.1.1.jar;D:\Java\MavenlRepository\repo\io\reactivex\rxjava\1.2.0\rxjava-1.2.0.jar;D:\Java\MavenlRepository\repo\org\hdrhistogram\HdrHistogram\2.1.9\HdrHistogram-2.1.9.jar" CommandHelloWorld5
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
SLF4J: Defaulting to no-operation (NOP) logger implementation
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.
id:0running run():0
id:1 ====== CircuitBreaker fallback1 ,是否进入熔断:false
id:2running run():2
id:3 ====== CircuitBreaker fallback3 ,是否进入熔断:false
id:4running run():4
id:5 ====== CircuitBreaker fallback5 ,是否进入熔断:false
id:6running run():6
id:7 ====== CircuitBreaker fallback7 ,是否进入熔断:false
id:8running run():8
id:9 ====== CircuitBreaker fallback9 ,是否进入熔断:false
id:10running run():10
id:11 ====== CircuitBreaker fallback11 ,是否进入熔断:false
id:12 ====== CircuitBreaker fallback12 ,是否进入熔断:false
id:13 ====== CircuitBreaker fallback13 ,是否进入熔断:false
id:14 ====== CircuitBreaker fallback14 ,是否进入熔断:false
id:15 ====== CircuitBreaker fallback15 ,是否进入熔断:false
id:16 ====== CircuitBreaker fallback16 ,是否进入熔断:false
id:17 ====== CircuitBreaker fallback17 ,是否进入熔断:false
id:18 ====== CircuitBreaker fallback18 ,是否进入熔断:false
id:19 ====== CircuitBreaker fallback19 ,是否进入熔断:false
id:20 ====== CircuitBreaker fallback20 ,是否进入熔断:false
id:21 ====== CircuitBreaker fallback21 ,是否进入熔断:false
id:22 ====== CircuitBreaker fallback22 ,是否进入熔断:false
id:23 ====== CircuitBreaker fallback23 ,是否进入熔断:false
id:24 ====== CircuitBreaker fallback24 ,是否进入熔断:true
====== CircuitBreaker fallback25 ,是否进入熔断:true
====== CircuitBreaker fallback26 ,是否进入熔断:true
====== CircuitBreaker fallback27 ,是否进入熔断:true
====== CircuitBreaker fallback28 ,是否进入熔断:true
====== CircuitBreaker fallback29 ,是否进入熔断:true
Process finished with exit code 0
==============================
QQ群:143522604
群里有相关资源
欢迎和大家一起学习、交流、提升!
==============================