## 故障注入 故障注入過濾器可用于測試微服務對不同形式故障的恢復能力。該過濾器可用于注入延遲和中止請求，并帶有用戶指定的錯誤代碼，從而能夠處理不同的故障情況，如服務故障，服務過載，高網絡延遲，網絡分區等。故障注入可限制在基于請求的（目的地）上游集群，以及特定的一組預定義的請求報頭組。 故障注入的范圍僅限于通過網絡進行通信的應用程序，以及可觀察到的范圍。無法模擬本地主機上的CPU和磁盤故障。 目前，故障注入過濾器有以下限制： - 中止請求的錯誤代碼僅限于HTTP狀態碼 - 延遲被限制在一定的時間內 未來的版本將包括支持限制故障到特定的路由，注入gRPC和HTTP/2特定的錯誤代碼和基于分布的持續時延。 ### 配置 **注意：故障注入過濾器必須在任何其他過濾器（包括路由器過濾器）之前插入。** - [v1 API參考](../../v1APIreference/HTTPfilters/FaultInjection.md) - [v2 API參考](../../v2APIreference/Filters/HTTPfilters/FaultInjection.md) ### 運行時設置 HTTP故障注入過濾器支持以下全局運行時設置： - **fault.http.abort.abort_percent**<br /> 如果頭部匹配，將被中止請求的百分比。在配置中默認使用`abort_percent`值。如果配置不包含`abort`項，則`abort_percent`默認為0。 - **fault.http.abort.http_status**<br /> 將被用作請求的HTTP狀態碼，如果頭部匹配，則請求將被中止。默認為配置中指定的`http_status `。如果配置不包含`abort`項，則`http_status`默認為0。 - **fault.http.delay.fixed_delay_percent**<br /> 如果頭部匹配，請求將被延遲的百分比。默認為配置中指定的`delay_percent`，否則為0。 - **fault.http.delay.fixed_duration_ms**<br /> 延遲時間以毫秒為單位。如果未指定，則將使用配置中指定的`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 | 指定下游群集的中止請求總數 | ## 返回 - [上一級](../HTTPfilters.md) - [首頁目錄](../../README.md)