apisix/FAQ_CN.md

4.8 KiB
Raw Blame History

常见问题

为什么要做 API 网关?不是已经有其他的开源网关了吗?

微服务领域对 API 网关有新的需求:更高的灵活性、更高的性能要求,以及云原生的贴合。

APISIX 和其他的 API 网关有什么不同之处?

APISIX 基于 etcd 来完成配置的保存和同步,而不是 postgres 或者 MySQL 这类关系型数据库。 这样不仅去掉了轮询,让代码更加的简洁,配置同步也更加实时。同时系统也不会存在单点,可用性更高。

另外APISIX 具备动态路由和插件热加载,特别适合微服务体系下的 API 管理。

APISIX 的性能怎么样?

APISIX 设计和开发的目标之一,就是业界最高的性能。具体测试数据见这里:benchmark

APISIX 是当前性能最好的 API 网关,单核 QPS 达到 2.3 万,平均延时仅有 0.6 毫秒。

APISIX 是否有控制台界面?

是的,在 0.6 版本中我们内置了 dashboard你可以通过 web 界面来操作 APISIX 了。

我可以自己写插件吗?

当然可以APISIX 提供了灵活的自定义插件,方便开发者和企业编写自己的逻辑。

如何开发插件

我们为什么选择 etcd 作为配置中心?

对于配置中心配置存储只是最基本功能APISIX 还需要下面几个特性:

  1. 集群支持
  2. 事务
  3. 历史版本管理
  4. 变化通知
  5. 高性能

APISIX 需要一个配置中心上面提到的很多功能是传统关系型数据库和KV数据库是无法提供的。与 etcd 同类软件还有 Consul、ZooKeeper等更详细比较可以参考这里etcd why,在将来也许会支持其他配置存储方案。

为什么在用 Luarocks 安装 APISIX 依赖时会遇到超时,很慢或者不成功的情况?

遇到 luarocks 慢的问题,有以下两种可能:

  1. luarocks 安装所使用的服务器不能访问
  2. 你所在的网络到 github 服务器之间有地方对 git 协议进行封锁

针对第一个问题,你可以使用 https_proxy 或者使用 --server 选项来指定一个你可以访问或者访问更快的 luarocks 服务。 运行 luarocks config rocks_servers 命令(这个命令在 luarocks 3.0 版本后开始支持) 可以查看有哪些可用服务。

如果使用代理仍然解决不了这个问题,那可以在安装的过程中添加 --verbose 选项来查看具体是慢在什么地方。排除前面的 第一种情况,只可能是第二种,git 协议被封。这个时候可以执行 git config --global url."https://".insteadOf git:// 命令使用 https 协议替代。

如何通过APISIX支持A/B测试

比如,根据入参arg_id分组:

  1. A组arg_id <= 1000
  2. B组arg_id > 1000

可以这么做:

curl -i http://127.0.0.1:9080/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
    "uri": "/index.html",
    "vars": [
        ["arg_id", "<=", "1000"]
    ],
    "plugins": {
        "redirect": {
            "uri": "/test?group_id=1"
        }
    }
}'

curl -i http://127.0.0.1:9080/apisix/admin/routes/2 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
{
    "uri": "/index.html",
    "vars": [
        ["arg_id", ">", "1000"]
    ],
    "plugins": {
        "redirect": {
            "uri": "/test?group_id=2"
        }
    }
}'

更多的 lua-resty-radixtree 匹配操作,可查看操作列表: https://github.com/iresty/lua-resty-radixtree#operator-list

如何修改日志等级

默认的APISIX日志等级为warn,如果需要查看core.log.info的打印结果需要将日志等级调整为info

具体步骤:

1、修改conf/config.yaml中的nginx log配置参数error_log_level: "warn"error_log_level: "info"

2、重启APISIX

之后便可以在logs/error.log中查看到info的日志了。