故障注入

故障注入过滤器可用于测试微服务对不同形式故障的恢复能力。该过滤器可用于注入延迟和中止请求，并带有用户指定的错误代码，从而能够处理不同的故障情况，如服务故障，服务过载，高网络延迟，网络分区等。故障注入可限制在基于请求的（目的地）上游集群，以及特定的一组预定义的请求报头组。

故障注入的范围仅限于通过网络进行通信的应用程序，以及可观察到的范围。无法模拟本地主机上的CPU和磁盘故障。

目前，故障注入过滤器有以下限制：

• 中止请求的错误代码仅限于HTTP状态码
• 延迟被限制在一定的时间内

未来的版本将包括支持限制故障到特定的路由，注入gRPC和HTTP/2特定的错误代码和基于分布的持续时延。

配置

注意：故障注入过滤器必须在任何其他过滤器（包括路由器过滤器）之前插入。

• v1 API参考
• v2 API参考

运行时设置

HTTP故障注入过滤器支持以下全局运行时设置：

• fault.http.abort.abort_percent
  
  如果头部匹配，将被中止请求的百分比。在配置中默认使用abort_percent值。如果配置不包含abort项，则abort_percent默认为0。

• fault.http.abort.http_status
  
  将被用作请求的HTTP状态码，如果头部匹配，则请求将被中止。默认为配置中指定的http_status。如果配置不包含abort项，则http_status默认为0。

• fault.http.delay.fixed_delay_percent
  
  如果头部匹配，请求将被延迟的百分比。默认为配置中指定的delay_percent，否则为0。

• fault.http.delay.fixed_duration_ms
  
  延迟时间以毫秒为单位。如果未指定，则将使用配置中指定的fixed_duration_ms。如果在运行时和配置中缺少这个字段，则不会注入延迟。

请注意，在特定下游群集中，如果存在以下运行时配置值，则故障过滤器默认值会被覆盖。以下是下游指定的运行时配置值：

• fault.http.<downstream-cluster>.abort.abort_percent
• fault.http.<downstream-cluster>.abort.http_status
• fault.http.<downstream-cluster>.delay.fixed_delay_percent
• fault.http.<downstream-cluster>.delay.fixed_duration_ms

下游集群名称取自HTTP x-envoy-downstream-service-cluster头部。如果在运行系统中找不到，则默认使用全局运行时设置为缺省配置。

统计

故障过滤器输出统计信息命名空间为http.<stat_prefix>.fault.。stat_prefix来自所拥有的HTTP连接管理器。

返回

• 上一级
• 首页目录