fault-injection
fault-injection 插件旨在通过模拟受控故障或延迟来测试应用程序的弹性。它在其他配置的插件之前执行，确保故障被一致地应用。这使其非常适合混沌工程等场景，在这些场景中，需要分析系统在故障条件下的行为。
该插件支持两个关键动作：abort，它会立即以指定的 HTTP 状态码（例如 503 Service Unavailable）终止请求，并跳过所有后续插件；以及 delay， 它在进一步处理请求之前引入指定的延迟。这些功能允许你模拟服务中断或延迟等场景，帮助你验证错误处理逻辑并提高系统可靠性。
示例
以下示例演示了如何在不同场景下配置 fault-injection 插件。
注入故障
以下示例演示了如何在路由上配置 fault-injection 插件，以拦截进一步的请求发送，并返回特定的 HTTP 代码。
创建一个使用 fault-injection 插件的路由，使用 abort 动作将任何请求响应为 404 并返回指定的响应体：
curl "http://127.0.0.1:9180/apisix/admin/routes" -X PUT \
-H "X-API-KEY: ${ADMIN_API_KEY}" \
-d '{
"id": "fault-injection-route",
"uri": "/anything",
"plugins": {
"fault-injection": {
"abort": {
"http_status": 404,
"body": "APISIX Fault Injection"
}
}
},
"upstream": {
"type": "roundrobin",
"nodes": {
"httpbin.org": 1
}
}
}'
发送请求到路由：
curl -i "http://127.0.0.1:9080/anything"
你应该收到 HTTP/1.1 404 Not Found 响应并看到以下响应体，而请求不会被 转发到上游服务：
APISIX Fault Injection
注入延迟
以下示例演示了如何在路由上配置 fault-injection 插件以注入请求延迟。
创建一个使用 fault-injection 插件的路由，使用 delay 动作将响应发送延迟 3 秒：
curl "http://127.0.0.1:9180/apisix/admin/routes" -X PUT \
-H "X-API-KEY: ${ADMIN_API_KEY}" \
-d '{
"id": "fault-injection-route",
"uri": "/anything",
"plugins": {
"fault-injection": {
"delay": {
"duration": 3
}
}
},
"upstream": {
"type": "roundrobin",
"nodes": {
"httpbin.org": 1
}
}
}'
发送请求到路由，并使用 time 命令总结请求完成所需的时间：
time curl -i "http://127.0.0.1:9080/anything"
你应该收到来自上游服务的 HTTP/1.1 200 OK 响应，并看到以下计时摘要：
0.01s user
0.01s system
0% cpu
3.685 total
有条件地注入故障
以下示例演示了如何在路由上配置 fault-injection 插件，以拦截进一步的请求发送，并返回特定的 HTTP 代码。
创建一个使用 fault-injection 插件的路由，使用 abort 动作，如下所示：
curl "http://127.0.0.1:9180/apisix/admin/routes" -X PUT \
-H "X-API-KEY: ${ADMIN_API_KEY}" \
-d '{
"id": "fault-injection-route",
"uri": "/anything",
"plugins": {
"fault-injection": {
"abort": {
// Annotate 1
"http_status": 404,
// Annotate 2
"body": "APISIX Fault Injection",
"headers": {
// Annotate 3
"X-APISIX-Remote-Addr": "$remote_addr"
},
"vars": [
[
// Annotate 4
[ "arg_name","==","john" ]
]
]
}
}
},
"upstream": {
"type": "roundrobin",
"nodes": {
"httpbin.org": 1
}
}
}'
❶ 使用 HTTP 状态码 404 响应请求。
❷ 使用 APISIX Fault Injection 作为响应体。
❸ 响应请求时添加头 X-APISIX-Remote-Addr 和请求来源的 IP。
❹ 仅当 URL 参数 name 的值为 john 时，才按上述规范响应请求。
发送带有 URL 参数 name 为 john 的请求到路由：
curl -i "http://127.0.0.1:9080/anything?name=john"
你应该收到 HTTP/1.1 404 Not Found 响应：
HTTP/1.1 404 Not Found
...
X-APISIX-Remote-Addr: 192.168.65.1
APISIX Fault Injection
发送带有 URL 参数 name 为不同值的请求到路由：
curl -i "http://127.0.0.1:9080/anything?name=jane"
你应该收到来自上游服务的 HTTP/1.1 200 OK 响应，而没有注入故障。