Ocelot Api网关教程（9）- QoS

本文介绍Ocelot中的QoS(Quality of Service)，其使用了Polly对超时等请求下游失败等情况进行熔断。

1、添加Nuget包

添加 Ocelot.Provider.Polly 到OcelotGetway项目中

2、修改 Startup.ConfigureServices 如下来添加Polly：

services
    .AddOcelot(new ConfigurationBuilder()
        .AddJsonFile("configuration.json")
        .Build())
    .AddConsul()
    .AddPolly()
    .AddCacheManager(x => x.WithDictionaryHandle())
    .AddAdministration("/administration", "secret");

3、在WebApiA中添加一个SlowController，并添加如下代码：

using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;

namespace WebApiA.Controllers
{
public class SlowController : Controller
    {
        [Produces("application/json")]
        [Route("api/[controller]/[action]")]
public async Task<string> GetName()
        {
            await Task.Delay(6000);
return "Jonathan";
        }
    }
}

其中 GetName 延时6秒返回。

4、在configuration.json的 ReRoutes 节点添加一个新的路由来访问刚才添加的api方法

{
"DownstreamPathTemplate": "/api/Slow/GetName",
"DownstreamScheme": "http",
"DownstreamHostAndPorts": [
        {
"Host": "localhost",
"Port": 5001
        }
      ],
"UpstreamPathTemplate": "/GetName",
"UpstreamHttpMethod": [ "Get" ],
"QoSOptions": {
"ExceptionsAllowedBeforeBreaking":3,
"DurationOfBreak":60000,
"TimeoutValue": 1000
      }
}

其中通过 QoSOptions 对该路由添加QoS，对其中的3个属性解释如下：

• ExceptionsAllowedBeforeBreaking：发生几次请求异常（比如超时）后进行熔断，该值必须大于0

• DurationOfBreak：熔断时间（单位：毫秒）

• TimeoutValue：下游请求超时时间（单位：毫秒，默认90秒）
  用一句话描述上述配置：对http://localhost:5001/api/Slow/GetName请求超过1s将会超时，发生三次超时后保持60s熔断。
  运行WebApiA与OcelotGetway项目，然后请求http://localhost:5000/GetName多次：
  
  可以看到在前3次请求，Time在1000ms之后返回503，在第四次以后发生熔断，请求后立即（Time在100ms左右）返回503。
  官方文档中说可以只配置 TimeoutValue 而不配置其它两个来达到修改超时时间的功能，如下：

"QoSOptions": {
"TimeoutValue":5000
}

该配置存在bug，因为如上配置 ExceptionsAllowedBeforeBreaking 将会为0，将会触发Polly配置异常，我已经向Ocelot提交了一个Pull Request来修复该问题，并且已经被合并到主分支中，预计在下一个版本中该问题将不会存在。
如果你现在想修改超时时间，但是又不想使用熔断，可以配置如下：

"QoSOptions": {
"ExceptionsAllowedBeforeBreaking":10000,
"DurationOfBreak": 1,
"TimeoutValue": 1000
}

在发生很多次异常才会进行熔断，并且立即从熔断中恢复。

相关文章：

• .Netcore 2.0 Ocelot Api网关教程（番外篇）- Ocelot v13.x升级

• .Netcore 2.0 Ocelot Api网关教程（6）- 配置管理

• .Netcore 2.0 Ocelot Api网关教程（7）- 限流

• .Netcore 2.0 Ocelot Api网关教程（8）- 缓存
  

• 【.NET Core项目实战-统一认证平台】第十六章 网关篇-Ocelot集成RPC服务

• ocelot 自定义认证和授权

• eShopOnContainers 知多少[9]：Ocelot gateways

• 使用Ocelot、IdentityServer4、Spring Cloud Eureka搭建微服务网关：（一）
  

原文地址：https://www.jianshu.com/p/c7f5f9515962

.NET社区新闻，深度好文，欢迎访问公众号文章汇总 http://www.csharpkit.com