Tip: 此篇已加入.NET Core微服务基础系列文章索引
_=>_ Steeltoe目录快速导航：
- 基于Steeltoe使用Spring Cloud Eureka
- 基于Steeltoe使用Spring Cloud Zuul
- 基于Steeltoe使用Spring Cloud Hystrix
一、关于Spring Cloud Hystrix
![]()
在微服务架构中，我们将系统拆分为很多个服务，各个服务之间通过注册与订阅的方式相互依赖，由于各个服务都是在各自的进程中运行，就有可能由于网络原因或者服务自身的问题导致调用故障或延迟，随着服务的积压，可能会导致服务崩溃。为了解决这一系列的问题，断路器等一系列服务保护机制出现了。
断路器本身是一种开关保护机制，用于在电路上保护线路过载，当线路中有电器发生短路时，断路器能够及时切断故障电路，防止发生过载、发热甚至起火等严重后果。
针对上述问题，Spring Cloud Hystrix 实现了断路器、线路隔离等一系列服务保护功能。它也是基于 Netflix 的开源框架 Hystrix 实现的，该框架的目标在于通过控制那些访问远程系统、服务和第三方库的节点，从而对延迟和故障提供更强大的容错能力。Hystrix 具备服务降级、服务熔断、线程和信号隔离、请求缓存、请求合并以及服务监控等强大功能。
![]()
二、快速集成Hystrix实现熔断保护
2.1 准备工作
这里仍然基于第一篇的示例进行修改，各个项目的角色如下表所示：
| 微服务项目名称 |
项目微服务中的角色 |
| eureka-service |
服务发现&注册（Spring Boot） |
| zuul-service |
API网关 （Spring Boot） |
| agent-service |
服务提供者 （ASP.NET Core） |
| client-service |
服务提供者 （ASP.NET Core） |
| premium-service |
服务提供者&服务消费者 （ASP.NET Core） |
所有相关服务注册到Eureka之后的服务列表：
![]()
这里仍然假设premium-service要调用client-service的接口，我们想要模拟的效果就是针对client-service的调用进行熔断保护。
要使用Hystrix，需要对服务添加依赖包：
PM> Install-Package Steeltoe.CircuitBreaker.HystrixCore
2.2 为PremiumService添加Hystrix相关类与配置
（1）增加一个HystrixCommand : ClientServiceCommand
public class ClientServiceCommand : HystrixCommand<string>
{
IClientService _clientService;
ILogger<ClientServiceCommand> _logger;
private int _clientId;
public ClientServiceCommand(IHystrixCommandOptions options, IClientService clientService,
ILogger<ClientServiceCommand> logger) : base(options)
{
_clientService = clientService;
_logger = logger;
IsFallbackUserDefined = true;
}
public async Task<string> GetClientName(int clientId)
{
_clientId = clientId;
return await ExecuteAsync();
}
protected override async Task<string> RunAsync()
{
var result = await _clientService.GetClientName(_clientId);
_logger.LogInformation("Run: {0}", result);
return result;
}
protected override async Task<string> RunFallbackAsync()
{
_logger.LogInformation("RunFallback");
return await Task.FromResult<string>("Sorry, the service is unavaliable now. Please try again later.");
}
}
根据Steeltoe官方文档说明，每个Command都必须继承HystrixCommand或HystrixCommand，然后实现这个RunAsync方法与RunFallbackAsync方法。可以看出，RunAsync方法是实现原有业务逻辑，而RunFallbackAsync方法则是受保护降级后的方法，这里简单地输出了一句提示信息“Service is unavaiable. Please try again later.”。
另外，Steeltoe提供了一个快速的HystrixCommand的写法，见下面这个示例代码，全部在构造函数里面搞定：
public class HelloWorldCommand : HystrixCommand<string>
{
public HelloWorldCommand(string name)
: base(HystrixCommandGroupKeyDefault.AsKey("HelloWorldGroup"),
() => { return "Hello" + name; },
() => { return "Hello" + name + " via fallback"; })
{
}
}
但是，这里不得不吐槽一下，在Java中对HystrixCommand的封装是注解级别，工作量小的不是真的不是太多，见下例Java代码：
@RestController
public class MovieController {
......
@HystrixCommand(fallbackMethod = "findByIdFallback")
@GetMapping(value = "/user/{id}")
public User findById(@PathVariable Long id) {
return restTemplate.getForObject("http://user-service/" + id, User.class);
}
public User findByIdFallback(Long id){
User user = new User();
user.setId(-1L);
user.setUsername("Default User");
return user;
}
}
（2）改写Controller，使用ClientServiceCommand类替换原有ClientService
[Route("api/[controller]")]
[ApiController]
public class ValuesController : ControllerBase
{
private ClientServiceCommand _clientServiceCommand;
private ILogger<ValuesController> _logger;
public ValuesController(ClientServiceCommand clientServiceCommand, ILogger<ValuesController> logger)
{
_clientServiceCommand = clientServiceCommand;
_logger = logger;
}
......
// GET api/values/5
[HttpGet("{id}")]
public async Task<string> Get(int id)
{
_logger?.LogInformation($"api/values/{id}");
return await _clientServiceCommand.GetClientName(id);
}
}
这里不再直接使用ClientService实例，改为使用ClientServiceCommand实例，实际上是一个代理模式的应用。
（3）在启动类中添加Hystrix相关配置
public class Startup
{
public Startup(IConfiguration configuration)
{
Configuration = configuration;
}
public IConfiguration Configuration { get; }
// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
// Add Steeltoe Discovery Client service
services.AddDiscoveryClient(Configuration);
services.AddSingleton<IClientService, ClientService>();
// Add Steeltoe Hystrix Command
services.AddHystrixCommand<ClientServiceCommand>("ClientService", Configuration);
services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
}
// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
app.UseMvc();
// Add Steeltoe Discovery Client service
app.UseDiscoveryClient();
}
}
2.3 快速验证
（1）同时启动所有微服务，然后访问PremiumService的相关接口，正常情况下，能够正常返回调用ClientService接口的结果
![]()
（2）关闭ClientService，然后再次PremiumService的相关接口，这时会返回受保护降级后的Fallback结果
![]()
三、快速集成Hystrix Dashboard实现指标监控
_摘抄一句蟋蟀的话：_在实际应用中，我们需要对 Hystrix 断路器进行监控，比如熔断请求有多少等等，Spring Cloud 中的实现有 Turbine 进行收集，数据展示的话使用 Hystrix Dashboard。
3.1 快速构建一个Hystrix Dashboard服务
（1）创建一个Spring Boot项目：这里版本是Spring Boot 1.5.15.RELEASE，Spring Cloud Edgware.SR3
（2）pom.xml中添加相关依赖包
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-hystrix-dashboard</artifactId>
</dependency>
（3）启动类中添加EnableHystrixDashboard注解
@SpringBootApplication
@EnableHystrixDashboard
public class DashboardServiceApplication {
public static void main(String[] args) {
SpringApplication.run(DashboardServiceApplication.class, args);
}
}
（4）必要的配置（application.yml）
server:
port: 5010
spring:
application:
name: hystrix-dashboard-service
3.2 快速在ASP.NET Core中集成Hystrix Metrics
（1）安装Hystrix Dashboard相关包
PM>Install-Package Steeltoe.CircuitBreaker.Hystrix.MetricsEventsCore
（2）改写PremiumService启动类添加相关的Metrics配置
public class Startup
{
......
// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
// Add Steeltoe Discovery Client service
services.AddDiscoveryClient(Configuration);
services.AddSingleton<IClientService, ClientService>();
// Add Steeltoe Hystrix Command
services.AddHystrixCommand<ClientServiceCommand>("ClientService", Configuration);
services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
// Add Hystrix Metrics to container
services.AddHystrixMetricsStream(Configuration);
}
// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
// Add Steeltoe Discovery Client service
app.UseDiscoveryClient();
app.UseMvc();
// Start Hystrix metrics stream service
app.UseHystrixMetricsStream();
}
}
（3）启动Premium-Service，查看URL：http://localhost:8030/hystrix/hystrix.stream
![]()
上图中我们会看到不断实时刷新的 Hystrix 指标监控数据了，但显示并不友好，我咋知道这些指标是啥玩意儿啊！因此，还是让我们在仪表盘中来看看吧。
3.3 快速验证
（1）启动Hystrix Dashboard服务，输入URL：http://localhost:8030/hystrix/hystrix.stream，然后点击按钮“Monitor Stream”
![]()
（2）由于ClientServiceCommand尚未起任何作用，所以第一次得到的数据如下：
![]()
（3）多次请求ClientService，然后关闭ClientService，再多次请求，这时熔断保护已启动
（4）再次查看Hystrix Dashboard，可以看到以下数据：触发了3次熔断保护
![]()
关于Hystrix Dashboard的仪表盘数据属性说明，可以参考下面这张图（From 园友寻找风口的猪 的《Hystrix Dashboard仪表盘》）：
![]()
四、小结
本文简单介绍了一下Spring Cloud Hystrix这个熔断保护组件，并演示了如何基于Steeltoe OSS使用Hystrix实现熔断保护，并基于Hystrix Dashboard演示了如何收集和可视化地查看ASP.NET Core的熔断监控数据。对于Steeltoe OSS提供的Hystrix的组件的使用，相对于Java的Hystrix的注解封装，代码量稍微大一些。另外，关于Hystrix的一些更高级的使用，本文没有涉及，有兴趣的原有可以自行查看官方文档学习。
示例代码
Click => https://github.com/EdisonChou/Microservice.PoC.Steeltoe/tree/master/src/Chapter2-CircuitBreaker
参考资料
Steeltoe官方文档：《Steeltoe Doc》
Steeltoe官方示例：https://github.com/SteeltoeOSS/Samples
蟋蟀，《.NET Core 微服务架构 Steeltoe的使用》
周立，《Spring Cloud与Docker 微服务架构实战》
Sunday_Xiao，《服务熔断保护：Spring Cloud Hystrix》
寻找风口的猪 的《Hystrix Dashboard仪表盘》
