# 故障注入

## 故障注入

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

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

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

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

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

### 配置

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

* [v1 API参考](/envoy/v1apireference/httpfilters/faultinjection.md)
* [v2 API参考](/envoy/v2apireference/filters/httpfilters/faultinjection.md)

### 运行时设置

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连接管理器。

| 名称                                     | 类型      | 描述            |
| -------------------------------------- | ------- | ------------- |
| `delays_injected`                      | Counter | 延迟请求总数        |
| `aborts_injected`                      | Counter | 已中止的请求总数      |
| `<downstream-cluster>.delays_injected` | Counter | 指定下游群集的延迟请求总数 |
| `<downstream-cluster>.aborts_injected` | Counter | 指定下游群集的中止请求总数 |

## 返回

* [上一级](/envoy/configurationreference/httpfilters.md)
* [首页目录](/envoy/master.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://lixiangyun.gitbook.io/envoy/configurationreference/httpfilters/faultinjection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.